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:
```json
{
  "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)