novafarma/docs/CARAVAN_TELEPORTERS_CAMPS_TAMING.md

# 🦙🌀🏕️ **CARAVAN + TELEPORTERS + CAMPS + BABY TAMING COMPLETE!**

## 🦙 **LLAMA/ALPACA CARAVAN SYSTEM (Up to 6!)**

### **HOW IT WORKS:**

```
[Buy/tame 6 Llamas]

SETUP:
1. Ride Lead Llama (you control this one!)
2. Attach Llama 2 with Rope (right-click while holding rope)
3. Llama 2 auto-follows Lead Llama!
4. Attach Llama 3 to Llama 2
5. Attach Llama 4 to Llama 3
6. Attach Llama 5 to Llama 4
7. Attach Llama 6 to Llama 5

[CARAVAN FORMED!]
All 6 llamas follow in a LINE behind you!
```

### **CARAVAN STATS:**

**6 LLAMA CARAVAN:**
```
Total Cargo: 600kg × 6 = 3,600kg!!!
Total Inventory Slots: 200 × 6 = 1,200 slots!!!
Total Cost: 3,000g × 6 = 18,000g

Perfect for:
- Long trading journeys!
- Biome resource collection!
- Moving entire base!
- ULTIMATE MERCHANT SETUP! 💰
```

**6 ALPACA CARAVAN:**
```
Total Cargo: 400kg × 6 = 2,400kg
Daily Wool Production: 6 alpacas × 1 wool = 6 wool/day!
Weekly Wool: 42 wool = 4,200g passive income!

Perfect for:
- Wool farming empire!
- Still good cargo!
- Faster than llama caravan!
```

**MIXED CARAVAN (3 Llamas + 3 Alpacas):**
```
Cargo: (600×3) + (400×3) = 3,000kg
Wool: 3 alpacas = 3 wool/day
Balance: Good cargo + passive income!
```

---

## 🐾 **BABY ANIMAL TAMING SYSTEM**

### **THE RULE:**
```
✅ Can tame BABY animals (wild + magical!)
✅ Adults CANNOT be tamed! (too old, set in ways!)
✅ Must find baby in wild OR breed from captured adults!
```

---

### **HOW TO TAME BABIES:**

**STEP 1: FIND BABY ANIMAL**
```
[Exploring Endless Forest]
[See: Baby Wolf (2 weeks old!)]

OPTIONS:
A) Kill it (gives meat/fur)
B) TAME IT! ✅

[Choose B]
```

**STEP 2: FEED BABY**
```
[Approach slowly]
[Baby Wolf is scared! -10m distance]

[Hold out food: Raw Meat]
[Baby sniffs...]
[Trust: 10% → 20%]

[Feed again]
[Trust: 20% → 40%]

[Feed 5× total]
[Trust: 100%! ✅]

[BABY WOLF TAMED!]
[Follows you now! 🐺]
```

**STEP 3: NAME YOUR PET**
```
[Right-click Baby Wolf]

NAME YOUR PET:
[Input: "Shadow"]

✅ Shadow the Wolf is now your companion!
```

**STEP 4: RAISE TO ADULTHOOD**
```
Age Progression:
- Week 1-4: Baby (small, weak, cute!)
- Week 5-12: Juvenile (medium, fights weak enemies)
- Week 13+: **ADULT!** (full size, strong!)

Daily Care:
- Feed 1× per day (meat for carnivores, hay for herbivores)
- Pet (increases happiness!)
- Play (throw stick, etc.)

If well-cared:
- Loyalty: 100%
- Helps in combat!
- Never abandons you!
```

---

### **TAMEABLE CREATURES (Baby Only!):**

**COMMON WILD ANIMALS:**
1. 🐺 **Baby Wolf** - Becomes combat companion! (+30 dmg vs enemies!)
2. 🐻 **Baby Bear** - Tank companion! (high HP, protects you!)
3. 🦊 **Baby Fox** - Sneaky scout! (detects enemies 20m away!)
4. 🦌 **Baby Deer** - Fast mount when adult! (35 km/h!)
5. 🐗 **Baby Boar** - Finds truffles! (passive income!)

**RARE WILD ANIMALS:**
6. 🦅 **Baby Eagle** - Flying scout! (shows map from above!)
7. 🐆 **Baby Leopard** - Fast attack! (50 dmg, very quick!)
8. 🐘 **Baby Elephant** - Cargo carrier! (800kg when adult!)

