# 🚂 Create: Railway Evolution 1.0 — Forge 1.20.1 **The Railway Evolution experience comes to Minecraft Forge 1.20.1!** **Railway Evolution теперь доступен для Minecraft Forge 1.20.1!** This release brings the Railway Evolution train AI and architectural improvements to the Forge 1.20.1 ecosystem. The codebase has been adapted from the NeoForge 1.21.1 development branch, with compatibility changes for Forge's event system, configuration, registries, and mod loading. Этот выпуск переносит ИИ поездов Railway Evolution и архитектурные улучшения в экосистему Forge 1.20.1. Кодовая база адаптирована из ветки разработки NeoForge 1.21.1 с изменениями для совместимости с системой событий, конфигурацией, реестрами и загрузкой модов Forge. ## ✨ What's New / Что нового ### 🧠 Train Priority System / Система приоритетов поездов - Introduced `TrainPriorityLevel` and `TrainPriorityRegistry`. - Integrated train priorities into `JunctionReservationManager`. - Added priority-aware junction reservation handling and the *ghost pass* mechanism. - Добавлены `TrainPriorityLevel` и `TrainPriorityRegistry`. - Система приоритетов интегрирована в `JunctionReservationManager`. - Добавлена обработка резерваций перекрёстков с учётом приоритетов и механизм *ghost pass*. ### ⚙️ Rail Occupancy Optimization / Оптимизация занятости рельсов - Added `EdgeOccupancy` to represent rail-edge occupancy. - Introduced object pooling in `TrainScanMaps` to reduce unnecessary allocations during train scanning. - Improved support for tracking multiple trains occupying the same rail edge. - Добавлен `EdgeOccupancy` для представления занятости участков железнодорожного графа. - В `TrainScanMaps` внедрён пул объектов для сокращения лишних выделений памяти при сканировании поездов. - Улучшена поддержка отслеживания нескольких поездов на одном ребре графа. ### 🎮 Train Actuator and Control Handles / Исполнительный слой и управление поездами - Added `TrainActuator` and `TrainHandle` to separate train control commands from higher-level AI logic. - Improved the architectural separation of speed control, braking, and navigation operations. - Добавлены `TrainActuator` и `TrainHandle` для отделения управляющих команд от логики высокого уровня. - Улучшено разделение операций управления скоростью, торможения и навигации. ### 🔍 Train States and Diagnostics / Состояния поездов и диагностика - Added the new `StoppedState`. - Introduced `TrackPriority` and `TrackPriorityClassifier` for track classification. - Added diagnostic and recovery components: - `TrainDiagnosticSnapshot` - `TransientBrakeState` - `NativeRecoveryStatus` - `NavigationKickstartOutcome` - Добавлено новое состояние `StoppedState`. - Внедрены `TrackPriority` и `TrackPriorityClassifier` для классификации путей. - Добавлены компоненты диагностики и восстановления: - `TrainDiagnosticSnapshot` - `TransientBrakeState` - `NativeRecoveryStatus` - `NavigationKickstartOutcome` ### 🧪 Testing Infrastructure / Инфраструктура тестирования - Ported `EdgeOccupancyTest` and `VirtualBlockSystemOptimizationTest`. - Added JUnit Jupiter dependencies for unit testing. - Перенесены `EdgeOccupancyTest` и `VirtualBlockSystemOptimizationTest`. - Добавлены зависимости JUnit Jupiter для модульного тестирования. ## 🔧 Forge 1.20.1 Compatibility / Совместимость с Forge 1.20.1 This release adapts the mod's infrastructure to Minecraft Forge 1.20.1: - Reworked mod initialization and event bus registration for Forge. - Adapted server tick event handling to Forge's tick event API. - Migrated configuration handling to `ForgeConfigSpec`. - Updated item registration to use Forge registries and `RegistryObject`. - Adjusted resource pack metadata for Minecraft 1.20.1. - Configured `mods.toml` for the Forge environment and removed the NeoForge-specific metadata file. - Updated Gradle configuration and dependencies. Этот выпуск адаптирует инфраструктуру мода под Minecraft Forge 1.20.1: - Переработана инициализация мода и регистрация шин событий для Forge. - Обработчик серверных тиков адаптирован под API событий Forge. - Конфигурация переведена на `ForgeConfigSpec`. - Регистрация предметов адаптирована к реестрам Forge и `RegistryObject`. - Обновлены метаданные ресурсов для Minecraft 1.20.1. - Настроен `mods.toml` для Forge и удалён файл метаданных, специфичный для NeoForge. - Обновлены настройки Gradle и зависимости. ## 🤖 AI-Assisted Development / Разработка с использованием ИИ This version was developed with AI assistance. AI tools were used to help port and adapt the codebase, implement architectural changes, and assist with code analysis and development tasks. Development direction and project decisions remain under the direction of **Fizzy_lovely (1xCodeTeam)**. Эта версия разработана с использованием ИИ. Инструменты искусственного интеллекта помогали переносить и адаптировать кодовую базу, реализовывать архитектурные изменения, анализировать код и выполнять задачи разработки. Направление развития и решения по проекту определяет **Fizzy_lovely (1xCodeTeam)**. AI assistance does not guarantee that the release is free of bugs. Please report any issues you encounter so they can be investigated and addressed. Использование ИИ не гарантирует отсутствия ошибок. Пожалуйста, сообщайте об обнаруженных проблемах, чтобы их можно было изучить и исправить. ## 📌 Release Information / Информация о выпуске - **Mod:** Create: Railway Evolution - **Version:** 1.0 - **Minecraft:** 1.20.1 - **Mod Loader:** Minecraft Forge - **Developer:** Fizzy_lovely (1xCodeTeam) - **Мод:** Create: Railway Evolution - **Версия:** 1.0 - **Minecraft:** 1.20.1 - **Загрузчик:** Minecraft Forge - **Разработчик:** Fizzy_lovely (1xCodeTeam) ## 🐞 Bug Reports / Сообщения об ошибках If you encounter bugs, unexpected train behavior, or compatibility issues, please report them on GitHub: [**Report an Issue on GitHub**](https://github.com/myakk394-sys/Railway-Evolution/issues) Если вы обнаружили ошибки, неожиданное поведение поездов или проблемы совместимости, сообщите о них на GitHub: [**Сообщить об ошибке на GitHub**](https://github.com/myakk394-sys/Railway-Evolution/issues) --- **Thank you for supporting Create: Railway Evolution! More intelligent railway automation is here. 🚂** **Спасибо за поддержку Create: Railway Evolution! Железнодорожная автоматизация становится умнее. 🚂**

