Railway

Railway is a Minecraft train operation plugin based on (https://github.com/CubeX-MC/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.

### Core Features - Based on Metro: Inherits station management, UI prompts, sound systems, and multi-language support. - Folia Compatibility: Declared as `folia-supported: true`; validate with load testing on your target server setup. - Automated Dispatching: Generates trains based on headway, supporting loop/single-direction operations. - Three Control Modes: Kinematic, Reactive, Leashed. - Virtual Dispatching: Local mode generates trains on demand to save server performance. - Station HUD: Real-time countdown for next train, supporting Title/ActionBar/Hologram. - Permission Management: Lines and stops support owner and admin systems.

### Configuration The default configuration is located in `config.yml`. Future updates will extend `lines.yml` to support per-line `service.*` fields.

#### Core Configuration Items

Service Configuration (service) ```yaml service: mode: local # Run mode: local (virtual timetable) | global (always-on entities) default_headway_seconds: 120 # Default headway (seconds) default_dwell_ticks: 100 # Default dwell time (ticks) default_train_cars: 3 # Default consist length (number of cars) heartbeat_interval_ticks: 1 # Service heartbeat period (ticks) metrics: log_interval_ticks: 0 # Service metrics log interval (0 = disabled) ```

General Settings (settings) ```yaml settings: default_language: en_US # Default language (en_US / zh_CN) cart_speed: 0. 4 # Default cart speed (can be overridden by line max_speed) train_spacing: 1. 6 # Spacing between cars in a consist (blocks) safe_speed_mode: true # Automatic speed limit on curves/slopes (prevents derailment) control: default_mode: kinematic # Global default control mode leash: # Leash mode configuration mob_type: ALLAY # Leash holder mob type (ALLAY/FOX/WOLF etc.) update_interval_ticks: 1 # Leash holder update interval offset_y: 0. 2 # Leash holder vertical offset selection: tool: GOLDEN_HOE # Stop area selection tool interact: type: SUBTITLE # Display type for rail ETA: ACTIONBAR, TITLE, SUBTITLE stay_ticks: 60 # Display duration in ticks chunk_loading: # Global mode chunk loading strategy enabled: true radius: 2 # Loading radius around each car (chunks) forward_preload_radius: 1 # Forward preload radius only_when_moving: false # Only load when moving update_interval_ticks: 10 # Refresh interval ```

Travel Time Estimation (travel_time) ```yaml travel_time: enabled: true # Enable Bayesian estimation default_section_seconds: 20. 0 # Default section travel time prior_strength: 4. 0 # Prior strength (virtual sample count) outlier_sigma: 3. 0 # Outlier filtering threshold (sigma) decay_per_day: 0. 95 # Daily decay factor use_unboarded_samples: false # Whether to use unboarded samples unboarded_weight: 0. 2 # Unboarded sample weight ```

Local Mode Configuration (local) ```yaml local: activation_radius: 96 # Player radius to trigger spawning (blocks) spawn_lead_ticks: 120 # Target arrival lead time (ticks) suppress_threshold_seconds: 10. 0 # Suppression threshold if a train is arriving (seconds) virtualization: enabled: true # Enable virtualization idle_ticks: 200 # Time to wait before recycling demand-free trains lookahead_stops: 2 # Number of stops to check for demand ```

Physics Engine Configuration (physics) ```yaml physics: lead_kinematic: true # Lead car driven kinematically lookahead_blocks: 4 # Rail geometry lookahead blocks trail_seconds: 10 # Trail buffer duration (seconds) smoothing_lerp: 0. 15 # Smoothing interpolation factor (0=instant, 0. 3=smooth) snap_to_rail: true # Snap to rail center strict_when_has_passenger: true # Strict alignment when carrying passengers position_only_mode: false # Position-only mode (cinematic/display use) ```

Station UI Configuration (titles)

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.

Sound Configuration (sounds)

Supports `departure`, `a