**MAGICAL CREATURES (Ultra Rare!):**
9. 🦄 **Baby Unicorn** - Heal aura! (party heals 5 HP/sec near it!)
10. 🐉 **Baby Dragon** - ULTIMATE PET! (flies, breathes fire, 80 km/h mount!)
11. 🦅 **Baby Griffin** - Flies + attacks! (60 dmg, flying mount!)
12. 🦅 **Baby Phoenix** - Revives you once/day! (like extra life!)
13. 🐺 **Baby Dire Wolf** - Bigger than normal wolf! (50 dmg!)
14. 🦎 **Baby Basilisk** - Petrifies enemies! (stone for 5 sec!)

---

### **WHAT TAMED CREATURES DO:**

**COMBAT HELPERS:**
```
Baby Wolf → Adult Wolf:
- Fights alongside you!
- Attacks your target automatically!
- Damage: 30
- Can command: "Stay", "Follow", "Attack"
```

**RESOURCE HELPERS:**
```
Baby Boar → Adult Boar:
- Digs for truffles while you explore!
- Finds 1-3 truffles/day (500g each!)
- Passive income: 500-1,500g/day!
```

**SCOUT HELPERS:**
```
Baby Eagle → Adult Eagle:
- Flies above you
- Shows enemies on minimap!
- Warns of danger: *SCREECH!*
- Can send to scout ahead!
```

**MOUNT HELPERS:**
```
Baby Dragon → Adult Dragon:
- RIDEABLE! (80 km/h flying!)
- Breathes fire while riding! (50 dmg AOE!)
- Never tires!
- ULTIMATE COMPANION!
```

---

## 🌀 **TELEPORTER NETWORK SYSTEM**

### **OVERVIEW:**
```
Total Teleporters: 21
- 1× HOME TELEPORTER (near farm)
- 20× BIOME TELEPORTERS (1 per biome)

All teleporters are BROKEN when found!
Must REPAIR to activate!
```

---

### **HOME TELEPORTER (Farm):**

**LOCATION:**
```
Placed near Dolina Smrti farm entrance
Pre-existing structure (ancient ruin)
Large stone arch with glowing runes (when active)
```

**REPAIR REQUIREMENTS:**
```
Materials:
- 500 Stone
- 200 Mythril
- 100 Magic Crystals
- 50 Portal Shards
- 10,000 gold

Time: 3 in-game days (with zombie workers)

[After repair:]
✅ HOME TELEPORTER ACTIVE!
Can now teleport to any discovered biome teleporter!
```

---

### **BIOME TELEPORTERS (20 Total):**

**FINDING BIOME TELEPORTER:**
```
[Enter new biome: Endless Forest]

[Quest appears:]
🔔 NEW QUEST: "Find the Teleporter"
"An ancient teleporter is hidden somewhere in this biome.
Find it and repair it to enable fast travel!"

[Teleporter location:]
- Usually in biome CENTER
- Marked with faint glow (if close)
- Surrounded by ruins/ancient structures
- Guarded by enemies (usually!)

[Find teleporter:]
ENDLESS FOREST TELEPORTER FOUND! ✅
Status: BROKEN (needs repair)
```

**REPAIR BIOME TELEPORTER:**
```
Materials (each teleporter):
- 200 Stone
- 100 Iron
- 50 Magic Crystals
- 20 Portal Shards
- 2,000 gold

Time: 1 in-game day

[After repair:]
✅ ENDLESS FOREST TELEPORTER ACTIVE!
[Automatically linked to HOME teleporter!]
```

---

### **TELEPORTER UI:**

**AT HOME TELEPORTER:**
```
[Right-click Home Teleporter]

╔════════════════════════════════════════════╗
║        TELEPORTER NETWORK                  ║
╠════════════════════════════════════════════╣
║  SELECT DESTINATION:                       ║
║                                            ║
║  ✅ UNLOCKED BIOMES:                      ║
║  → Ljubljana (Town)                        ║
║  → Mushroom Forest                         ║
║  → Endless Forest                          ║
║  → Dino Valley                             ║
║  → Witch Forest                            ║
║  → Chernobyl                               ║
║                                            ║
║  🔒 LOCKED BIOMES:                        ║
║  🔒 Egyptian Desert (Not discovered)      ║
║  🔒 Atlantis (Not discovered)             ║
║  🔒 Mythical Highlands (Not discovered)   ║
║  🔒 Loch Ness (Not discovered)            ║
║  ... (14 more locked)                      ║
║                                            ║
║  [CANCEL]                                  ║
╚════════════════════════════════════════════╝

[Select: Chernobyl]

[Teleportation Animation!]
[Glowing runes, portal swirl, WHOOSH!]

[Arrive at Chernobyl Teleporter!]
INSTANT TRAVEL! ✅
```