# 🚂 Create: Railway Evolution v1.0 — [TRAIN AI, DEADLOCK & NAVIGATION FIXES] This update focuses on resolving several critical issues in Railway Evolution's train AI, including false obstacle detection, junction deadlocks, trains getting stuck after world loading, and navigation recovery failures. After investigating both the mod's codebase and Create's source code, I identified the underlying causes of these problems and implemented targeted fixes instead of relying on temporary workarounds. / Это обновление посвящено исправлению нескольких критических проблем ИИ поездов в Railway Evolution: ложного обнаружения препятствий, взаимных блокировок на перекрёстках, застревания поездов после загрузки мира и сбоев восстановления навигации. После детального изучения кодовой базы мода и исходников Create мне удалось выявить причины этих проблем и внести целевые исправления вместо использования временных обходных решений. --- ## 🙏 An Apology & Update from the Developer / Извинения и новости от разработчика First of all, I want to sincerely apologize for being absent for almost two months without providing proper updates. I know that many of you have been waiting for news, fixes, and improvements, and I'm sorry for the long silence. The main reasons for my absence were my studies and moving to a new Linux distribution. This transition took time away from development, and I wasn't able to communicate with the community as consistently as I would have liked. Despite the delay, I haven't abandoned Railway Evolution. I've been working on understanding the deeper issues affecting train behavior and making the AI more reliable. Thank you to everyone who continued supporting the project, reporting bugs, and waiting patiently. With over 11,000 downloads, Railway Evolution has grown beyond a small personal project, and I don't take your support for granted. I'm sorry for keeping you waiting, and thank you for staying with the project. ❤️ / Прежде всего, я хочу искренне извиниться за то, что меня почти два месяца не было и я не публиковал нормальных обновлений о разработке. Я понимаю, что многие ждали новостей, исправлений и улучшений, и мне действительно жаль, что так долго не выходил на связь. Основными причинами моего отсутствия стали учёба и переход на новый дистрибутив Linux. На адаптацию к новой системе и решение сопутствующих задач ушло немало времени, поэтому уделять разработке и общению с сообществом столько внимания, сколько хотелось бы, у меня не получалось. Несмотря на задержку, я не забросил Railway Evolution. Я продолжил разбираться в глубинных проблемах поведения поездов, чтобы сделать ИИ надёжнее. Спасибо всем, кто продолжал поддерживать проект, сообщать об ошибках и терпеливо ждать. У Railway Evolution уже более 11 тысяч скачиваний, и я прекрасно понимаю, что за этой цифрой стоят реальные игроки, которые используют мой мод в своих мирах. Я не воспринимаю вашу поддержку как должное. Простите за долгое ожидание и спасибо, что остаетесь с проектом! ❤️ --- ## ✨ Key Fixes & Improvements / Основные исправления и улучшения ### 1. 🛤️ False Obstacle Detection & Parallel Track Awareness / Ложные препятствия и распознавание параллельных путей **Trains should no longer stop because of unrelated trains on nearby tracks.** Previously, the main `graphWalkScan` scanner could confirm that the route ahead was clear, only for the fallback `StoppedTrainRegistry` or `MovingTrainRegistry` scanner to detect an unrelated train nearby and incorrectly classify it as an obstacle. The fallback scanners used a broad detection angle and a radius of up to 64 blocks without sufficiently checking whether the detected train was actually on the same track or how far it was offset sideways. This meant a train parked on a parallel track, station platform, or dead-end could cause an unnecessary stop on a completely clear route. **What changed:** - **Track-Aware Detection:** Added stricter checks to `StoppedTrainRegistry` and `MovingTrainRegistry` to distinguish relevant obstacles from trains on unrelated tracks. - **Graph Scan Priority:** When `graphWalkScan` confirms that the route is clear, trains on other tracks are ignored by the fallback detection logic. - **Lateral Distance Filtering:** Added perpendicular-distance checks using `perpDist` and `currentBeamTolerance` to reduce false positives. - **Clearer Routes, Fewer Unnecessary Stops:** Nearby trains are less likely to interfere with traffic on parallel lines and station platforms. / **Поезда больше не должны останавливаться из-за посторонних составов на соседних путях.** Раньше основной сканер `graphWalkScan` мог подтверждать, что путь свободен, но резервные сканеры `StoppedTrainRegistry` и `MovingTrainRegistry` обнаруживали другой поезд поблизости и ошибочно считали его препятствием. Резервное обнаружение использовало радиус до 64 блоков и широкий угол обзора, при этом недостаточно учитывалось, находится ли состав на том же пути и насколько сильно он смещён в сторону. Поэтому поезд на соседней колее, платформе станции или в тупике мог заставить наш состав остановиться посреди совершенно свободного перегона. **Что изменено:** - **Проверка принадлежности к пути:** Добавлены более строгие проверки в `StoppedTrainRegistry` и `MovingTrainRegistry`. - **Приоритет сканирования графа:** Если `graphWalkScan` подтверждает, что маршрут свободен, резервный сканер игнорирует поезда на других путях. - **Фильтрация бокового расстояния:** Добавлена проверка `perpDist` с учётом `currentBeamTolerance`, уменьшающая количество ложных препятствий. - **Меньше ненужных остановок:** Поезда на параллельных колеях и соседних платформах реже мешают движению составов по свободному маршруту. ### 2. 🚦 Junction Deadlock Prevention / Устранение взаимных блокировок на перекрёстках **The train that wins junction arbitration must actually be able to move.** Previously, when two trains approached a junction, the AI could correctly determine which train had the right of way but fail to restore the winning train's throttle or transition it back to the `CRUISING` state. The winner was granted permission to proceed but could remain stationary. **What changed:** - **Winner Recovery:** When `effectiveWin` determines that a train wins the junction conflict, the controller restores throttle, wakes Create's navigation, and activates `CRUISING`. - **Junction Reservation Protection:** Trains with valid junction reservations receive improved protection against unnecessary emergency stops when passage is safe. - **Improved Priority Tie-Breaking:** Junction reservations and distance to the switch help resolve conflicts between trains with equal priorities. - **Extended Yield Timeout:** Yielding can remain active for up to 300 ticks (15 seconds), or until the winning train moves more than 30 blocks away. - **Bypass Ignore Coordination:** The yielding train can temporarily configure the winner to ignore it during bypass detection, reducing unnecessary braking near the junction. / **Поезд, получивший право проезда перекрёстка, теперь корректно восстанавливает движение.** Раньше ИИ мог правильно определить победителя в конфликте на стрелке, но не восстановить тягу и не перевести состав обратно в состояние `CRUISING`. Поезд получал разрешение на проезд, но продолжал стоять. **Что изменено:** - **Восстановление движения победителя:** При срабатывании `effectiveWin` восстанавливается тяга, пробуждается навигация Create и активируется состояние `CRUISING`. - **Защита резерваций перекрёстков:** Составы с действующей резервацией лучше защищены от ненужных аварийных остановок, если проезд безопасен. - **Разрешение равных приоритетов:** Учитываются резервация перекрёстка и расстояние до стрелки. - **Увеличенное время уступки:** До 300 тиков (15 секунд) либо до удаления победившего состава более чем на 30 блоков. - **Координация обнаружения препятствий:** Временно исключается лишнее торможение перед перекрёстком из-за состава, который уже уступает дорогу. ### 3. 🔄 Stuck Trains After World Loading / Застревание поездов после загрузки мира **Fixed a recovery issue where trains could load with zero throttle and never start moving again.** Create saves train parameters, including throttle and target speed, to NBT. If an AI-controlled train was stopped when the world was saved, its throttle could remain at `0.0` after loading. The AI controller could initialize in `CRUISING`, even though the train had no throttle. Since the old recovery logic primarily restored throttle when leaving `WAIT_FOR_CLEARANCE` or `YIELDING`, a train already in `CRUISING` could remain permanently stationary despite having a clear route. **What changed:** - **Automatic Throttle Recovery:** `handleNoObstacle()` now checks for insufficient throttle in `CRUISING` when the route ahead is clear. - **Navigation Wake-Up:** If a train is stationary despite having an active schedule, the controller restores throttle and calls `wakeCreateNavigation()`. - **Initial Binding Recovery:** `bindCreateTrain()` now removes throttle lock conditions during the train's initial binding after world or server startup. - **More Reliable Restarts:** Trains have an improved recovery path when their saved state would otherwise prevent them from moving. / **Исправлена проблема, из-за которой поезда после загрузки мира могли оставаться с нулевой тягой.** Create сохраняет параметры поездов, включая тягу и целевую скорость, в NBT. Если ИИ остановил состав перед сохранением мира, после загрузки тяга могла остаться равной `0.0`. При этом контроллер ИИ мог сразу перейти в состояние `CRUISING`, хотя поезд фактически не имел тяги. Старая логика восстановления работала преимущественно при выходе из `WAIT_FOR_CLEARANCE` или `YIELDING`. Поэтому состав в состоянии `CRUISING` мог бесконечно стоять даже при свободном пути. **Что изменено:** - **Автоматическое восстановление тяги:** `handleNoObstacle()` проверяет состояние тяги в `CRUISING`, если впереди свободно. - **Пробуждение навигации:** Если поезд стоит при активном расписании, восстанавливается тяга и вызывается `wakeCreateNavigation()`. - **Восстановление при первоначальной привязке:** `bindCreateTrain()` снимает блокировку тяги при первоначальной привязке состава после запуска мира или сервера. - **Более надёжный запуск:** Улучшен механизм восстановления поездов, чьё сохранённое состояние мешает возобновлению движения. ### 4. 🛠️ Blocked Train Recovery & Navigation Guards / Восстановление заблокированных поездов **Stopped trains can now recover instead of being trapped by a permanent safety guard.** Create's `TravellingPoint.blocked` flag can be set when a train's travelling point reaches the end of a rail. Create normally clears this flag during `travel()`, but a stationary train may never call that movement logic. Previously, Guard 2 could repeatedly call `forceStop()` and return early on every tick. Since the train was already stationary, the flag could remain set indefinitely, preventing recovery logic such as reversing or switching tracks from executing. **What changed:** - **Movement-Aware Guard:** Guard 2 now activates only while the train is actively moving forward (`currentSpeed > 0.05`). - **Recovery Logic Preserved:** When a train is already stopped, the guard no longer blocks the entire AI tick, allowing reversing and track-switching logic to run. - **Safer Navigation Recovery:** Early recovery attempts restore throttle and wake Create's navigation instead of immediately destroying the current route. - **Clearance Improvements:** Additional checks prevent trains on parallel tracks or already-yielding trains from unnecessarily blocking departure. / **Исправлена логика защитного механизма, которая могла навсегда блокировать восстановление поезда.** Флаг `TravellingPoint.blocked` в Create может устанавливаться, когда точка движения достигает конца рельса. Обычно Create сбрасывает этот флаг во время `travel()`, однако полностью остановленный поезд может больше не вызывать эту логику движения. Раньше Guard 2 мог каждый тик вызывать `forceStop()` и досрочно завершать выполнение логики ИИ. Поскольку поезд уже стоял, флаг мог оставаться активным бесконечно, блокируя восстановление движения, реверс и переключение пути. **Что изменено:** - **Проверка фактического движения:** Guard 2 срабатывает только при активном движении вперёд (`currentSpeed > 0.05`). - **Сохранение логики восстановления:** Если поезд уже остановлен, защитный механизм больше не блокирует весь тик ИИ, позволяя выполнить реверс или переключение пути. - **Бережное восстановление навигации:** На первых попытках восстановления тяга возвращается, а навигация Create пробуждается без немедленного сброса маршрута. - **Улучшенные проверки свободного пути:** Поезда на соседних путях и уже уступающие составы не должны без необходимости блокировать отправление. --- ## 🔧 Technical Summary / Техническая сводка - Improved player-control detection and train priority registration. - Refined virtual block coordination and junction conflict resolution. - Added track-aware fallback obstacle detection and lateral-distance filtering. - Fixed missing throttle restoration after junction arbitration. - Added throttle recovery for trains loaded with zero throttle. - Improved initial train binding after world and server startup. - Prevented stationary trains from being trapped by the `createBlocked` safety guard. - Improved navigation wake-up and non-destructive stuck-train recovery. / Краткий список технических изменений: - Улучшено обнаружение управления поездом со стороны игрока и регистрация приоритетов. - Доработаны виртуальные блокировки и разрешение конфликтов на перекрёстках. - Добавлены проверки принадлежности к пути и бокового расстояния при обнаружении препятствий. - Исправлено отсутствие восстановления тяги после определения победителя на стрелке. - Добавлено восстановление тяги у поездов, загруженных с нулевым значением. - Улучшена первоначальная привязка поездов после запуска мира и сервера. - Исправлена блокировка логики ИИ у остановленных поездов из-за защитного механизма `createBlocked`. - Улучшено пробуждение навигации и восстановление застрявших составов без принудительного сброса маршрута. --- ## 🔮 What's Next? / Что дальше? Railway Evolution aims to make large automated Create railway networks easier to operate without relying on conventional signals. This update addresses several underlying AI issues and improves how trains detect obstacles, negotiate junctions, and recover from unexpected stopped states. I will continue improving the mod and appreciate any bug reports, feedback, and real-world testing on complex railway networks. Thank you for your patience, support, and for being part of Railway Evolution's journey. / Цель Railway Evolution — упростить управление большими автоматизированными железнодорожными сетями Create без необходимости использовать обычные сигналы. Это обновление устраняет ряд глубинных проблем ИИ и улучшает обнаружение препятствий, взаимодействие на перекрёстках и восстановление после неожиданных остановок. Я продолжу развивать мод и буду благодарен за сообщения об ошибках, отзывы и тестирование на сложных железнодорожных сетях. Спасибо за терпение, поддержку и за то, что вы являетесь частью истории Railway Evolution! **Happy railroading! 🚂❤️**

