# mack-railroad-v6 — Railroad Company Management System (Now includes Ambient Trains and Train Tickets for Both)

Advanced train management system for RedM (rsg-core). Buy railroad companies, hire drivers, manage trains, run missions, and build a railroad empire.

Video Link : https://medal.tv/games/red-dead-2/clips/mH7R19aCUjcA0im8K?invite=cr-MSxlZWgsMTkxMDIwMzU5

## Features

### 🏢 Company Ownership

- **Buy a Railroad Company** — 4 companies available across the map ($50,000 each, configurable)

- **Rename Your Company** — Custom company names shown on UI

- **Cash Register** — Mission earnings split between driver and company fund

- **Withdraw Funds** — Owner can withdraw from the company cash register

- **Sell Company** — Sell back with refund + remaining cash register balance

### 👥 Employee System

- **Apply as Driver** — Players apply at any company station

- **Approve / Reject** — Owner reviews applications from the management panel

- **Fire Drivers** — Remove underperforming employees

- **Real-time Notifications** — Driver gets notified when approved/rejected/fired

- **Owner gets notified** when a new application is submitted

### 🚆 Train Fleet

- **30+ Preconfigured Trains** — Across 4 companies (Lemoyne Central, Heartlands Express, Cumberland & Western, New Austin Rail Co.)

- **Rank-Gated Access** — Drivers earn XP to unlock better trains (Brakeman → Foreman)

- **Deploy at Any Station** — Forward or reverse direction

- **Trains Start at 50%** fuel, water, and condition

### 🎮 Train Controls

- **Native RDR3 Controls** — L SHIFT accelerate, L CTRL brake/reverse, Left Mouse bell, G whistle

- **Cruise Control** — R for forward cruise, B for reverse. Train maintains speed hands-free

- **Cruise Continues When Leaving Seat** — Set cruise and walk around while the train moves

- **Emergency Brake** — X key for gradual stop

- **Track Switching** — Q key toggles between main and alternate routes

- **Engine Toggle** — via ox_target menu on the train

### 📋 Train HUD

- **Mini Clipboard UI** — Matches the station menu style, positioned top-left

- **Live Gauges** — Speed, fuel, water, condition with colored bars

- **Status Info** — Engine, cruise, junction, nearest station

- **Mission Tracker** — Shows active mission type and destination

- **Toggle with [ key** — Hide/show the HUD while driving

### 🔧 Train Maintenance (ox_target)

- **Add Coal** (+10% fuel per coal item, with shoveling animation)

- **Fill Water** (+10% per fullbucket item, with pouring animation)

- **Oil & Repair** (+10% condition per oilcan item, with repair animation)

- **Check Condition** — ox_lib context menu showing all stats with visual bars

- **Start/Stop Engine** — Toggle engine from outside the train

- **Send to Yard** — Despawn train, saves state

### 📦 Missions

- **Cargo Delivery** — Transport goods between stations with blip guidance

- **Passenger Transport** — Board NPCs and deliver to destination

- **Rail Maintenance** — Travel to repair locations with progress bar

- **Distance Notifications** — "Approaching destination", "You have arrived"

- **Pay Split** — 50/50 between driver and company (configurable)

- **Rank Pay Bonus** — Higher rank = better pay multiplier

### 🏪 Company Supply Store

- **Owner Stocks Supplies** — Add coal, fullbucket, oilcan from personal inventory

- **Drivers Take for Free** — Employees access supplies at any company station

- **Per-Company Isolation** — Company A supplies are separate from Company B

- **Stock Tracking** — Owner sees current quantities

### 📊 Progression System

- **5 Ranks** — Brakeman → Fireman → Engineer → Conductor → Foreman

- **XP from Missions** — Complete deliveries to level up

- **Rank-Up Rewards** — Cash bonuses on promotion

- **Railwayman Milestones** — Personal achievement rewards

### 🔔 All Notifications via bln_notify

- Consistent notification style across all actions

### 🌍 Full Configuration

- Company purchase price, mission pay split, fuel/water/condition rates

- Train speeds, costs, ranks, upgrade tiers

- Station locations, delivery destinations, mission types

- All configurable in a single `config.lua`

---

## Dependencies

- [rsg-core](https://github.com/Rexshack-RedM/rsg-core)

- [ox_lib](https://github.com/overextended/ox_lib)

- [ox_target](https://github.com/overextended/ox_target)

- [bln_notify](https://github.com/BLN-Studio/bln_notify)

- [oxmysql](https://github.com/overextended/oxmysql)

---