🚂 Railway Evolution v6 — [THE PERFORMANCE & STABILITY CORE]

This update represents the most significant refinement of the Railway Evolution core to date. By rigorously auditing the "hot paths" of our AI logic and eliminating excessive object allocation, we have achieved a new level of tick-rate stability. The focus of v6 is seamless performance: keeping the high-speed traffic flowing without burdening the Java Garbage Collector, even in dense, complex rail networks.

✨ Key Features of v6:

• Zero-Allocation Tick Cycle: Major backend refactor of the VirtualBlockSystem and ReservationManager. By implementing key-based lookups and singleton patterns, we have eliminated redundant object creation during frequent reservation renewals.
• Heuristic Optimization: Advanced mathematical refinement for AccidentZoneMemory (distance-squared comparison) drastically reduces CPU overhead during proximity checks.
• AI Logic Cleanup: Streamlined state management and buffer reuse in the EcosystemRegistry ensures that player-train interactions remain fluid and responsive without triggering GC spikes.
• Refinement of the Core: While the 5,000+ line TrainAIController remains the stable authority, all surrounding support systems have been optimized for maximum efficiency.

🛠 Technical Changelog (v6):

Performance & Memory Optimizations

• VirtualBlockSystem: Optimized tryReserve() and reservation lifecycle management. Implemented key-based caching; renewal logic is now effectively zero-allocation.
• JunctionReservationManager: Introduced GRANTED_NO_GHOST singleton to replace transient result objects during intersection renewals.
• AccidentZoneMemory: Switched to squared-distance heuristics, bypassing unnecessary Math.sqrt() calls during multi-zone iterations.
• EcosystemRegistry: Optimized scanPlayerControls() by replacing transient HashSet allocations with a persistent class-level buffer (stillControlledBuf).
• General Housekeeping: Removed redundant field lookups and variable shadowing in TrainAIManager and EcosystemRegistry to decrease instruction overhead per tick.

Logic & Reliability

• Conflict Resolution: Refactored isHeadOnConflict() to use direct boolean comparison, reducing method-invocation depth in high-frequency logic gates.
• Cleanup: Conducted scope cleanup in tickRefreshAll() to prevent state leakage and improve variable lifecycle efficiency.

🔮 Future Roadmap: Stability & Scalability

With the v6 performance optimizations complete, the core logic is now more efficient than ever. This release ensures that Railway Evolution remains performant even as your rail networks grow in scale and complexity. My focus remains on maintaining this high-performance core across future Minecraft versions, providing a rock-solid foundation for the world’s most advanced rail automation systems.

Developed by Fizzy_lovely (1xCodeTeam) — Precision engineering, zero-lag performance.

HOT FIX

🚂 Railway Evolution v1.0.5 — [THE ECOSYSTEM & INTERSECTION OVERHAUL]

This update marks a significant architectural milestone, transforming Railway Evolution from an AI-train controller into a full-scale Traffic Ecosystem. By introducing the Event-Driven Perception Engine and Player-Train integration, we have achieved seamless traffic management where AI and players exist in the same environment.

✨ Key Features of v1.0.5:

• Ecosystem V2: A unified, event-driven perception engine allows AI to perceive player-controlled trains as dynamic traffic participants rather than obstacles.
• Flow Follower (Convoy Mode): AI trains now intelligently match the speed of the lead vehicle (player or AI), allowing for fluid, real-world traffic patterns without constant emergency braking.
• Deterministic Junction Priority: Replaced the legacy "first-come-first-served" logic with a distance-based "steal" mechanism, ensuring the closest train always has the right-of-way.
• Zero-Allocation Architecture: Massive backend refactor using VarHandle and object pools, resulting in near-zero GC pressure during high-traffic ticks.

🛠 Technical Changelog (v1.0.5):

Perception & Ecosystem

• PerceptionEngine: New event-driven scanner using swept Bezier-sampling for precise curved track awareness.
• EcosystemRegistry: Centralized real-time registry for all entities (AI + Player-controlled).
• PlayerTrainHandle: Dedicated adapter that enables player-driven trains to be registered in the VBS and traffic registries.
• FSM v2: Implemented a new multi-layered State Machine with Layer 1 (Player) → Layer 0 (Safety) authority model.

