BetterRailwaySystem

BetterRailwaySystem

BetterRailwaySystem — это мод на Fabric для Minecraft, который улучшает ванильную систему вагонеток и рельсов, не заменяя её.

Цель простая:

• сохранить полную совместимость с ванильными рельсами, энергорельсами, рельсами-детекторами, активирующими рельсами и поведением Redstone
• улучшить движение вагонеток, управление ими, работу со станциями и управление линиями
• не вводить отдельную железнодорожную систему вроде MTR

Текущий охват

Этот мод построен вокруг ванильной сущности вагонетки и ванильной рельсовой сети.

Реализованные области:

• улучшенная физика и управление ванильной вагонеткой
• рабочие железнодорожные блоки для спавна, остановки, сбора и объявлений
• запись линий в мире и визуализация карты линий
• внутриигровая конфигурация, команды и управление ресурсами бализ

Возможности

Поведение вагонетки

• плавное ускорение на энергорельсах вместо мгновенного набора максимальной скорости
• плавное замедление на отключённых энергорельсах вместо мгновенной жёсткой остановки
• настраиваемые maxSpeed, acceleration и deceleration в блоках в секунду
• настраиваемая безопасная дистанция следования для автоматического торможения позади вагонетки на том же пути
• автоматическое восстановление и повторное ускорение после временной блокировки или отскока
• движение по рельсам на высокой скорости с подшагами для лучшей устойчивости на поворотах и уклонах
• настройка движения по уклонам и на высокой скорости с упором на сохранение импульса на ванильных рельсах
• загрузка чанков вагонеткой, пока поезд движется
• автоудаление вагонетки без пассажиров по истечении настраиваемого времени
• отключено столкновение и толкание вагонеткой сущностей для уменьшения заторов
• ванильный звук трения вагонетки о рельсы приглушён почти до неслышимости

Вагонетка для нескольких пассажиров

• одна вагонетка по умолчанию вмещает до 24 игроков
• все игроки используют одну и ту же ванильную сущность вагонетки
• каждый игрок сохраняет обычный локальный вид от первого и третьего лица
• другие пассажиры в той же вагонетке скрыты, чтобы модели игроков не накладывались
• ванильный процесс высадки сохранён

Железнодорожная бализа

Блок railway_balise — это триггерный блок у рельсов для рабочих событий.

Поддерживаемые режимы бализы:

• arrival
• departure
• announcement
• speed_limit_start
• speed_limit_end

Поведение бализы включает:

• отправку заголовка и подзаголовка только текущим пассажирам вагонетки
• воспроизведение пользовательского звука только пассажирам вагонетки
• показ пользовательского изображения HUD только пассажирам вагонетки
• опциональное сохранение изображения до следующей бализы или до выхода игрока из вагонетки
• обновление состояния текущей и следующей станции
• опциональное обновление боссбара для пассажиров на борту
• временные ограничения скорости на линии с настраиваемыми маркерами начала и конца ограничения

Стоп-рельсы

Блок stop_rail работает как блок управления остановкой у рельсов для точной остановки на станции.

Поддерживаемое поведение:

• настраиваемая дистанция остановки
• настраиваемое время стоянки
• режимы ожидания: immediate, timer, redstone
• автоматический перезапуск после освобождения, включая короткий толчок для разгона, чтобы вагонетка не застревала

Спавнер поездов

Блок train_spawner может автоматически создавать вагонетки на существующих ванильных рельсах.

Поддерживаемые настройки:

• название города
• id линии
• цвет темы линии
• направление спавна
• отправка по интервалу
• отправка по сигналу Redstone
• флаг кольцевой линии

Поведение спавнера:

• спавнит только если на блоке или над ним есть подходящие рельсы
• отказывается спавнить, если область спавна уже занята другой вагонеткой
• автоматически запускает вагонетку в настроенном или определённом направлении рельсов
• привязывает заспавненные вагонетки к городу, линии, цвету, записи маршрута и состоянию кольцевой линии
• принудительно удерживает чанк спавнера загруженным

Train Collector

Блок train_collector служит точкой возврата в конце пути.

Поддерживаемое поведение:

• удаляет вагонетку, когда она достигает коллектора
• записывает посещённые станции в сохранённую карту железнодорожной линии перед удалением поезда
• сохраняет цвет линии и координаты станций вместе с порядком станций

Railway Map and Line Map

Мод включает как бортовые карты линий, так и виды мировой карты железных дорог.

Поддерживаемое поведение:

• открытие карты клавишей ` / ~
• открытие карты текущей линии во время поездки
• открытие мировой карты железных дорог вне поездки
• группировка линий по городам
• объединение пересадок по совпадающему названию станции в пределах одного города
• цвета тем линий отображаются на карте и в боссбаре
• поиск станций
• масштабирование колёсиком мыши
• навигация перетаскиванием
• всплывающая подсказка станции с названием, городом, списком линий и сохранёнными координатами
• легенды по каждому городу для определения цвета линии
• действия очистки карты железных дорог: все данные, один город или одна линия — из экрана конфигурации

Bossbar and Line Theme

• боссбар текущей и следующей станции для пассажиров на борту
• цвет боссбара следует цвету темы линии
• цвет темы линии также используется в сохранённых данных линии и при отрисовке карты

Balise Asset Library

Пользовательские медиафайлы балез можно управлять через игровой интерфейс библиотеки.

Поддерживаемое поведение:

• библиотека изображений
• библиотека звуков
• загрузка новых изображений .png и звуков .ogg
• предпросмотр медиа по клику
• выбор идентификатора медиа прямо в редакторе балез
• автоматическая генерация и перезагрузка локального ресурспака для загруженных ресурсов

Configuration

Доступные значения конфигурации включают:

• maxSpeed
• acceleration
• deceleration
• safeFollowingDistance
• maxPassengers
• stopRailApproachDistance
• unattendedDespawnSeconds

Конфигурация доступна через:

• игровой экран конфигурации
• команды: /betterrailwaysystem config show, /betterrailwaysystem config reload, `/betterrailwaysystem config set `

Environment

• Minecraft 1.21.1
• Fabric Loader
• Fabric API
• Yarn mappings
• Java 21

Development

Основные команды:

./gradlew build
./gradlew runClient

Project Structure

Структура исходников:

• src/main/java/org/dcstudio/minecart — логика работы вагонеток
• src/main/java/org/dcstudio/renderer — клиентский интерфейс и отрисовка оверлеев
• src/main/java/org/dcstudio/network — клиент-серверные пакеты и синхронизация
• src/main/java/org/dcstudio/station — логика железнодорожных блоков и блок-энтити
• src/main/java/org/dcstudio/config — конфигурация и обработка команд

Notes

• ID мода — betterrailwaysystem.
• Всё пользовательское поведение построено вокруг ванильных рельсов, а не вместо них.
• Мод сохраняет совместимость с ванильными ускоряющими рельсами, рельсами-детекторами, активирующими рельсами и обычными рельсами.
• Работа поездов, события станций и запись карты — всё построено поверх ванильных вагонеток.

License

Этот репозиторий распространяется под лицензией GPL-3.0. См. LICENSE.

Автор 3D-модели в иконке: Mareon, khj008008