Railway Tools for Axiom

An Axiom addon for Minecraft providing advanced railway path generation tools, designed for use in large-scale building projects such as BuildTheEarth.

Overview

Railway Tools for Axiom extends Axiom's toolset with a specialized rail path creation tool. By placing a series of control points, the tool generates smooth, mathematically precise railway corridors with automatic block selection and orientation — eliminating the need for manual block-by-block placement.

This mod was developed independently by a single author and is not affiliated with the BuildTheEarth organization.

Features

Smooth Path Generation

Paths are computed using Catmull-Rom spline interpolation, producing natural curves through any number of control points. The algorithm ensures smooth tangent continuity, avoiding harsh angles between segments.

Two Distinct Rail Styles

Select between two independently developed placement modes directly from the tool panel:

Classic — Uses dead fire coral wall fans as centerline markers, mud brick walls as lateral supports (aligned or cornered according to the curve geometry), and spruce shelves or trapdoors as curve indicators. This style provides a clean, structured appearance suited to survey and planning work.

Natural — Uses lecterns as the track centerline (replacing the center block with a pale moss block on inclined segments), gravel as lateral rails, and leaf litter with directional segment amounts for curve decoration. Diagonal intersections are automatically filled with gravel and directional leaf litter.

Adaptive Block Orientation

Every block is oriented according to the local path tangent and curvature. Lateral blocks, corner connections, curve indicators and diagonal joints are all computed per segment to maintain geometric consistency throughout the path.

Terrain Following

When the ground-snapping option is enabled, the tool searches vertically from each spline point to locate the nearest solid surface, adjusting the path elevation to follow existing terrain.

Configurable Density

The spline sampling density is adjustable from 2 to 32 points per block. Higher values produce smoother curves, particularly useful on tight-radius bends.

Live Preview

A real-time preview is rendered before any blocks are placed. The preview uses an animated opacity to distinguish it clearly from existing blocks. No changes are committed until explicitly confirmed.

Usage

1. Select the BTE Rail Path tool from Axiom's tool palette
2. Right-click to place control points along the desired path
3. Adjust style, density, and ground-snapping in the tool panel
4. Press Enter to confirm and place the path, or Delete to remove the last point
5. Press Escape to clear all points and start over

Input	Action
Right-click	Place a control point
Enter	Confirm and apply the path
Delete	Remove the last control point
Escape	Reset all points

Rail Style Reference

Classic Style

Element	Block
Centerline	Dead fire coral wall fan (oriented)
Straight lateral	Mud brick wall (North-South or East-West)
Diagonal lateral	Mud brick wall (corner configuration)
Curve indicator	Spruce shelf or spruce trapdoor (fallback)

Natural Style

Element	Block
Center (flat)	Lectern (oriented) + pale moss carpet
Center (incline)	Pale moss block + oak button
Lateral rails	Gravel
Curve decoration	Leaf litter (directional, segment_amount 2-3)
Diagonal joints	Gravel + directional leaf litter

Requirements

Dependency	Version
Minecraft	1.21.10
Fabric Loader	0.16.0 or later
Fabric API	Required
Axiom	Required, not bundled

This mod is client-side only and will not initialize if Axiom is absent.

Permissions

Requires the following Axiom permission nodes:

• TOOL — Custom tool access
• BUILD_SECTION — Block placement

License

MIT — see the LICENSE file included in the release.