# 🚂 Western Railway Dispatch (VORP / RedM)
A professional railroad announcement system for RedM using VORP Core.
---
# 🇩🇪 Deutsch
## 📋 Beschreibung
Western Railway Dispatch ist ein immersives Railroad-Ankündigungssystem für RedM.
Bahnmitarbeiter mit dem Job **railroad** können über ein modernes NUI-Interface Zugmeldungen an Spieler in ihrer Umgebung senden.
---
## ✨ Features
- 🎛️ Western Railway NUI Interface
- 🚉 Bahnhofsauswahl per Button
- 📢 Ankunft-Meldungen
- 🚂 Abfahrt-Meldungen
- ⚠️ Zug nähert sich-Meldungen
- ⏰ Optionale Zeitangabe
- 🔔 Individuelle Ingame-Notifications
- 📡 Discord Webhook Integration
- 🖼️ Logo in NUI & Notifications
- 🌍 Mehrsprachigkeit (DE / EN)
- 👨✈️ Jobgebunden (railroad)
- 📍 Distanzbasiertes Notify-System
- 🎨 Western Railway Design
---
## 🔔 Notify Reichweite
Das Script verwendet ein Distanzsystem.
Standard:
```lua
Config.NotifyDistance = 150.0
```
Nur Spieler innerhalb von 150 Metern erhalten die Benachrichtigung.
---
## ⚙️ Installation
### 1. Resource installieren
Ordner nach:
```text
resources/[railroad]/khalis_railroad_announce
```
kopieren.
---
### 2. server.cfg
```cfg
ensure khalis_railroad_announce
```
---
### 3. Job anpassen
In der config:
```lua
Config.Job = "railroad"
```
---
### 4. Discord Webhook
```lua
Config.Webhook.Enabled = true
Config.Webhook.URL = "DEIN_WEBHOOK"
```
---
## 🎮 Nutzung
Command:
```text
/railannounce
```
---
## 📖 Bedienung
1. Command ausführen
2. Bahnhof auswählen
3. Meldungstyp auswählen
4. Zeit optional eingeben
5. Senden drücken
Das NUI schließt sich anschließend automatisch.
---
## 📢 Meldungstypen
### Ankunft
```text
Ankunft in Valentine | 19:00
```
### Abfahrt
```text
Abfahrt von Saint Denis | 19:15
```
### Annäherung
```text
Zug nähert sich Rhodes
```
---
## 🌍 Sprachen
Unterstützt:
- Deutsch
- Englisch
Konfiguration:
```lua
Config.Language = "DE"
```
oder
```lua
Config.Language = "EN"
```
---
## 🔧 Voraussetzungen
- RedM
- VORP Core
- Discord Webhook (optional)
---
# 🇬🇧 English
## 📋 Description
Western Railway Dispatch is an immersive railroad announcement system for RedM.
Players with the **railroad** job can send train announcements through a modern NUI interface.
---
## ✨ Features
- 🎛️ Western Railway NUI Interface
- 🚉 Station selection buttons
- 📢 Arrival announcements
- 🚂 Departure announcements
- ⚠️ Train approaching announcements
- ⏰ Optional time input
- 🔔 Custom in-game notifications
- 📡 Discord webhook integration
- 🖼️ Logo in NUI & notifications
- 🌍 Multi-language support (DE / EN)
- 👨✈️ Job restricted (railroad)
- 📍 Distance-based notification system
- 🎨 Western Railway design
---
## 🔔 Notification Range
The script uses a distance-based system.
Default:
```lua
Config.NotifyDistance = 150.0
```
Only players within 150 meters will receive announcements.
---
## ⚙️ Installation
### 1. Install Resource
Place the folder into:
```text
resources/[railroad]/khalis_railroad_announce
```
---
### 2. server.cfg
```cfg
ensure khalis_railroad_announce
```
---
### 3. Configure Job
```lua
Config.Job = "railroad"
```
---
### 4. Discord Webhook
```lua
Config.Webhook.Enabled = true
Config.Webhook.URL = "YOUR_WEBHOOK"
```
---
## 🎮 Usage
Command:
```text
/railannounce
```
---
## 📖 How To Use
1. Open the menu
2. Select station
3. Select announcement type
4. Optional time input
5. Press send
The UI closes automatically afterwards.
---
## 📢 Announcement Types
### Arrival
```text
Arrival at Valentine | 19:00
```
### Departure
```text
Departure from Saint Denis | 19:15
```
### Approaching
```text
Train approaching Rhodes
```
---
## 🌍 Languages
Supported:
- German
- English
Configuration:
```lua
Config.Language = "DE"
```
or
```lua
Config.Language = "EN"
```
---
## 🔧 Requirements
- RedM
- VORP Core
- Discord Webhook (optional)