Intersection Logic

• JunctionReservationManager: Added distance-based stealing logic—trains now "steal" reservations if they are significantly closer (>3 blocks) to the intersection.
• Ghost Pass Logic: Trains yielding at an intersection now designate the winner, allowing the winner to perform a "ghost pass" through the yielding train.

Collision & Proximity Fixes

• Lateral Tolerance Optimization: Reduced lateral scanning distance from 8 to 3.5 blocks, eliminating phantom braking on parallel tracks.
• Omni-Zone Refinement: Omnidirectional detection range reduced from 8 to 5 blocks with strict isOnSameTrack() filtering.
• BFS Filtering: Fixed flickering where physical scans conflicted with BFS results; physical scans now only override BFS if a threat is 4+ blocks closer.
• Player Detection: Expanded detection radius for player-controlled trains to 20 blocks, bypassing strict graph-data filters to ensure the AI never loses sight of the player.

Refactor & Performance

• VarHandle Integration: Replaced reflective Field.get() calls with VarHandle for 5–10x faster primitive access.
• State Machine Cleanup: Removed conflicting forceStop() triggers from old state logic; unified FSM v2 as the primary authority.

📂 New Architecture Files:

• ai/core/PerceptionEngine.java, ai/core/SafetyManager.java, ai/core/TrainControlContext.java, ai/core/ObstacleProfile.java, ai/adapter/EcosystemRegistry.java, ai/adapter/PlayerTrainHandle.java, ai/state/TrainControlStateMachine.java

🔮 Future Roadmap: Long-Term Support

With the v1.0.5 architecture now stabilized and fully modularized via the Adapter pattern, Railway Evolution enters a phase of long-term stable support. My primary focus is now maintaining this high-performance core across multiple versions of Minecraft and Create, ensuring your rail networks remain reliable for years to come. I am committed to deep, consistent maintenance to keep this project the gold standard for rail automation.

Developed by Fizzy_lovely (1xCodeTeam) — Making trains smarter, one line at a time.

🚂 Railway Evolution v1.0.4 — [THE TRAFFIC & MUTEX UPDATE]

This is a professional-grade AI overhaul for Create Mod trains. Version 1.0.4 introduces advanced traffic management systems, including junction mutexes and predictive collision analysis, moving beyond simple raycasting to a true "Traffic Control" architecture.

✨ Key Features of v1.0.4:

• 🔒 Junction Reservation (Mutex System): Trains must now "reserve" complex intersections (3+ connections) before entry. This prevents the classic "head-on" deadlocks at crossings. Includes 10s auto-expiry and deterministic UUID tiebreaking.
• 📏 Adaptive Track-Size Scaling: The AI dynamically adjusts its braking behavior using bufferScale based on track length, ensuring smooth stops on long lines and aggressive braking on short tracks.
• 🗄️ Multi-Layered Registries: Real-time databases for both stationary (StoppedTrainRegistry) and active (MovingTrainRegistry) traffic with TTC (Time-To-Collision) calculation.
• 🔮 Predictive Collision Analysis: The AI calculates future positions, initiating proactive deceleration up to 5 seconds before a potential impact.

🛠 Technical Changelog (v1.0.4):

1. JunctionReservationManager: New mutex logic for safe intersection passage and deadlock prevention.
2. StoppedTrainRegistry: Guaranteed detection for stationary and derailed trains.
3. MovingTrainRegistry: Vector-based traffic analysis and predictive TTC logic.
4. Direction-aware Distance: Dot-product math for precise "Edge-to-Edge" accuracy.
5. Precision Beam Overhaul: Straight (1.5), Curve (3.5), and Ultra-close (4.0) beam optimizations.
6. Overlap Deadlock Breaker: Automatic reverse resolution for clipped trains after 3 seconds (60 ticks).
7. Critical BFS Fix: Resolved data loss issue (fixed return null to return graphHit).
8. Adaptive Scaling: Dynamic safety zones based on track segment size (20b, 50b, 100b+).
9. Build Optimization: Fixed "duplicate range variable" compilation errors.
10. System Orchestration: TrainAIManager now coordinates VBS, Registries, Junctions, and Accident Zones.