🚂 Railway Evolution v1.0.8 — [CORE PERFORMANCE & MEMORY OVERHAUL] This update delivers critical performance optimizations and garbage-collection improvements, targeting high-frequency tick loops across core registries and controllers. / Это обновление приносит критические оптимизации производительности и снижение нагрузки на сборщик мусора (GC), затрагивая высокочастотные тиковые циклы в ключевых реестрах и контроллерах. To be completely transparent with the community: profiling heavy networks revealed hidden allocation bottlenecks during high-frequency checks. Version 1.0.8 aggressively eliminates transient object spamming and redundant string operations per tick. / Буду честен с сообществом: профилирование тяжелых сетей выявило скрытые узкие места выделения памяти во время частых проверок. Версия 1.0.8 агрессивно убирает мусор из временных объектов и избыточные операции со строками за каждый тик. Version 1.0.8 eliminates per-tick array allocations, caches immutable identifiers, and optimizes collection sorting, making Railway Evolution faster and lighter on server resources. / Версия 1.0.8 полностью убирает выделение массивов за каждый тик, кэширует неизменяемые идентификаторы и оптимизирует сортировку коллекций, делая Railway Evolution быстрее и легче для серверных ресурсов. ✨ Key Features & Improvements / Ключевые изменения и улучшения: * **Zero-Allocation Coordinate Lookups / Нулевые аллокации координат:** `TrainAIController.java`: `getNodeXZ()` / `getNodeXYZ()` no longer allocate new `double[]` arrays every tick, relying instead on an internal reusable buffer `_nodeCoordBuf`. / `TrainAIController.java`: `getNodeXZ()` / `getNodeXYZ()`: Устранена аллокация массивов `new double[]` каждый тик — теперь используется внутренний переиспользуемый буфер `_nodeCoordBuf`. * **Identifier Caching & CPU Saving / Кэширование идентификаторов:** Precomputed `final String shortId` inside the constructor, removing over 70 costly `trainId.toString().substring(0, 8)` calls per tick. / Предрассчитывается `shortId`: Поле `final String shortId` предрассчитывается один раз в конструкторе, убраны 70+ вызовов `trainId.toString().substring(0, 8)` за тик. * **Lambda-Free Registry Sorting / Сортировка без лямбд в реестрах:** `StoppedTrainRegistry.java` and `MovingTrainRegistry.java`: Distance sorting in `getNearby()` has been migrated to a static `DistanceComparator` instance, eliminating anonymous lambda allocations. / `StoppedTrainRegistry.java` и `MovingTrainRegistry.java`: Сортировка по дистанции в `getNearby()` переведена на статический экземпляр `DistanceComparator` (устранены анонимные лямбды при сортировке). * **Optimized Segment Keys / Оптимизированные ключи сегментов:** `VirtualBlockSystem.java`: String concatenation in `makeSegmentKey()` replaced with a lightweight `record SegmentKey(int dimHash, long posA, long posB)` utilizing packed coordinates via `BlockPos.asLong()`. / `VirtualBlockSystem.java`: Конкатенация строк в `makeSegmentKey()` заменена на компактный `record SegmentKey(int dimHash, long posA, long posB)` с упаковкой координат через `BlockPos.asLong()`. * **Reusable Safety Evaluations / Переиспользуемые структуры безопасности:** `SafetyManager.java`: Eliminated `new SafetyResult(...)` allocations during safety evaluations by utilizing a `reusable.set(...)` pattern. / `SafetyManager.java`: Устранены аллокации `new SafetyResult(...)` при оценке безопасности — используется переиспользуемый `reusable.set(...)`. * **API & State Machine Refinements / Доработки состояний и API:** `TrainStateId.java` & `TrainActuator.java`: Added `STOPPED` to the `TrainStateId` enum and standardized the `ITrainHandle` interface implementation in `TrainActuator`. / `TrainStateId.java` и `TrainActuator.java`: Добавлен `STOPPED` в enum `TrainStateId`. Приведена к стандарту имплементация интерфейса `ITrainHandle` в `TrainActuator`. 🔮 What's Next / Что дальше: With these low-level performance bottlenecks crushed, tick times are tighter than ever, ensuring smoother sessions for massive automated networks. Thank you for your continued support and bug reports! / Благодаря устранению этих низкоуровневых узких мест производительности, время тиков стало стабильнее, обеспечивая плавную работу масштабных автоматизированных сетей. Спасибо за вашу поддержку и багрепорты! 🚀

