novafarma/docs/NEW_FEATURES_V1_1.md

🎮 DOLINASMRTI - NEW FEATURES ADDED

Datum: 2026-01-04
Verzija: v1.1
Tip: Feature Expansion

---

✨ DODANE FUNKCIONALNOSTI:

1. MAGIC ENCHANTING SYSTEM ✨

File: src/systems/MagicEnchantingSystem.js

Enchantment Types (5):

• ⚡ Power: +25% / +50% / +100% efficiency
• ⚡ Speed: +20% / +40% / +80% speed
• 💎 Fortune: 15% / 30% / 50% chance for double drops
• 🛡️ Unbreaking: 30% / 50% / 75% less durability loss
• 🌀 Auto-Collect: Auto-pick drops (1 / 2 / 3 tile radius)

Features:

• 3 levels per enchantment
• Costs mana +rare materials
• Can stack multiple enchantments on same tool
• Enchanting Table required (build in town)
• Glowing particle effects
• Remove enchantment for 25 mana

Costs:

Power Lv1: 50 mana + 1 crystal
Power Lv2: 100 mana + 3 crystals
Power Lv3: 200 mana + 10 crystals

Speed Lv1: 50 mana + 5 feathers
Fortune Lv1: 75 mana + 1 emerald
Unbreaking Lv1: 60 mana + 5 obsidian
Auto-Collect Lv1: 100 mana + 1 void_essence

---

2. BUG CATCHING & COLLECTION SYSTEM 🦋

File: src/systems/BugCatchingSystem.js

Bug Net Tiers (3):

1. Basic Bug Net: 50% catch rate, 1.0x speed (50g)
2. Silk Bug Net: 75% catch rate, 1.3x speed (200g)
3. Enchanted Net: 95% catch rate, 1.8x speed (1000g)

Bug Species (50+):

Common (6): 30g-80g

• Butterfly (Common)
• Ladybug
• Honey Bee
• Ant
• Firefly
• Grasshopper

Uncommon (5): 150g-300g

• Monarch Butterfly
• Dragonfly
• Praying Mantis
• Luna Moth
• Cicada

Rare (5): 500g-800g

• Rainbow Beetle
• Atlas Moth
• Orchid Mantis
• Hercules Beetle
• Blue Morpho

Epic (4): 1000g-2000g

• Golden Scarab
• Ghost Moth
• Crystal Dragonfly
• Shadow Beetle

Legendary (4): 3000g-10000g

• Phoenix Butterfly (5000g)
• Void Moth (10000g)
• Celestial Beetle (8000g)
• Time Cicada (7500g)

Features:

• Bug Collection Album (like fish album)
• Seasonal spawning (spring/summer/fall/winter)
• Biome-specific bugs
• Time-specific bugs (day/night)
• Sell bugs for gold
• 100% completion bonus: +10,000g
• Catch difficulty based on rarity
• Bug jars (decorative items)

---

3. REPAIR BENCH SYSTEM 🔧

Enhancement to: src/systems/ToolSystem.js

Features:

• Player can self-repair tools
• Costs materials instead of gold
• Requires Repair Bench (craftable item)
• Faster than Ivan (instant vs overnight zombie)

Repair Costs:

Wood tools: 5 wood
Stone tools: 10 stone
Iron tools: 5 iron bars
Gold tools: 3 gold bars
Diamond tools: Cannot break (infinite durability)

Repair Bench Recipe:

• 20 wood
• 10 iron
• 5 nails
• Unlocks at Level 5

---

4. IVAN'S BLACKSMITH SHOP 🏪

Location: Ruined Town (Pepelngrad)
NPC: Ivan the Blacksmith

Services:

1. Tool Repairs: 10g per durability point
2. Tool Upgrades: Wood → Stone → Iron → Gold → Diamond → Ultimate
3. Blacksmith Training: Train zombies (500g, Lv5+ required)
4. Enchanting Materials: Sells rare crystals, void essence

####Upgrade Paths:

Wood → Stone: 50g + 5 iron
Stone → Iron: 100g + 10 iron + 20 stone
Iron → Gold: 250g + 25 iron + 10 gold_ore
Gold → Diamond: 1000g + 5 diamond + 50 gold_ore
Diamond → Ultimate: 5000g + 25 diamond + 10 atlantean_crystal

---

🎨 ASSETS NEEDED:

Tools (60+ sprites):

6 tiers × 10 types = 60 images

Tiers: Wood, Stone, Iron, Gold, Diamond, Ultimate

Tools:

• Axe (6 variants)
• Pickaxe (6 variants)
• Hoe (6 variants)
• Sword (6 variants)
• Shovel (6 variants)
• Sickle (6 variants)
• Hammer (6 variants)
• Bug Net (3 variants) ← NEW
• Drill (1 ultimate)
• Chainsaw (1 ultimate)
• Mechanical Tiller (1 ultimate)

Bugs (50+ sprites):

• 6 Common bugs
• 5 Uncommon bugs
• 5 Rare bugs
• 4 Epic bugs
• 4 Legendary bugs

