novafarma/docs/BIOME_PLACEMENT_TRAVEL_SYSTEM.md

# 🗺️ **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!** 🐴🫏🗺️