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!