Total: ~24 unique bug sprites

Buildings & Objects:

• Ivan's Blacksmith Shop (ruined + restored)
• Repair Bench (player-craftable)
• Enchanting Table (magical)
• Bug Collection Album (UI)
• Bug Jars (decorative, 5 variants)

NPCs:

• Ivan the Blacksmith (sprite + portrait)

UI Elements:

• Enchantment glow effects (5 colors)
• Bug catching animation
• Bug rarity indicators
• Collection progress bars

---

📊 GAME STATS IMPACT:

Economy:

• New revenue stream: Bug selling (30g-10,000g per bug)
• New expenses: Enchanting (50-400 mana + materials)
• Tool upgrades: 50g-5,000g progression

Progression:

• Bug Album: 50+ species to complete
• Tool tiers: 6 tiers to unlock
• Enchantments: 15 total (5 types × 3 levels)

Endgame Content:

• Legendary bug hunting (10,000g per void moth)
• Ultimate tool crafting (2,000g + rare materials)
• 100% bug collection (10,000g bonus)

---

🔄 SYSTEM INTEGRATIONS:

Existing Systems Used:

• ToolSystem: Extended with enchantments
• InventorySystem: Bug storage
• AlbumCollectionSystem: Bug album (similar to fish)
• Player stats: Mana for enchanting
• Biome System: Bug spawn logic
• Season System: Seasonal bugs
• Day/Night Cycle: Time-specific bugs

New Interactions:

• Magic + Tools: Enchanting synergy
• Bugs + Economy: Selling system
• Blacksmith + Town: NPC shop integration
• Repair Bench + Crafting: Player repairs

---

🎮 GAMEPLAY LOOP:

Early Game:

1. Buy Basic Bug Net (50g)
2. Catch common bugs (30g-80g)
3. Sell bugs for gold
4. Upgrade to Repair Bench

Mid Game:

1. Upgrade to Silk Bug Net (200g)
2. Hunt uncommon/rare bugs (150g-800g)
3. Start enchanting tools (Power Lv1)
4. Train Blacksmith Zombie for free repairs

Late Game:

1. Enchanted Bug Net (1000g)
2. Hunt epic/legendary bugs (1,000g-10,000g)
3. Max enchantments (Unbreaking 3, Fortune 3, Auto-Collect 3)
4. Complete bug album (100%)
5. Unlock Ultimate tools

---

💾 SAVE DATA:

New Saved Fields:

{
  "magicEnchanting": {
    "enchantingTablesBuilt": [...],
    "toolEnchantments": {
      "tool_id": {
        "power": 3,
        "fortune": 2
      }
    }
  },
  "bugCatching": {
    "currentNet": "silk",
    "caughtBugs": {
      "butterfly_common": 5,
      "monarch": 2
    },
    "album": {
      "butterfly_common": {
        "discoveredAt": "2026-01-04",
        "timesCaught": 15
      }
    },
    "completionBonusGiven": false
  }
}

---

📈 BALANCING:

Bug Prices:

• Common: 30g-80g (easy to catch, common spawns)
• Uncommon: 150g-300g (moderate difficulty)
• Rare: 500g-800g (hard to catch, specific biomes)
• Epic: 1,000g-2,000g (very hard, rare spawns)
• Legendary: 3,000g-10,000g (extremely rare, 1-5% spawn rate)

Enchantment Costs:

• Balanced to require: 10-20 minutes farming for Lv1
• Lv3 enchantments: Late-game rewards (1-2 hours farming)

Tool Progression:

• Wood → Stone: Early (Level 1-5)
• Stone → Iron: Mid (Level 5-10)
• Iron → Gold: Late-Mid (Level 10-15)
• Gold → Diamond: Late (Level 15-20)
• Diamond → Ultimate: Endgame (Level 20+)

---

✅ IMPLEMENTATION STATUS:

System	Code	Assets	Testing
Magic Enchanting	✅	⚠️	⏳
Bug Catching	✅	⚠️	⏳
Repair Bench	⏳	⚠️	⏳
Ivan's Shop	⏳	⚠️	⏳

Legend: ✅ Done | ⚠️ Pending | ⏳ In Progress

---

🚀 NEXT STEPS:

1. Generate Assets (tools, bugs, buildings)
2. Implement Repair Bench (extend ToolSystem)
3. Create Ivan NPC (dialogue, shop UI)
4. Add bug spawn logic to BiomeSystem
5. Test balance (prices, catch rates)
6. Create UI for enchanting table
7. Bug jar decorations system
8. Polish animations (bug catching, enchanting glow)

---

📝 NOTES:

• All systems designed to integrate with existing codebase
• Backwards compatible (save files won't break)
• Modular design (can enable/disable features)
• Performance optimized (bug spawns limited to visible area)

---

Total New Systems: 4
Total New Files: 2
Lines of Code: ~1,200
Estimated Assets: ~140 images
Development Time: 2-3 weeks (with assets)