**AT BIOME TELEPORTER:**
```
[Right-click Chernobyl Teleporter]

╔════════════════════════════════════════════╗
║    CHERNOBYL TELEPORTER                    ║
╠════════════════════════════════════════════╣
║  QUICK DESTINATIONS:                       ║
║                                            ║
║  🏠 HOME (Dolina Smrti Farm) ✅           ║
║                                            ║
║  OR                                        ║
║                                            ║
║  🗺️ NETWORK MAP (All destinations)       ║
║                                            ║
║  [SELECT HOME] [NETWORK MAP] [CANCEL]      ║
╚════════════════════════════════════════════╝

Most common: Just teleport HOME! ✅
```

---

### **TELEPORTER PROGRESSION:**

**Week 1:**
```
- Repair HOME teleporter (10,000g investment!)
- Discover + repair 2-3 nearby biomes
- Can teleport: Farm ↔ Ljubljana, Mushroom Forest
```

**Week 5:**
```
- 10 biomes discovered + repaired
- Teleporter network growing!
- Travel time reduced by 80%!
```

**Week 10+:**
```
- ALL 20 biomes unlocked!
- Can teleport ANYWHERE instantly!
- World feels small but conquered!
```

---

## 🏕️ **MINI CAMP SYSTEM**

### **WHAT ARE CAMPS?**
```
Temporary bases you can set up anywhere!
Perfect for:
- Long mining operations
- Remote biome resource gathering
- Safe rest points during exploration
- Fast travel hubs!
```

---

### **HOW TO BUILD CAMP:**

**REQUIREMENTS:**
```
Materials:
- 100 Wood (tent frame)
- 50 Cloth (tent cover)
- 20 Rope (stakes)
- 10 Iron (tools)
- 500 gold

Craftable at: WORKBENCH
Result: CAMP KIT (portable item!)
```

**PLACEMENT:**
```
[Carry Camp Kit in inventory]

[Find good location:]
- Flat ground
- Near resources (mine, forest, etc.)
- Safe from zombies (ideally)

[Right-click Camp Kit]
[Place tent!]

[MINI CAMP ESTABLISHED!] ✅

[Automatically appears on map! 📍]
```

---

### **CAMP FEATURES:**

**1. TENT (Sleep + Save)**
```
[Enter tent]

OPTIONS:
- [Sleep] - 6 hour rest
- [Quick Save] - Save game!
- [Fast Travel to Farm] - Return home! ✅
```

**2. CAMPFIRE (Cook + Light)**
```
[Light campfire]
- Cook food
- Craft simple items
- Provides light at night
- Keeps zombies 10m away!
```

**3. STORAGE CHEST**
```
[Access camp chest]
- Store 100 items!
- Leave resources here
- Come back later to collect!

Perfect for:
- Mining trips (store ore at camp, fast travel home when full!)
- Long expeditions (drop off loot periodically!)
```

---

### **FAST TRAVEL FROM CAMP:**

```
[At Mini Camp in Chernobyl mines]

[Enter tent]

OPTIONS:
- [Sleep]
- [Save]
- [FAST TRAVEL TO FARM] ✅ ← NEW!

[Select Fast Travel]

╔════════════════════════════════════════════╗
║    FAST TRAVEL - CONFIRMATION              ║
╠════════════════════════════════════════════╣
║  Teleport to Dolina Smrti Farm?           ║
║                                            ║
║  Cost: FREE! (from your camp!)            ║
║  Duration: INSTANT!                        ║
║                                            ║
║  Note: Camp will remain here.             ║
║  You can return anytime!                   ║
║                                            ║
║  [CONFIRM] [CANCEL]                        ║
╚════════════════════════════════════════════╝

[Confirm]

[WHOOSH! Teleport to farm!] ✅

[Camp still exists in Chernobyl!]
[Can teleport BACK to camp later!]
```

---

### **CAMP MAP MARKERS:**