# 🚂 Railway Evolution v1.0.8 — [THE UNIFIED AI CORE OVERHAUL] This update represents the most important architectural milestone in the history of Railway Evolution. / Это обновление — важнейший архитектурный рубеж в истории Railway Evolution. To be completely transparent with the community: my previous patch attempts were too fragmented. While trying to fix isolated bugs, I realized that "Band-Aid" fixes were no longer enough for complex, high-density railway networks. I went back to the drawing board, conducted a complete audit of the codebase. Буду честен с сообществом: мои предыдущие попытки сделать точечные патчи оказались слишком фрагментарными. Пытаясь исправить отдельные баги, я понял, что полумеры и «заплатки» больше не работают для сложных и загруженных железнодорожных сетей. Я вернулся к истокам. Version 1.0.8 resolves all accumulated logic edge-cases, dimensional bugs, and deadlock locks — making Railway Evolution rock-solid, ultra-performant, and natively compatible with Create 6.0.10+. Версия 1.0.8 окончательно закрывает все накопившиеся логические ошибки, баги с измерениями и взаимные блокировки поездов, делая мод максимально стабильным, производительным и полностью совместимым с Create 6.0.10+. --- ### ✨ Key Features & Improvements / Ключевые изменения и улучшения: * **3D & Dimension-Aware Reservations / 3D и Многомерность:** Virtual Block System (VBS) and Junction Reservations now natively track $Y$-levels and Dimension IDs (Overworld, Nether, End). Multi-level bridges, underground subways, and interdimensional tracks no longer produce false collision stops. / Virtual Block System (VBS) и резервации развязок теперь учитывают $Y$-уровень и ID измерений (Overworld, Nether, End). Многоуровневые мосты, метро и межпространственные пути больше не вызывают ложных торможений. * **Deadlock-Free Junction Management / Устранение Deadlock на развязках:** Overhauled Junction Mutexes. Trains yielding at switches or waiting for clearance now instantly release their junction locks and VBS footprints, eliminating deadlocks on complex S-curve bypasses. / Переработана система мьютексов развилок. Поезда, уступающие дорогу или ожидающие проезда на стрелках, теперь мгновенно освобождают блокировки узлов и VBS, исключая глухие заторы на S-образных разъездах. * **Precision Train Physical Bounds / Точные физические границы длинных составов:** Integrated Trailing Edge tracking alongside Leading Edge scanning. Long trains no longer "disappear" from the track graph when transitioning between nodes. / Добавлен учёт хвоста поезда (Trailing Edge). Длинные составы больше не «исчезают» из графа сканирования, когда их голова переезжает на следующий узел. * **Near-Zero GC Footprint / Near-Zero GC (Оптимизация памяти):** Refactored high-frequency tick loops (StoppedTrainRegistry, MovingTrainRegistry, and Graph Adapters) to use in-place mutations and dynamic object pooling. No transient object spamming during heavy BFS scans. / Горячие циклы тиков переведены на изменяемые in-place структуры и динамические пулы объектов. Сканирование графов больше не засоряет память временными объектами. * **Seamless Player Control / Умное ручное управление:** Fixed passenger-tree inspection (CarriageContraptionEntity). Manual mode now activates only when a living player is sitting in the cab, automatically resuming Create schedule navigation as soon as you step out. / Исправлена проверка пассажиров в кабине. Ручной режим включается только если в сиденье реально сидит живой игрок, и автоматически снимает расписание с паузы, когда вы вылезаете из поезда. * **Create 6.0.10+ Native Compatibility / Родная совместимость с Create 6.0.10+:** Replaced fragile reflection fields (TrackEdge.length) with a resilient multi-tier fallback system (getLength() → Field → Geometric Node Distance), guaranteeing 100% graph adapter stability. / Хрупкая рефлексия TrackEdge.length заменена на каскадный безопасный алгоритм (getLength() → Поле → Геометрическое расстояние между узлами), что обеспечивает 100% стабильность графового адаптера. --- ### 🛠 Technical Summary / Технический свод: * **AI & Perception / Логика угроз:** Implemented velocity-vector HeadOn detection (trailing -> leading) with signed speed evaluation and risk-score obstacle ranking in ObstacleProfile. / Реализовано честное определение встречного движения (HeadOn) по вектору геометрии состава и ранжирование рисков в ObstacleProfile. * **Graph Identity Filtering / Строгая фильтрация графов:** ProximityScanner and CurveScanner now strictly verify TrackGraph IDs, eliminating phantom braking caused by trains on parallel tracks. / Сканеры ближнего радиуса и кривых теперь проверяют ID TrackGraph, полностью исключая фантомные торможения от поездов на соседних параллельных путях. * **Algorithm Safeguards / Защита алгоритмов:** Added ring-buffer overflow protection (bfsQueue bound limit) and dynamic expansion for junction connection pools (INITIAL_EDGE_POOL_SIZE = 16). / Добавлена защита от переполнения кольцевого буфера BFS и динамическое расширение пула развязок (INITIAL_EDGE_POOL_SIZE = 16). --- 🔮 **What's Next / Что дальше:** With the V2 Unified Core fully deployed and rock-solid, I am ready to move forward to new exciting features! Thank you for your continued support, bug reports, and patience! / Благодаря зачистке архитектуры до идеала, фундамент Railway Evolution стал как никогда прочным. Спасибо за вашу поддержку, багрепорты и терпение! 🚂💨

