diff --git a/RAILWAY_SYSTEM.md b/RAILWAY_SYSTEM.md new file mode 100644 index 000000000..fc097b781 --- /dev/null +++ b/RAILWAY_SYSTEM.md @@ -0,0 +1,427 @@ +# 🚂 **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!**