**ON MAP:**
```
[Open World Map]

MAP LEGEND:
🏠 = Home (Dolina Smrti Farm)
📍 = Mini Camp (your camps!)
🌀 = Teleporter
🏛️ = Town
⚠️ = Danger Zone

EXAMPLE MAP VIEW:

    Chernobyl Zone
    ┌─────────────┐
    │  ⚠️ Reactor │
    │             │
    │  📍 Mining  │  ← Your camp here!
    │    Camp     │
    │             │
    │  🌀 Tele-   │
    │    porter   │
    └─────────────┘

[Click 📍 Mining Camp]

CAMP INFO:
Name: Mining Camp #1
Location: Chernobyl - East Mines
Resources Nearby: Uranium, Lead, Steel
Chest: 45/100 items stored
Last Visited: 2 days ago

[FAST TRAVEL TO CAMP] ✅ ← Can teleport TO camp!
[REMOVE CAMP] (reclaim materials)
```

---

### **MULTIPLE CAMPS:**

**YOU CAN HAVE UP TO 10 CAMPS!**
```
Example Setup:

Camp 1: Chernobyl Mines (uranium farming)
Camp 2: Mythical Highlands Peak (dragon hunting)
Camp 3: Atlantis Depths (underwater base)
Camp 4: Dino Valley (dino taming)
Camp 5: Egyptian Desert (pyramid exploration)
Camp 6: Endless Forest (Bigfoot tracking)
Camp 7: Witch Forest (herb gathering)
Camp 8: Arctic Zone (ice fishing)
Camp 9: Volcanic Hellscape (obsidian mining)
Camp 10: Mexican Cenotes (cenote diving)

All appear on map! 📍📍📍
Can fast travel TO any camp!
Can fast travel FROM any camp → Home!
```

---

## 📊 **COMPLETE SYSTEM SUMMARY:**

### **LLAMA/ALPACA CARAVAN:**
- ✅ Up to 6 animals in caravan!
- ✅ Follow in line formation
- ✅ 6 Llamas = 3,600kg cargo!
- ✅ 6 Alpacas = 42 wool/week passive income!

### **BABY ANIMAL TAMING:**
- ✅ 14 tameable species (wild + magical!)
- ✅ ONLY babies can be tamed!
- ✅ Feed → Trust → Tame → Raise!
- ✅ Helpers: Combat, Resource, Scout, Mount!
- ✅ Baby Dragon → Ultimate flying mount! 🐉

### **TELEPORTER NETWORK:**
- ✅ 1 Home + 20 Biome teleporters
- ✅ All broken initially → Must repair!
- ✅ Home teleporter: 10,000g to repair
- ✅ Biome teleporters: 2,000g each
- ✅ Unlocked biomes shown first
- ✅ Locked biomes grayed out below
- ✅ INSTANT fast travel! ✅

### **MINI CAMP SYSTEM:**
- ✅ Build up to 10 camps!
- ✅ Cost: 500g + materials per camp
- ✅ Features: Tent, Campfire, Storage Chest
- ✅ Sleep + Save + Cook!
- ✅ **FAST TRAVEL TO FARM FROM ANY CAMP!** ⭐
- ✅ Camps show on map! 📍
- ✅ Can teleport TO camps!
- ✅ Perfect for remote resource farming!

---

## 🎮 **GAMEPLAY EXAMPLE:**

**Scenario: Chernobyl Uranium Mining Operation**

```
DAY 1:
- Travel to Chernobyl (mule, 5 hours)
- Find + repair teleporter (2,000g)
- Discover uranium mine
- Build Mining Camp #1 (500g)
- Mine 500kg uranium
- Store in camp chest
- Fast travel HOME from camp! ✅

DAY 2 (back at farm):
- Sell crops, rest
- Fast travel: Farm → Chernobyl teleporter! ✅
- Walk to Mining Camp
- Collect stored uranium from chest
- Mine another 500kg
- Store in camp
- Fast travel HOME! ✅

DAY 3:
- Same routine!
- After 1 week: 3,500kg uranium collected!
- Total travel time saved: ~30 hours! ✅

DAY 8:
- Bring 6-llama caravan to camp
- Load ALL uranium (3,500kg fits in caravan!)
- Fast travel HOME with full caravan! ✅
- Sell uranium: 350,000 gold!!! 💰💰💰

CAMP ENABLED EFFICIENT MINING! ✅
```

---

**✅ ULTIMATE EXPLORATION + RESOURCE SYSTEM! 🦙🌀🏕️**