🚂 Railway Evolution v7 — [THE GLOBAL MAP-SCAN & PERFORMANCE CORE] --- This update represents a monumental architectural leap for Railway Evolution. By shifting from per-train $O(N^2)$ scanning loops to a centralized global map pre-computation model (TrainScanMaps powered by IdentityHashMap), we have fundamentally eliminated redundant iterations across high-density rail networks. Version 7 focuses on pure, unadulterated tick-rate stability: keeping complex multi-train logistics fluid, mathematically precise, and completely weightless on the Java Garbage Collector. ✨ **Key Features of v7:** * **Global Map-Scan Architecture:** Replaced dozens of per-controller getAllControllers() scans with a unified, pre-computed tick-phase map (edgeToTrain, reverseEdgeMap, junctionApproachMap). AI pathfinding now queries global states instantly in $O(1)$ time. * **Zero-Allocation Pipeline:** Deep backend refactor utilizing IdentityHashMap alongside persistent class-level buffers. Transient object creation during high-frequency graph-walk scans has been completely eradicated. * **Optimized Junction & Reverse Safety:** Streamlined reverse-path tracking (myReverseLeadingEdge) and advanced filterGlobalHit per-train filtering ensure flawless deadlock resolution and collision avoidance without CPU spikes. * **Engineered for Scale:** Whether you're running 5 or 50 automated locomotives, the core loop executes with maximum efficiency, making v6 the most stable foundation for large-scale industrial rail automation. 🛠 **Technical Changelog (v7):** * **TrainScanMaps Core:** Introduced a centralized tracking structure built entirely on IdentityHashMap to eliminate duplicate lookups. * **Pre-Compute Phase:** buildScanMaps() now executes strictly before controller ticks, guaranteeing fresh, thread-safe topological data every single tick without null-pointers on startup. * **Refinement of the Core:** Cleaned up over 80+ lines of redundant nested loops in TrainAIController, replacing them with optimized global map queries wrapped in strict per-train filters (self-bypass, junction yielding, Y-level checks). 🔮 **Looking Forward:** With the global map-scan architecture fully deployed, Railway Evolution’s core is faster, smarter, and lighter than ever. Thank you for making this journey incredible! --- 🙏 THANK YOU FOR 6550 DOWNLOADS! / СПАСИБО ЗА 6 550 СКАЧИВАНИЙ!

# 🚂 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: | Command | Description | | :--- | :--- | | `/railway infinity true/false` | **Toggle unlimited limits (The Catnip Fix)** | | `/railway braking distance <5-200>` | Set obstacle detection range (Default: 50) | | `/railway braking sharpness <1-10>` | Set braking intensity (1: Smooth, 10: Aggressive) | | `/railway safe-mode true/false` | Toggle braking before players | | `/railway reload` | Rescan and update all tracked trains | | `/railway release` | Force unlock stuck trains from Yielding state | --- ### ⚠️ 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!* 🚂✨