⚙️ v1.0.4 Scanning Pipeline:

1. graphWalkScan() — Primary BFS search with Junction Mutex checks.
2. Stopped Registry — Instant stationary obstacle lookup.
3. Moving Registry — Dynamic traffic vector analysis.
4. Ultra-close scan — Emergency fallback (≤16 blocks).
5. Post-BFS proximity — Final distance verification.
6. Fallback beam — Secondary raycast for missing graph data.

Developed by Fizzy_lovely — Making trains smarter, one line at a time.

🚂 Railway Evolution v1.0.3 by Fizzy_lovely

[STABILITY & PRECISION UPDATE] — This major update introduces a complete rewrite of the limit-breaking system for the latest Create versions and perfects train vision on curved tracks.

🔹 Key Features:

• 🚀 True Infinity Mode: Completely bypassed the new "Catnip" library limits. Build trains and tracks of any length without restrictions.
• 📐 Precision Curve Awareness: Restored full obstacle detection on turns. Trains now "see" along the rails (tangents), not just direct movement vectors.
• 🎮 Enhanced Manual Control: When a player takes the throttle, the AI completely steps aside, disabling all automatic braking for a true manual experience.

🛠 Changelog:

1. 🚫 Infinity Mode Rewrite (Critical Fix)

• The Catnip Patch: Adapted for Create 6.0.10 and the Catnip library. The system now uses advanced reflection to patch ConfigInt and ModConfigSpec.IntValue hard-coded maximums.
• Unlocked Limits:
  • Track Placement Length: 32 → 10,000 blocks
  • Max Train Assembly Length: 128 → 10,000 blocks
  • Max Bogey Count: 20 → 10,000 bogeys
  • Max Blocks Moved: 2048 → 10,000 blocks
• Added detailed server-side diagnostics (WARN logs) to verify every patched value.

2. 📐 Improved Curve Vision & Braking

• Tangent Calculation: Fixed the "chord vs tangent" issue. Heading is now derived from track geometry (nodes) instead of movement delta.
• Static Detection: Fixed trains going "blind" when stopped on a curve.
• Refined Thresholds: Lowered detection threshold from 1.5 to 0.5 blocks for pinpoint accuracy on sharp turns.
• Geometry Blending: Increased track geometry blend to 85% for smoother tracking.

3. 🎮 AI & Movement Logic

• Manual Override: AI braking is 100% disabled while a player is driving (runtime.paused detection for Create 6.0.x).
• Passenger Filtering: Players acting as passengers or drivers are no longer detected as obstacles "on the tracks."
• Anti-Gridlock: Refined junction yielding with a UUID-based tiebreak system to solve intersection stalemates.

🚦 Console Commands:

⚠️ Requirements:

• NeoForge: 1.21.1
• Create: 0.6.10+ (and newer versions using Catnip library)

Thank you for 1,500+ downloads! Let’s keep the tracks moving! 🚂✨

🚂 Railway Evolution v1.0.2 [RELEASE] — The Vanilla Edition. This major update fixes critical manual override bugs and fully adapts the AI for the latest Create versions. We've completely rewritten the limits system and added granular braking configurations.

🔹 Key Features: 🚀 NeoForge Native: Fully compatible with Create 0.6.9 / 0.6.10 on Minecraft 1.21.1. 🎮 Manual Override Fix: AI "Control Lock" is gone. If you take the controls, the AI steps aside. ♾️ Infinity Mode: The /railway infinity command now successfully bypasses track and train length limits. 📐 Curve Awareness: Trains no longer go "blind" on turns. Full obstacle detection on curved tracks is restored.

🛠 Changelog: 🔴 Fixes & Optimizations:

