diff --git a/BIOME_PLACEMENT_TRAVEL_SYSTEM.md b/BIOME_PLACEMENT_TRAVEL_SYSTEM.md new file mode 100644 index 000000000..2c775c18e --- /dev/null +++ b/BIOME_PLACEMENT_TRAVEL_SYSTEM.md @@ -0,0 +1,494 @@ +# ๐Ÿ—บ๏ธ **BIOME PLACEMENT & TRAVEL SYSTEM - No Instant Access!** + +## ๐ŸŒ **WORLD MAP: SLOVENIA + ANOMALOUS ZONES** + +### **MAP LAYOUT (Scattered, NOT Clustered!):** + +``` + โ•”โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•— + โ•‘ SLOVENIA - POST-APOCALYPSE โ•‘ + โ•šโ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ• + +NORTH (Alps): +- ๐Ÿ”๏ธ Mythical Highlands (mountain peaks) +- โ„๏ธ Arctic Zone (frozen north) +- ๐Ÿฐ Medieval Castle (fortress ruins) + +NORTHEAST: +- ๐ŸŒฒ Endless Forest (deep woods, 50km from Dolina Smrti) +- ๐Ÿบ Werewolf territory +- ๐Ÿฆ Bigfoot sightings + +EAST: +- โ˜ข๏ธ CHERNOBYL (border region, 150km away!) +- ๐Ÿญ Steampunk City (industrial ruins) +- ๐Ÿš‚ Railway hub + +SOUTHEAST: +- ๐Ÿœ๏ธ Egyptian Desert (anomaly portal, 80km) +- ๐Ÿฆ• Dino Valley (southern valley, 60km) + +SOUTH: +- ๐Ÿ–๏ธ Mediterranean Coast +- ๐Ÿดโ€โ˜ ๏ธ Pirate Cove (coastal) +- ๐ŸŒŠ Atlantis (underwater, offshore!) + +SOUTHWEST: +- ๐Ÿ‡ฒ๐Ÿ‡ฝ Mexican Cenotes (cave system, 70km) +- ๐ŸŒ‹ Volcanic Hellscape (geothermal area) + +WEST: +- ๐Ÿง™ Witch Forest (dark woods, 45km) +- ๐Ÿค  Wild West (ghost town, 90km) +- ๐Ÿด๓ ง๓ ข๓ ณ๓ ฃ๓ ด๓ ฟ Loch Ness (lake region, 120km!) + +CENTRAL: +- ๐Ÿก DOLINA SMRTI (Base Farm) โ† STARTING POINT! +- ๐Ÿ™๏ธ Ljubljana (Town Square, 10km) +- ๐Ÿ„ Mushroom Forest (nearby, 25km) + +SCATTERED (No Fixed Direction): +- ๐Ÿ‘ป Haunted Asylum (random location) +- ๐Ÿญ Candy Kingdom (hidden portal) +- ๐ŸŒƒ Cyberpunk Ruins (city outskirts) +- ๐ŸŒบ Enchanted Garden (forest clearing) +- ๐Ÿ‘ฝ Alien Crash Site (random) +``` + +**KEY DESIGN:** +- Biomes are 25-150km apart! +- NOT all clustered together! +- Must TRAVEL to reach! +- Creates exploration journey! + +--- + +## ๐Ÿšซ **TRAVEL RESTRICTIONS: Must Discover First!** + +### **THE RULE:** + +``` +โŒ CANNOT fast travel to undiscovered biomes! +โŒ CANNOT use train to undiscovered stations! +โœ… MUST physically travel there FIRST TIME! +โœ… THEN unlock fast travel! +``` + +--- + +### **HOW IT WORKS:** + +**Example: Endless Forest (50km away)** + +**FIRST TIME:** +``` +PLAYER: "I want to go to Endless Forest." + +[Opens map] +[Endless Forest = GRAYED OUT, "???" label] + +SYSTEM: "Location not discovered. You must travel there first." + +[Player MUST:] +1. Choose transport (scooter, horse, etc.) +2. Physically travel 50km +3. Find biome entrance +4. DISCOVER IT! + +[After discovery:] +โœ… Endless Forest now visible on map! +โœ… Can fast travel via train! +โœ… Can teleport (if built portal!) +``` + +**SECOND TIME:** +``` +[Opens map] +[Endless Forest = COLORED, labeled clearly] + +OPTIONS: +- [Fast Travel] - Train (if station restored!) โ†’ 5 min +- [Teleport] - Portal (if built!) โ†’ Instant! +- [Travel Manually] - Still an option! +``` + +--- + +### **DISCOVERY PROGRESSION:** + +**Early Game (Zone 1-5 discovered):** +- Dolina Smrti โœ… (starting zone) +- Ljubljana โœ… (10km, easy walk) +- Mushroom Forest โœ… (25km, scooter trip) +- Dino Valley (60km, must travel!) +- Endless Forest (50km, must travel!) + +**Mid Game (Zone 6-15 discovered):** +- Player explores Slovenia +- Discovers more biomes via travel +- Unlocks train stations +- Builds portals + +**Late Game (All 20 zones discovered!):** +- Full map revealed! +- Fast travel everywhere! +- World feels conquered! + +--- + +## ๐Ÿ›ด **PERSONAL TRANSPORT (Before Discovery!)** + +### **GROUND VEHICLES (Non-Motorized):** + +**1. WALK** ๐Ÿšถ +``` +Speed: 5 km/h (base) +Cost: FREE! +Stamina: Drains slowly +Range: Unlimited (but tiring!) +``` + +**2. SKATEBOARD** ๐Ÿ›น +``` +Speed: 15 km/h +Cost: 100 gold (buy OR craft) +Stamina: No drain! +Range: Unlimited +Terrain: Roads only (not off-road!) + +Craft: +- 1 Plank (wood) +- 4 Wheels (craft from iron + rubber) +``` + +**3. LONGBOARD** ๐Ÿ›น๐Ÿ›น +``` +Speed: 20 km/h +Cost: 250 gold +Stamina: No drain +Range: Unlimited +Terrain: Roads + smooth dirt + +Craft: +- 2 Planks +- 4 Wheels (upgraded) +- 1 Grip Tape +``` + +**4. KICK SCOOTER (Rolka)** ๐Ÿ›ด +``` +Speed: 25 km/h +Cost: 300 gold +Stamina: Minimal drain +Range: Unlimited +Terrain: Roads + paths + +Craft: +- 1 Metal Bar (iron) +- 2 Wheels +- 1 Handle (wood) +``` + +**5. ELECTRIC SCOOTER** ๐Ÿ›ดโšก +``` +Speed: 40 km/h! +Cost: 1,500 gold +Battery: Lasts 100km, rechargeable! +Range: 100km per charge +Terrain: Roads + dirt + +Craft: +- 1 Kick Scooter +- 1 Battery (rare!) +- 1 Electric Motor +- (Unlock: Steampunk City OR Cyberpunk Ruins!) +``` + +**6. HOVERBOARD** ๐Ÿ›นโœจ +``` +Speed: 50 km/h!!! +Cost: 5,000 gold (RARE!) +Power: Magic-powered! +Range: Unlimited! +Terrain: ALL (flies 20cm above ground!) + +Craft: +- 1 Mythril Board +- 2 Levitation Crystals +- 1 Magic Core +- (Unlock: Mythical Highlands!) +``` + +--- + +### **ANIMAL MOUNTS (Rideable):** + +**7. HORSE** ๐Ÿด +``` +Speed: 35 km/h +Cost: 5,000 gold (buy from monthly market) +Stamina: Depletes, must rest! +Range: 50km before rest needed +Terrain: Roads + fields + light forest + +Care: +- Feed daily (hay, carrots) +- Water +- Brush (happiness) +``` + +**8. DONKEY (Osel)** ๐Ÿซ +``` +Speed: 20 km/h (slow but steady!) +Cost: 2,000 gold +Stamina: High! (doesn't tire easily) +Range: 100km before rest! +Terrain: Mountains, rough terrain! + +Special: +- Can carry 2ร— cargo! (500kg!) +- Doesn't spook at zombies! +``` + +**9. MULE (Mula - Horse + Donkey Hybrid!)** ๐Ÿด๐Ÿซ +``` +Speed: 30 km/h +Cost: CANNOT BUY! Must breed! +Stamina: BEST! (rarely tires!) +Range: 150km before rest!!! +Terrain: ALL terrain master! + +Breeding: +1. Own 1 Horse (male OR female) +2. Own 1 Donkey (opposite gender!) +3. Build Breeding Stable +4. Wait 11 months (in-game) +5. MULE BORN! ๐ŸŽ‰ + +Special: +- Carries 3ร— cargo! (750kg!) +- Never spooks! +- Lives longest (30 in-game years!) +- BEST all-purpose mount! + +Note: Mules are sterile (can't breed more mules!) +``` + +**10. DINOSAUR MOUNT (Raptor)** ๐Ÿฆ– +``` +Speed: 60 km/h!!! (FASTEST animal!) +Cost: 10,000 gold (Dino Valley) +Stamina: Medium +Range: 80km +Terrain: All ground terrain + +Special: +- ATTACKS zombies while riding! (+30 dmg!) +- Intimidates enemies! +- Requires meat daily (expensive!) + +Unlock: Dino Valley discovered + quest! +``` + +--- + +## ๐Ÿ—บ๏ธ **TRAVEL EXAMPLE: Dolina Smrti โ†’ Chernobyl (150km)** + +### **SCENARIO: First Time (Not Discovered Yet!)** + +``` +PLAYER: "I want to go to Chernobyl." + +[Opens Map] +SYSTEM: "Chernobyl: ??? - Not discovered. Distance: ~150km NE." + +[Player chooses transport:] + +OPTION A: WALK ๐Ÿšถ +- Speed: 5 km/h +- Time: 30 HOURS (real-time: 30 minutes of walking!) +- Risk: Zombie encounters every 5km! +- Stamina: DRAINS! (need food/rest!) +- VERDICT: TOO SLOW! โŒ + +OPTION B: ELECTRIC SCOOTER ๐Ÿ›ดโšก +- Speed: 40 km/h +- Time: 3.75 hours (real-time: ~4 minutes!) +- Battery: 100km range โ†’ NEED RECHARGE HALFWAY! (find power source!) +- Risk: Moderate +- VERDICT: Doable but risky! โš ๏ธ + +OPTION C: HORSE ๐Ÿด +- Speed: 35 km/h +- Time: 4.3 hours (real-time: ~5 minutes!) +- Stamina: Need to rest 3ร— during journey! +- Risk: Moderate +- VERDICT: Classic choice! โœ… + +OPTION D: MULE ๐Ÿด๐Ÿซ +- Speed: 30 km/h +- Time: 5 hours (real-time: ~5 minutes) +- Stamina: Only 1 rest needed! +- Risk: Low (mule doesn't spook!) +- Cargo: Bring supplies! +- VERDICT: BEST for long journey! โœ…โœ…โœ… + +OPTION E: DINO RAPTOR ๐Ÿฆ– +- Speed: 60 km/h (FASTEST!) +- Time: 2.5 hours (real-time: ~3 minutes!) +- Stamina: 2 rests +- Risk: LOW (raptor kills zombies!) +- VERDICT: BEST if you have one! โœ…โœ…โœ… + +[Player picks MULE] + +[JOURNEY BEGINS:] +- Hour 1: Traveling through fields... [encounters 5 zombies, fights!] +- Hour 2: Passing through small town... [loot opportunity!] +- Hour 3: REST STOP - Feed mule, drink water +- Hour 4: Entering radioactive zone... [Geiger counter beeping!] +- Hour 5: ARRIVED! Chernobyl entrance visible! + +[DISCOVERY!] +๐ŸŽ‰ **CHERNOBYL DISCOVERED!** +- Added to map! +- Can now fast travel! (if train station restored) +- Can build portal! (if unlocked portal tech) +``` + +--- + +### **SECOND TIME: Fast Travel Available!** + +``` +[Opens Map โ†’ Chernobyl] + +OPTIONS NOW: +1. [Train] - 10 minutes (if station restored!) โ†’ 200 gold +2. [Portal] - INSTANT! (if portal built!) โ†’ Free! +3. [Manual Travel] - Still available! โ†’ Various methods + +[Player chooses Train] + +[Cutscene: Board train at Dolina Smrti station] +[Scenic travel montage] +[Arrive at Chernobyl station!] + +TOTAL TIME: 10 seconds (instead of 5 minutes!) +``` + +--- + +## ๐ŸŽฎ **GAMEPLAY INTEGRATION:** + +### **PROGRESSION:** + +**Week 1:** +- Walk/skateboard to nearby zones (10-25km) +- Discover: Ljubljana, Mushroom Forest, Dino Valley + +**Week 2-3:** +- Buy horse OR craft scooter +- Travel to mid-distance zones (50-80km) +- Discover: Endless Forest, Egyptian Desert, Witch Forest + +**Week 4-8:** +- Buy/breed MULE (best mount!) +- Restore train stations +- Travel to far zones (90-150km!) +- Discover: Chernobyl, Loch Ness, Wild West + +**Week 9+:** +- Build portals (instant travel!) +- All 20 zones discovered! +- Fast travel everywhere! +- Use mounts for fun/exploration still! + +--- + +## ๐Ÿ”“ **UNLOCK SUMMARY:** + +**START:** +- โœ… Walk anywhere +- โœ… Skateboard/scooter (craftable!) + +**EARLY:** +- โœ… Buy horse (5,000g) +- โœ… Buy donkey (2,000g) + +**MID:** +- โœ… Breed MULE! (horse + donkey) +- โœ… Restore train stations โ†’ Fast travel! + +**LATE:** +- โœ… Build portals โ†’ Instant travel! +- โœ… Buy dino raptor (prestige mount!) +- โœ… Craft hoverboard (magic!) + +--- + +## ๐Ÿด๐Ÿซ **MULE BREEDING GUIDE:** + +### **STEP-BY-STEP:** + +``` +1. BUY HORSE (male or female) - 5,000g, monthly market +2. BUY DONKEY (opposite gender!) - 2,000g, monthly market + +Example: +- Male Horse + Female Donkey = Mule! +- OR Female Horse + Male Donkey = Mule! + +3. BUILD BREEDING STABLE: + - 500 wood + - 300 stone + - 200 hay + - Cost: 1,000g + +4. PLACE BOTH in stable + +5. FEED DAILY: + - Horse: 5 hay + 2 carrots + - Donkey: 3 hay + 1 carrot + +6. WAIT: 11 in-game months (~22 real-world hours if playing!) + +7. MULE BABY BORN! ๐ŸŽ‰ + +8. WAIT: Baby grows to adult (3 months) + +9. RIDE YOUR MULE! + +TOTAL INVESTMENT: +- Gold: 8,000g (horse + donkey + stable + food) +- Time: 14 in-game months +- REWARD: BEST MOUNT IN GAME! โœ… +``` + +--- + +## ๐Ÿ“Š **TRANSPORT COMPARISON TABLE:** + +| Transport | Speed | Range | Cost | Terrain | Best For | +|-----------|-------|-------|------|---------|----------| +| Walk | 5 km/h | โˆž | Free | All | Starting | +| Skateboard | 15 km/h | โˆž | 100g | Roads | Early | +| Longboard | 20 km/h | โˆž | 250g | Roads | Early | +| Kick Scooter | 25 km/h | โˆž | 300g | Roads | Early-Mid | +| E-Scooter | 40 km/h | 100km | 1,500g | Roads+ | Mid | +| **Donkey** | 20 km/h | 100km | 2,000g | Mountains | Cargo | +| Horse | 35 km/h | 50km | 5,000g | Fields | Mid | +| **MULE** | **30 km/h** | **150km** | **8,000g** | **ALL** | **BEST!** | +| Dino Raptor | 60 km/h | 80km | 10,000g | Ground | Combat | +| Hoverboard | 50 km/h | โˆž | 5,000g | ALL | Late | + +**WINNER: MULE!** ๐Ÿ† +- Best stamina! +- Best cargo! +- ALL terrain! +- Never spooks! +- Lives longest! + +--- + +**โœ… BIOMES SCATTERED, TRAVEL REALISTIC, MULE = KING OF MOUNTS!** ๐Ÿด๐Ÿซ๐Ÿ—บ๏ธ