novafarma/docs/RAILWAY_SYSTEM.md

# 🚂 **RAILWAY RESTORATION SYSTEM - Slovenian Train Network**

## 🛤️ **RAILWAY OVERVIEW:**

### **PRE-EXISTING INFRASTRUCTURE:**
✅ Railway tracks **ALREADY BUILT** across Slovenia!
✅ 27 train stations (1 per town!)
✅ Abandoned, rusted, overgrown with vegetation
✅ Zombies lurking in old carriages
✅ **NO BUILDING TRACKS** - Focus on restoration!

---

## 📍 **27 TRAIN STATIONS (1 Per Town):**

### **Station List:**
1. **Ljubljana Central** (Capital) - Main hub
2. **Maribor Station** - Northern hub
3. **Celje Station** - Central
4. **Kranj Station** - Alpine
5. **Novo Mesto Station** - Southeast
6. **Koper Station** - Coastal (Mediterranean)
7. **Ptuj Station** - Historic
8. **Velenje Station** - Mining town
9. **Kamnik Station** - Mountain town
10. **Postojna Station** (near caves!)
11. **Bled Station** (lake town!)
12. **Portorož Station** - Beach resort
13. **Idrija Station** - Mercury mine
14. **Škofja Loka Station** - Medieval
15. **Trbovlje Station** - Industrial
16. **Jesenice Station** - Alpine border
17. **Murska Sobota Station** - Eastern
18. **Nova Gorica Station** - Italian border
19. **Slovenj Gradec Station** - Northern
20. **Krško Station** - Nuclear plant town
21. **Brežice Station** - Croatian border
22. **Ajdovščina Station** - Wine region
23. **Radovljica Station** - Honey town
24. **Litija Station** - River town
25. **Logatec Station** - Karst
26. **Prevalje Station** - Mining
27. **Dolina Smrti Station** (Player's Base Farm hub!)

---

## 🏚️ **STATION RESTORATION MECHANIC:**

### **Station Condition States:**

**1. RUINED (Starting State):**
```
- Platform collapsed
- Station building burned/destroyed
- Tracks overgrown with weeds
- Zombies sleeping in old carriages
- No NPCs
- NO FUNCTIONALITY
```

**2. CLEARED (After zombie cleanup):**
```
✅ Kill all zombies in station area
✅ Clear debris from platform
- Still non-functional
- NPCs won't return yet
```

**3. REPAIRED (After restoration):**
```
✅ Rebuild station building (wood, stone, iron)
✅ Repair platform
✅ Install signal lights
✅ Clean tracks (remove weeds)
✅ NPCs move in! (Station Master, Ticket Clerk, etc.)
✅ FUNCTIONAL - Trains can stop here!
```

---

## 🔧 **RESTORATION REQUIREMENTS:**

### **Per Station (Average):**

**Materials Needed:**
- **Wood:** 500 units
- **Stone:** 300 units
- **Iron:** 150 units
- **Glass:** 50 units (windows)
- **Concrete:** 100 units (platform)

**Labor:**
- **Zombie Workers:** 10 workers × 3 days = Station repaired
- **OR Manual:** Player rebuilds (5 hours real-time gameplay)

**Cost:**
- **Gold:** 5,000 per station
- **Total for all 27:** 135,000 gold (endgame investment!)

---

## 🚂 **TRAIN SYSTEM:**

### **TRAINS ARE BROKEN - MUST REPAIR!**

**Train Types (5 total across network):**

1. **Steam Locomotive** 🚂
   - Old-school, coal-powered
   - Slowest (60 km/h)
   - Most common
   - **Repair:** 10,000 gold, 500 iron, 200 coal
   
2. **Diesel Train** 🚃
   - Modern, fuel-powered
   - Medium speed (100 km/h)
   - **Repair:** 15,000 gold, 300 steel, 500L diesel
   
3. **Electric Train** ⚡
   - High-speed, requires power grid
   - Fast (140 km/h)
   - **Repair:** 25,000 gold, 200 copper, 100 circuit boards
   - **Extra:** Restore power lines to stations!
   
4. **Cargo Train** 📦
   - Heavy freight hauler
   - Carries goods between towns
   - **Repair:** 20,000 gold, 800 iron, 400 steel
   
5. **Luxury Express** 🌟
   - Pre-apocalypse VIP train
   - Ultra-fast (180 km/h!)
   - Rare, only 1 in game
   - **Repair:** 50,000 gold, 500 mythril, 100 dragon scales!

---

## 🛠️ **TRAIN REPAIR PROCESS:**

### **Finding Trains:**
```
[Explore stations]
[Find abandoned train on tracks - rusted, broken]

PLAYER: "A train! If I can repair this, I can travel fast!"

[Inspect Train]
DAMAGE REPORT:
- Engine: BROKEN (needs new pistons)
- Wheels: RUSTED (need lubrication oil)
- Boiler: CRACKED (needs welding)
- Coal Tender: EMPTY (need coal supply)
- Brake System: FAILED (needs hydraulic fluid)

REPAIR COST: 10,000 gold + materials
TIME: 2 in-game days (with zombie workers)
```

### **Repair Steps:**
1. **Gather Materials** (iron, steel, coal, oil, etc.)
2. **Hire Mechanic NPC** (if station restored) OR use zombie workers
3. **Wait 2 days** (or speed up with fast-forward)
4. **Train OPERATIONAL!** ✅

---

## 🚉 **STATION BUILDING TYPES:**

### **Each Station Has (After Restoration):**

**Main Station Building:**
- **Ticket Office** - Buy train tickets (fast travel!)
- **Station Master Office** - Quest giver NPC
- **Waiting Room** - Rest, save game
- **Restaurant** - Buy food, meet NPCs
- **Luggage Storage** - Extra inventory space!

**Platform Buildings:**
- **Signal Tower** - Control train schedule
- **Maintenance Shed** - Repair trains here
- **Cargo Warehouse** - Store/trade goods
- **Passenger Shelter** - Weather protection

**NPCs (3-5 per station):**
1. **Station Master** - Manages station, gives quests
2. **Ticket Clerk** - Sells tickets, fast travel
3. **Train Mechanic** - Repairs trains (for fee)
4. **Platform Guard** - Security, zombie defense
5. **Vendor** - Sells snacks, newspapers, souvenirs

---

## 🎫 **FAST TRAVEL SYSTEM:**

### **How It Works:**

**1. Buy Ticket:**
```
[At Ticket Office]

TICKET CLERK: "Where to?"

[Map appears - shows restored stations in green]

DESTINATIONS:
- Ljubljana Central (200 gold, 10 min)
- Maribor Station (150 gold, 8 min)
- Bled Station (100 gold, 5 min)
- [27 total destinations if all restored!]

[Select destination, pay gold]
[Cutscene: Board train, scenic travel montage]
[Arrive at destination!]
```

**2. Automatic Travel:**
```
- Player boards train
- Screen fades to scenic Slovenia landscapes
- Relaxing train sounds (clickety-clack)
- Time passes (10 real seconds = 5 in-game minutes)
- Arrive refreshed! (+10 HP, +20 Stamina)
```

**3. Random Events (Small Chance):**
```
[10% chance during travel]

EVENT: ZOMBIE AMBUSH!
- Zombies on tracks!
- Train stops suddenly
- Fight zombies (3-5 enemies)
- Clear tracks, continue journey
- BONUS: Extra XP + loot!
```

---

## 🚛 **CARGO SYSTEM:**

### **Trade Between Towns via Train:**

**How It Works:**
```
[At Cargo Warehouse]

CARGO CLERK: "Shipping goods to another town?"

[Load items onto train]
- Max: 1,000 kg per trip
- Fee: 50 gold per 100 kg

[Select destination]
[24 in-game hours later = goods arrive!]

[Sell goods at destination for profit!]
Example:
- Buy wheat in Maribor (cheap farming town)
- Ship to Ljubljana (expensive capital)
- Sell for 2× profit!
```

---

## 🗺️ **RAILWAY MAP:**

### **Slovenia Railway Network:**

```
        Maribor━━━━━━━━━━Ptuj
            ┃               ┃
        Celje━━━━━━━━━Murska Sobota
            ┃
    Ljubljana━━━━━━Novo Mesto
        ┃   ┃
    Koper  Bled━━━━Jesenice
        ┃       ┃
    Portorož  Kranj━━━━Kamnik
                    ┃
            Dolina Smrti (Base Farm)
```

**Total Track Length:** ~800 km  
**Total Stations:** 27  
**Total Trains:** 5 (must repair all!)

---

## 💰 **ECONOMIC BENEFITS:**

### **Why Restore Railway?**

**1. FAST TRAVEL:**
- Save 80% travel time!
- Example: Walking Ljubljana → Maribor = 2 hours
- Train: 10 minutes!

**2. CARGO TRADING:**
- Ship goods between towns
- Profit margins: 50-200%!
- Example: Buy 100 potatoes (500 gold) → Ship → Sell (1,200 gold) = 700 profit!

**3. NPC MOVEMENT:**
- Restored stations = NPCs travel between towns!
- More quest variety
- Cross-town relationships

**4. QUESTS:**
- Station Masters give unique railway quests
- "Clear zombies from tracks"
- "Repair signal tower"
- "Find missing cargo"
- Rewards: Gold, rare items, train upgrades!

**5. ACHIEVEMENTS:**
- ✅ "Rail Baron" - Restore all 27 stations
- ✅ "Conductor" - Repair all 5 trains
- ✅ "Track Star" - Travel 1,000 km by train
- ✅ "Freight Master" - Ship 10,000 kg cargo

---

## 🎮 **GAMEPLAY INTEGRATION:**

### **Early Game (Act 1):**
- Find 1-2 nearby stations
- Restore Dolina Smrti Station (Base Farm hub)
- Repair 1 steam locomotive
- **Unlock fast travel to 2-3 towns!**

### **Mid Game (Act 2):**
- Restore 10-15 stations
- Repair diesel + electric trains
- **Cargo trading becomes profitable!**
- **Railway quests unlock!**

### **Late Game (Act 3-4):**
- Restore all 27 stations
- Repair luxury express train
- **Full railway network operational!**
- **Slovenia connected again!**

---

## 🏆 **MASTER QUEST: "Reconnect Slovenia"**

### **Objective:**
Restore entire railway network, reconnect all 27 towns via train.

**Rewards:**
- **50,000 XP**
- **Golden Conductor Uniform** (outfit)
- **Lifetime Free Train Tickets!**
- **Luxury Express Train** (fastest vehicle in game!)
- **Achievement:** "Railroad Tycoon"

---

## 🌟 **SPECIAL FEATURES:**

### **1. Scenic Routes:**
```
Bled → Jesenice (Alpine route)
- Snow-covered mountains
- Frozen lakes
- Breathtaking views!

Koper → Portorož (Coastal route)
- Mediterranean sea
- Beaches
- Sunset scenery!

Ljubljana → Postojna (Cave route)
- Karst landscape
- Cave entrances visible
- Underground rivers!
```

### **2. Train Customization:**
```
[At Mechanic]

UPGRADES:
- Speed Boost (+20%, 5,000 gold)
- Armor Plating (zombie-proof, 8,000 gold)
- Cargo Expansion (+500 kg, 3,000 gold)
- Luxury Seats (restore HP while traveling, 10,000 gold)
- Horn Upgrade (custom sounds!, 500 gold)
```

### **3. Railway Events:**
```
- "Derailment!" - Find crashed train, rescue survivors
- "Trackside Party" - NPCs throw celebration at station
- "Express Delivery" - Timed cargo mission (bonus gold!)
- "Ghost Train" - Spooky night event (Halloween special!)
```

---

## ✅ **SUMMARY:**

**What Player Does:**
1. Find abandoned stations (27 total)
2. Clear zombies
3. Repair station buildings (NPCs move in!)
4. Find broken trains (5 total)
5. Repair trains (materials + gold)
6. **USE RAILWAY FOR FAST TRAVEL!**
7. Ship cargo for profit
8. Complete railway quests
9. **RECONNECT SLOVENIA!**

**What Player DOESN'T Do:**
❌ Build tracks from scratch (already exist!)
❌ Lay rails manually (too tedious!)
❌ Design routes (pre-set network!)

**Focus:**
✅ Restoration (not construction!)
✅ Repair (trains + stations!)
✅ Economic gameplay (cargo trading!)
✅ NPC revival (bring life back to stations!)

---

**🚂 RAILWAY = POST-APOCALYPTIC REBIRTH OF CIVILIZATION!**