Manual Control: AI now correctly detects manual override (runtime.paused). If a player is driving, the AI disables all forced braking to give you full control.

Passenger Logic: Passengers and drivers are no longer detected as obstacles "on the tracks." Your train won't emergency brake for its own crew anymore.

Junction Tiebreak: Gridlocks are solved. If two trains reach a junction at the exact same time, a UUID-based tiebreak ensures only one yields.

Yielding Polish: Improved logic for clearing intersections. Slow-moving trains will no longer cause others to wait indefinitely.

🟢 New Improvements:

Infinity Mode (Tracks & Trains): Completely rewritten to work with new Create configs. Using /railway infinity now increases limits for track placement, bogey count, and station length to 10,000 blocks.

Curve Detection: Restored AI functionality on curved sections where Create's data often resets. Trains now see each other clearly even on sharp turns.

New Braking System: Added advanced commands to fine-tune how your trains stop.

💬 Console Commands:

/railway braking distance <5-200> — Sets obstacle detection range (Default: 50 blocks).

/railway braking sharpness <1-10> — Sets braking intensity (1: Smooth/Early, 10: Aggressive/Late).

/railway infinity [true/false] — Toggles unlimited track placement and train lengths.

⚠️ Requirements: NeoForge 1.21.1 | Create 0.6.10+

Thank you for 1,500 downloads! Let's keep the tracks moving! 🚂💎🔥

🚂 Railway Evolution v1.0.0 [Backport to 1.18.2 Forge]

Important Note: This version is based on the Forge 1.20.1 source code. While it brings the essential train AI improvements to 1.18.2, please keep in mind that it does not include the latest experimental features found in the 1.21.1 NeoForge release. This is a "Legacy Stable" version.

🔴 End of Support Notice: Please be aware that older versions (1.18.2, 1.19.2, and 1.20.1) will no longer receive updates, bug fixes, or technical support. These versions are provided "as-is". All future active development, features, and fixes will be focused exclusively on 1.21.1+ (NeoForge).

🔹 Features included:

Core junction priority system (First Come, First Served).

Basic collision prevention logic for intersections.

Optimized AI pathfinding for 1.18.2 environment.

Smooth braking logic for improved rail safety.

⚠️ Requirements: Forge 1.18.2 | Create 0.5.1.i

Thanks to our 1373+ users for the support! Let's evolve the rails together. 🚂💎🔥

Railway Evolution v1.0.1 [RELEASE] — The Refinement Update. After the massive success of the initial release, we are launching a refinement update. This version focuses on stability, removing hard-coded limitations, and giving you full console control over your rail networks.

🔹 Key Features: 🎮 Full Control: Integrated command system (/railway / /railwayai) for logging, safety, and unlimited modes.

🛠 Changelog: 🔴 Fixes & Optimizations:

Movement: Fixed jerky braking and YIELDING lock-ups; kinematic braking now works smoothly.

Collision Logic: Optimized parallel track awareness and bridge detection (reduced Y-tolerance to 6 blocks).

AI Vision: Added myGraph filtering to ensure trains on different networks don't block each other.

Console: Spam removed; AI logs are now hidden by default.

🟢 New Improvements:

Unlimited Mode: Added /railway infinity to remove hard-coded train length and track building limits.

Driver Override: Improved "driver-in-train" detection — AI no longer treats the engineer as an obstacle.

Emergency Recovery: Added 30-second JAM auto-timeout for stuck trains.

Safe-mode: Toggleable via /railway safe-mode [true/false] to prevent accidental collisions.

💬 Console Commands:

/railway — List all trains (ID, status, speed, position).

/railway log [true/false] — Toggle AI debug logs.

/railway safe-mode [true/false] — Toggle AI safety protocols.

/railway release — Instantly free all jammed trains.

/railway reload — Reload AI-manager.

/railway infinity [true/false] — Remove train/track limits.

⚠️ Requirements: NeoForge 1.21.1 | Create 0.6.1+

Thanks to our 1200+ users for the support! Let’s keep the tracks busy! 🚂💎🔥