# 📌ENG:
# 🚆 RailWorks
RailWorks is a Minecraft plugin that adds a complete railway system with **stations, tickets, locomotives, routes, and economy integration**.
Perfect for survival servers, roleplay projects, or any server that needs an immersive public transport system.
---
## ✨ Features
* 🛤 **Stations**: Create train stations with bells + droppers, set waiting time, and manage passengers.
* 🎟 **Tickets**: Buy, validate, and use tickets for traveling. Supports one-time or reusable tickets.
* 🚂 **Trains**: Furnace minecarts act as locomotives, with automatic or manual coupling of wagons.
* 🗺 **Routes**: Assign cyclical routes to locomotives for automated travel between stations.
* ⚙️ **Customizable Settings**: Adjust ticket prices, currency, stop duration, train speed, and more.
* 💰 **Economy Support**: Fully integrates with Vault (money-based) or uses item-based station currency.
---
## 📜 Commands
| Command | Description |
| ----------------------------------------- | ------------------------------------------------ |
| `/train station create ` | Create a station (links nearest bell + dropper). |
| `/train station setwait ` | Set station stop duration. |
| `/train station delete ` | Remove a station. |
| `/train ticket ` | Buy a ticket to a station. |
| `/train loco` | Spawn a locomotive. |
| `/train removeloco` | Remove nearest locomotive. |
| `/train start` / `/train stop` | Start or stop a train. |
| `/train speed <1-5>` | Change train speed. |
| `/train route add ...` | Assign a route to the nearest locomotive. |
| `/train route create ...` | Save a named route. |
| `/train route assign ` | Assign a saved route. |
| `/train route list` | Show all saved routes. |
| `/train settings` | Open GUI to manage station & ticket settings. |
---
## ⚙️ Configuration (`config.yml`)
* `ticket.mode` → `ONE_TIME` or `REUSABLE`
* `ticket.fine-enabled` → Enables fines for players without valid tickets
* `ticket.fine-amount` → Fine amount (Vault only)
* `ticket.knockback.horizontal / vertical` → Pushback strength when boarding without ticket
* `stations.default-radius`, `stations.default-wait` → Default station settings
* `trains.default-speed`, `trains.max-speed`, `trains.unload-radius` → Train behavior
* `lang` → Plugin language
---
## 📦 Dependencies
* ✅ **Vault** (optional, for money-based economy)
* Without Vault → item-based station currency is used
---
## 📝 Permissions
(You can define them in `plugin.yml` or leave defaults)
* `railworks.admin` → Manage stations, routes, locomotives
* `railworks.use` → Use tickets, board trains
---
## 🚀 Installation
1. Download the latest release from Modrinth.
2. Place the `.jar` file into your server’s `plugins` folder.
3. Restart your server.
4. Configure settings in `config.yml` if needed.
---
👉 With **RailWorks**, you can turn Minecraft minecarts into a **full public railway system**: complete with stations, tickets, routes, and economy integration.
---
# 📌RU:
# 🚆 RailWorks
RailWorks — это плагин для Minecraft, который добавляет полноценную железнодорожную систему с **станциями, билетами, локомотивами, маршрутами и интеграцией с экономикой**.
Идеально подходит для выживания, ролевых проектов или любых серверов, где нужен продуманный общественный транспорт.
---
## ✨ Возможности
* 🛤 **Станции**: Создавайте станции с колоколами и дропперами, задавайте время остановки и управляйте пассажирами.
* 🎟 **Билеты**: Покупайте, проверяйте и используйте билеты для поездок. Поддержка одноразовых и многоразовых билетов.
* 🚂 **Поезда**: Вагонетки с печкой работают как локомотивы, поддерживается автоматическая или ручная сцепка вагонов.
* 🗺 **Маршруты**: Назначайте циклические маршруты локомотивам для автоматического перемещения между станциями.
* ⚙️ **Гибкие настройки**: Настройка цен на билеты, валюты, времени стоянки, скорости поездов и других параметров.
* 💰 **Экономика**: Полная поддержка Vault (денежная экономика) или использование предметов как валюты станции.
---
## 📜 Команды
| Команда | Описание |
| ----------------------------------------- | ---------------------------------------------------------- |
| `/train station create ` | Создать станцию (привязывает ближайший колокол и дроппер). |
| `/train station setwait ` | Установить время стоянки на станции. |
| `/train station delete ` | Удалить станцию. |
| `/train ticket ` | Купить билет до станции. |
| `/train loco` | Создать локомотив. |
| `/train removeloco` | Удалить ближайший локомотив. |
| `/train start` / `/train stop` | Запустить или остановить поезд. |
| `/train speed <1-5>` | Изменить скорость поезда. |
| `/train route add ...` | Назначить маршрут ближайшему локомотиву. |
| `/train route create ...` | Создать и сохранить маршрут. |
| `/train route assign ` | Назначить сохранённый маршрут. |
| `/train route list` | Показать список сохранённых маршрутов. |
| `/train settings` | Открыть GUI для управления настройками станции и билетов. |
---
## ⚙️ Конфигурация (`config.yml`)
* `ticket.mode` → `ONE_TIME` или `REUSABLE`
* `ticket.fine-enabled` → Включить штрафы для игроков без билетов
* `ticket.fine-amount` → Размер штрафа (только при Vault)
* `ticket.knockback.horizontal / vertical` → Сила отталкивания при посадке без билета
* `stations.default-radius`, `stations.default-wait` → Настройки станций по умолчанию
* `trains.default-speed`, `trains.max-speed`, `trains.unload-radius` → Поведение поездов
* `lang` → Язык плагина
---
## 📦 Зависимости
* ✅ **Vault** (опционально, для денежной экономики)
* Без Vault → используется предметная валюта станции
---
## 📝 Права (Permissions)
(Можно указать в `plugin.yml` или оставить стандартные)
* `railworks.admin` → Управление станциями, маршрутами и локомотивами
* `railworks.use` → Использование билетов и посадка в поезда
---
## 🚀 Установка
1. Скачайте последнюю версию с Modrinth.
2. Поместите `.jar` файл в папку `plugins` вашего сервера.
3. Перезапустите сервер.
4. При необходимости настройте параметры в `config.yml`.
---
👉 С **RailWorks** вы превратите вагонетки Minecraft в **настоящую систему общественного транспорта**: со станциями, билетами, маршрутами и интеграцией с экономикой.
---