Auto Maticrailway Generation

This mod is still in the development stage and may cause unexpected structural damage. Please be sure to back up your world save files!

Automatic Railway Generation

Automatic Railway Generation (ARG) automatically builds usable Create railways in the Overworld.

It finds villages, chooses station sites, plans terrain-aware routes, and places real Create tracks, curves, foundations, bridges, and basic tunnels. The network can continue expanding as players explore.

This mod edits terrain and is still in development. Back up important worlds before installing or updating it.

Features

• Automatic railways between spawn, villages, and the growing network
• Terrain-aware routing with smooth Create curves and gentle slopes
• Automatic village stations, track beds, bridge pillars, and clearance
• Structure and block-entity checks before construction
• Gradual network expansion while exploring
• In-game railway map, opened with M by default

ARG builds the railway infrastructure only. Trains, signals, Create stations, and schedules must still be configured by players.

Requirements

• Create 6.0.10–6.0.x

Install ARG and Create in the mods folder. For multiplayer, install the same versions on the server and clients.

To build from source on Windows:

gradlew.bat build

The jar will be created in build/libs/.

Playing

On the first world load, ARG normally waits while it creates an initial railway near spawn. The loading screen shows its current progress. This can make the first load noticeably longer.

When exploration generation is enabled, visiting new regions can discover more villages and extend the network over time. Difficult routes may be retried later or fail if no safe path is available.

Press M to open the railway map:

• Mouse wheel: zoom
• Left-drag: pan
• Green: complete
• Yellow: planned or under construction
• Red: failed

Automatic generation currently works in the Overworld only.

Safety and Configuration

ARG checks complete routes before laying track and avoids known generated structures, unbreakable blocks, and protected block entities. However, it must clear ordinary breakable blocks and terrain inside the train corridor. Player-built blocks cannot always be distinguished from natural terrain, so always back up existing worlds.

The main configuration file is:

config/automaticrailwaygeneration-common.toml

Useful settings include:

• enableWorldRailGeneration: master switch
• blockInitialGeneration: wait for the initial railway before entering
• enableExplorationGeneration: expand while exploring
• initialPlanningRadiusChunks: initial search range
• villageStationProbability: chance for villages to receive stations

Disabling generation does not remove railways that already exist.

Administrator Commands

• /argrail status — show railway status
• /argrail scan — force another scan and planning pass
• /argrail retry — retry failed routes
• /argrail export — write details to the server log
• /argrail rebuild <radius> — rebuild nearby generated tracks

Back up the world before using rebuild.