Railway is a Minecraft train operation plugin based on Metro. Building upon the original station management, it introduces **Fixed Headway**, **Train Consists**, and **Automated Dispatching** systems, allowing players to experience realistic arrival, docking, and departure processes.<\/p>\n
### Core Features
\n– **Based on Metro**: Inherits station management, UI prompts, sound systems, and multi-language support.
\n– **Folia Compatibility**: Declared as `folia-supported: true`; validate with load testing on your target server setup.
\n– **Automated Dispatching**: Generates trains based on headway, supporting loop\/single-direction operations.
\n– **Three Control Modes**: Kinematic, Reactive, Leashed.
\n– **Virtual Dispatching**: Local mode generates trains on demand to save server performance.
\n– **Station HUD**: Real-time countdown for next train, supporting Title\/ActionBar\/Hologram.
\n– **Permission Management**: Lines and stops support owner and admin systems.<\/p>\n
### Configuration
\nThe default configuration is located in `config.yml`. Future updates will extend `lines.yml` to support per-line `service.*` fields.<\/p>\n
#### Core Configuration Items<\/p>\n
**Service Configuration (service)**
\n“`yaml
\nservice:
\n mode: local # Run mode: local (virtual timetable) | global (always-on entities)
\n default_headway_seconds: 120 # Default headway (seconds)
\n default_dwell_ticks: 100 # Default dwell time (ticks)
\n default_train_cars: 3 # Default consist length (number of cars)
\n heartbeat_interval_ticks: 1 # Service heartbeat period (ticks)
\n metrics:
\n log_interval_ticks: 0 # Service metrics log interval (0 = disabled)
\n“`<\/p>\n
**General Settings (settings)**
\n“`yaml
\nsettings:
\n default_language: en_US # Default language (en_US \/ zh_CN)
\n cart_speed: 0.4 # Default cart speed (can be overridden by line max_speed)
\n train_spacing: 1.6 # Spacing between cars in a consist (blocks)
\n safe_speed_mode: true # Automatic speed limit on curves\/slopes (prevents derailment)<\/p>\n
control:
\n default_mode: kinematic # Global default control mode
\n leash: # Leash mode configuration
\n mob_type: ALLAY # Leash holder mob type (ALLAY\/FOX\/WOLF etc.)
\n update_interval_ticks: 1 # Leash holder update interval
\n offset_y: 0.2 # Leash holder vertical offset<\/p>\n
selection:
\n tool: GOLDEN_HOE # Stop area selection tool<\/p>\n
interact:
\n type: SUBTITLE # Display type for rail ETA: ACTIONBAR, TITLE, SUBTITLE
\n stay_ticks: 60 # Display duration in ticks<\/p>\n
chunk_loading: # Global mode chunk loading strategy
\n enabled: true
\n radius: 2 # Loading radius around each car (chunks)
\n forward_preload_radius: 1 # Forward preload radius
\n only_when_moving: false # Only load when moving
\n update_interval_ticks: 10 # Refresh interval
\n“`<\/p>\n
**Travel Time Estimation (travel_time)**
\n“`yaml
\ntravel_time:
\n enabled: true # Enable Bayesian estimation
\n default_section_seconds: 20.0 # Default section travel time
\n prior_strength: 4.0 # Prior strength (virtual sample count)
\n outlier_sigma: 3.0 # Outlier filtering threshold (sigma)
\n decay_per_day: 0.95 # Daily decay factor
\n use_unboarded_samples: false # Whether to use unboarded samples
\n unboarded_weight: 0.2 # Unboarded sample weight
\n“`<\/p>\n
**Local Mode Configuration (local)**
\n“`yaml
\nlocal:
\n activation_radius: 96 # Player radius to trigger spawning (blocks)
\n spawn_lead_ticks: 120 # Target arrival lead time (ticks)
\n suppress_threshold_seconds: 10.0 # Suppression threshold if a train is arriving (seconds)
\n virtualization:
\n enabled: true # Enable virtualization
\n idle_ticks: 200 # Time to wait before recycling demand-free trains
\n lookahead_stops: 2 # Number of stops to check for demand
\n“`<\/p>\n
**Physics Engine Configuration (physics)**
\n“`yaml
\nphysics:
\n lead_kinematic: true # Lead car driven kinematically
\n lookahead_blocks: 4 # Rail geometry lookahead blocks
\n trail_seconds: 10 # Trail buffer duration (seconds)
\n smoothing_lerp: 0.15 # Smoothing interpolation factor (0=instant, 0.3=smooth)
\n snap_to_rail: true # Snap to rail center
\n strict_when_has_passenger: true # Strict alignment when carrying passengers
\n position_only_mode: false # Position-only mode (cinematic\/display use)
\n“`<\/p>\n
**Station UI Configuration (titles)**<\/p>\n
Supports `stop_continuous` (Station HUD), `arrive_stop` (Arrival), `terminal_stop` (Terminus), `departure` (Journey Info), `waiting` (Waiting for departure) scenarios. See `config.yml` for full configuration.<\/p>\n
**Sound Configuration (sounds)**<\/p>\n
Supports `departure`, `arrival`, `station_arrival`, `waiting` sound sequences. See `config.yml` for full configuration.<\/p>\n
**Scoreboard Configuration (scoreboard)**
\n“`yaml
\nscoreboard:
\n enabled: true # Enable scoreboard (Incompatible with Folia)
\n styles:
\n current_stop: “&f” # Current stop style
\n next_stop: “&a” # Next stop style
\n other_stops: “&7” # Other stops style
\n line_symbol: “\u25cf” # Line symbol
\n“`<\/p>\n
> Tip: The plugin will automatically populate missing keys in `config.yml` on startup (preserving your existing values). Language files will also automatically merge new entries. No manual config updates are needed for upgrades.
\n> Starting from this version, old `settings.consist.*` settings are deprecated and removed, consolidated into `physics.*`.<\/p>\n
`lines.yml` example (Planned extension):<\/p>\n
“`yaml
\nred:
\n name: Red Line
\n color: “&c”
\n ordered_stop_ids: [r1, r2, r3, r4]
\n terminus_name: “To R4”
\n max_speed: 0.6
\n service:
\n enabled: true
\n headway_seconds: 90
\n dwell_ticks: 100
\n train_cars: 4
\n direction_mode: bi_directional # bi_directional | circular | single_direction
\n first_departure_tick: 200
\n“`<\/p>\n
### Commands<\/p>\n
**Basic Commands**
\n– `\/rail` – Show main help menu
\n– `\/rail reload` – Reload configuration and data, rebuild line services
\n– `\/rail gui` – Open server-wide line GUI panel
\n– `\/rail line status [lineId]` – View global or specific line status
\n– `\/rail line list` – List all lines summary
\n– `\/rail stop list` – List all stops configuration status<\/p>\n
**Line Management** (`\/rail line`) **Stop Management** (`\/rail stop`) All commands support Tab completion.<\/p>\n > All command feedback and prompts are integrated into the language system and will output text according to the player’s selected language.<\/p>\n **Permissions** Lines and stops support an owner and admin system. Permissions can managed via `setowner`, `trust`, and `untrust` commands. OPs and players with `railway.admin` permission can bypass ownership checks.<\/p>\n ### Run Modes ### Control Modes All control modes support line speed limits (`max_speed`), safe speed limits on curves\/slopes, and strict passenger synchronization.<\/p>\n ### Metro Migration Guide ### Folia Support ### Physics Reference A train management system based on Metro<\/p>\n","protected":false},"featured_media":100780,"template":"","meta":{"_minecraft_slug":"metro-railway","_minecraft_project_id":"VLVOEC1E","_minecraft_author":"angushushu","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":26,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"metro-railway.zip","_minecraft_size_bytes":3016264,"_minecraft_version_count":4,"_minecraft_updated_at":"2026-05-15T22:20:19.496971Z","_minecraft_date_created":"2026-05-05T20:57:25.003776Z","_minecraft_date_modified":"2026-03-15T21:21:49.111254Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/metro-railway","_minecraft_icon_attachment_id":100780,"_minecraft_imported_at":"2026-06-05T19:03:20+00:00","_minecraft_import_hash":"7271701aaf58f73ae0669b3cbebe5ee6","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,125,89,126,127,128,129,869,92],"mod_loader":[130,131,132,133,134],"minecraft_version":[59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-100779","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-folia","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-transportation","mod_category-utility","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– `\/rail line` – Show line management help
\n– `\/rail line create
\n– `\/rail line delete
\n– `\/rail line list` – List all lines
\n– `\/rail line stops
\n– `\/rail line control
\n– `\/rail line rename
\n– `\/rail line setcolor
\n– `\/rail line addstop
\n– `\/rail line delstop
\n– `\/rail line service
\n– `\/rail line setheadway
\n– `\/rail line setdwell
\n– `\/rail line settraincars
\n– `\/rail line setterminus
\n– `\/rail line setmaxspeed
\n– `\/rail line setowner
\n– `\/rail line trust
\n– `\/rail line untrust
\n– `\/rail stop` – Show stop management help
\n– `\/rail stop create
\n– `\/rail stop delete
\n– `\/rail stop list` – List all stops
\n– `\/rail stop tp
\n– `\/rail stop rename
\n– `\/rail stop setcorners
\n– `\/rail stop setpoint [id] [yaw]` – Set stop point at current location (id optional if inside a stop, supports custom yaw)
\n– `\/rail stop allowline
\n– `\/rail stop denyline
\n– `\/rail stop addtransfer
\n– `\/rail stop deltransfer
\n– `\/rail stop settitle
\n– `\/rail stop deltitle
\n– `\/rail stop setowner
\n– `\/rail stop trust
\n– `\/rail stop untrust
\n– `railway.admin` – Use all admin commands (Default: OP)
\n– `railway.use` – Use basic plugin features (riding trains etc., Default: All players)
\n– `railway.line.create` – Allow players to create new lines (Default: false)
\n– `railway.stop.create` – Allow players to create new stops (Default: false)<\/p>\n
\n– **local** (Default): “Virtual Timetable + Proximity Spawning”. Generates train entities only near players, balancing immersion and performance. Supports virtualization recycling (automatically clears trains with no demand).
\n– **global**: Always-on entities running continuously based on headway. Supports moving window chunk loading to ensure trains run normally throughout the route.<\/p>\n
\n– **kinematic**: Lead car completely takes over movement. Followers strictly follow the trail. Stable on curves\/slopes, keeps passengers synchronized. Recommended for high-speed lines and precise dispatching.
\n– **reactive**: Spacing control based on vanilla physics. Real-time correction to maintain consist. Balances vanilla feel and synchronization. Suitable for low-speed sightseeing lines.
\n– **leashed**: Visual connection via leashed mobs. Lightweight control, compatible with TrainCarts and other plugins. Suitable for displays and compatibility scenarios.<\/p>\n
\nRailway is directly compatible with Metro data files. Migration steps:
\n1. Install Railway plugin.
\n2. Delete `Metro\/config.yml` (Recommended to use the new config generated by Railway).
\n3. Copy `Metro\/lines.yml` and `Metro\/stops.yml` to the `Railway\/` directory.
\n4. Restart server.
\n5. Use `\/rail line list` to confirm lines are loaded.<\/p>\n
\nThis plugin is declared Folia-compatible (`folia-supported: true` in `plugin.yml`). Because performance and scheduler behavior can vary by environment, run full regression and load tests before production rollout.<\/p>\n
\nTrainCarts, Metro<\/p>\n","protected":false},"excerpt":{"rendered":"