# 🎮 DEMO ASSETS FOLDER STRUCTURE

**Created:** 30.12.2025 04:02  
**Purpose:** Organized storage for all 247 demo assets

---

## 📁 FOLDER STRUCTURE

```
assets/images/demo/
├── characters/          (45 assets) - Kai animations
├── npcs/               (15 assets) - Trader, Blacksmith, Healer, Traveler, Ana
├── enemies/            (18 assets) - Zombies, wolves
├── buildings/          (8 assets) - Tent, shack, campfire, well, etc.
├── terrain/            (24 assets) - Grass, dirt, tilled, paths
├── crops/              (8 assets) - Wheat growth stages
├── environment/        (20 assets) - Trees, rocks, decorations
├── items/              (18 assets) - Tools, resources, products
├── ui/                 (35 assets) - HUD, inventory, dialogue, menus
├── cutscenes/          (12 assets) - Opening sequence, flashbacks
└── effects/            (32 assets) - Water, fire, weather, impacts
```

**TOTAL:** 247 assets organized in 11 categories

---

## 📋 COMPLETE ASSET MANIFEST

### **1. characters/ (45 assets)**

**Kai Idle (16 frames):**
- kai_idle_north_1.png
- kai_idle_north_2.png
- kai_idle_north_3.png
- kai_idle_north_4.png
- kai_idle_south_1.png
- kai_idle_south_2.png
- kai_idle_south_3.png
- kai_idle_south_4.png
- kai_idle_east_1.png
- kai_idle_east_2.png
- kai_idle_east_3.png
- kai_idle_east_4.png
- kai_idle_west_1.png
- kai_idle_west_2.png
- kai_idle_west_3.png
- kai_idle_west_4.png

**Kai Walk (16 frames):**
- kai_walk_north_1.png
- kai_walk_north_2.png
- kai_walk_north_3.png
- kai_walk_north_4.png
- kai_walk_south_1.png
- kai_walk_south_2.png
- kai_walk_south_3.png
- kai_walk_south_4.png
- kai_walk_east_1.png
- kai_walk_east_2.png
- kai_walk_east_3.png
- kai_walk_east_4.png
- kai_walk_west_1.png
- kai_walk_west_2.png
- kai_walk_west_3.png
- kai_walk_west_4.png

**Kai Run (8 frames):**
- kai_run_east_1.png
- kai_run_east_2.png
- kai_run_east_3.png
- kai_run_east_4.png
- kai_run_west_1.png
- kai_run_west_2.png
- kai_run_west_3.png
- kai_run_west_4.png

**Kai Actions (5 frames):**
- kai_hoe_action.png
- kai_watering.png
- kai_pickup.png
- kai_portrait.png
- kai_sleeping.png

---

### **2. npcs/ (15 assets)**

**Trader (3):**
- npc_trader_idle.png
- npc_trader_portrait.png
- npc_trader_happy.png

**Blacksmith (3):**
- npc_blacksmith_idle.png
- npc_blacksmith_portrait.png
- npc_blacksmith_neutral.png

**Healer (3):**
- npc_healer_idle.png
- npc_healer_portrait.png
- npc_healer_smile.png

**Traveler (3):**
- npc_traveler_idle.png
- npc_traveler_portrait.png
- npc_traveler_mysterious.png

**Ana (3):**
- ana_portrait.png
- ana_child.png
- ana_teen.png

---

### **3. enemies/ (18 assets)**

**Zombie Worker (12 frames):**
- zombie_idle_1.png
- zombie_idle_2.png
- zombie_idle_3.png
- zombie_idle_4.png
- zombie_walk_1.png
- zombie_walk_2.png
- zombie_walk_3.png
- zombie_walk_4.png
- zombie_dig_1.png
- zombie_dig_2.png
- zombie_dig_3.png
- zombie_dig_4.png

**Zombie Enemies (3):**
- zombie_runner.png
- zombie_bloated.png
- zombie_corpse.png

**Wolves (3):**
- wild_wolf.png
- wolf_attack.png
- wolf_dead.png

---

### **4. buildings/ (8 assets)**

- tent.png
- tent_interior.png
- shack.png
- campfire.png
- storage_chest.png
- water_well.png
- scarecrow.png
- compost_bin.png

---

### **5. terrain/ (24 assets)**

**Grass (8):**
- grass_tile_1.png
- grass_tile_2.png
- grass_tile_3.png
- grass_tile_4.png
- grass_corner_ne.png
- grass_corner_nw.png
- grass_corner_se.png
- grass_corner_sw.png

**Dirt (8):**
- dirt_tile_1.png
- dirt_tile_2.png
- dirt_tile_3.png
- dirt_tile_4.png
- dirt_corner_ne.png
- dirt_corner_nw.png
- dirt_corner_se.png
- dirt_corner_sw.png

**Tilled Soil (4):**
- tilled_dry.png
- tilled_watered.png
- tilled_planted.png
- tilled_growing.png

**Paths (4):**
- stone_path_straight.png
- stone_path_corner.png
- stone_path_cross.png
- stone_path_end.png

---

### **6. crops/ (8 assets)**

- wheat_seeds.png
- wheat_stage0.png
- wheat_stage1.png
- wheat_stage2.png
- wheat_stage3.png
- wheat_stage4.png
- wheat_harvested.png
- wheat_bundle.png

---

### **7. environment/ (20 assets)**

**Trees (4):**
- oak_tree.png
- oak_tree_stump.png
- pine_tree.png
- dead_tree.png

**Rocks (4):**
- rock_large.png
- rock_medium.png
- rock_small.png
- iron_ore_deposit.png

**Plants (6):**
- bush_green.png
- bush_berries.png
- flower_yellow.png
- flower_purple.png
- grass_tall.png
- weeds.png

**Farm Decorations (6):**
- wooden_fence.png
- fence_gate.png
- fence_corner.png
- wooden_sign.png
- lantern_post.png
- rain_barrel.png

---

### **8. items/ (18 assets)**

**Tools (6):**
- wooden_hoe.png
- watering_can.png
- wooden_axe.png
- wooden_pickaxe.png
- fishing_rod.png
- scythe.png

**Resources (5):**
- wood_log.png
- stone.png
- iron_ore.png
- stick.png
- fiber.png

**Products (3):**
- wheat_flour.png
- bread.png
- water_bucket.png

**Special (4):**
- mothers_locket.png
- sleeping_bag.png
- backpack.png
- coin.png

---

### **9. ui/ (35 assets)**

**HUD (9):**
- health_bar_frame.png
- health_bar_fill.png
- stamina_bar_frame.png
- stamina_bar_fill.png
- hunger_bar_frame.png
- hunger_bar_fill.png
- day_indicator.png
- time_clock.png
- coin_counter_icon.png

**Inventory (8):**
- inventory_panel.png
- inventory_slot_empty.png
- inventory_slot_hover.png
- inventory_slot_selected.png
- hotbar_panel.png
- hotbar_slot.png
- item_count_bg.png
- cursor_normal.png

**Dialogue (6):**
- dialogue_box.png
- dialogue_portrait_frame.png
- dialogue_continue_arrow.png
- dialogue_choice_button.png
- name_tag_bg.png
- speech_bubble.png

**Quest (4):**
- quest_marker_icon.png
- quest_panel.png
- quest_complete_check.png
- exclamation_mark.png

**Menus (8):**
- button_normal.png
- button_hover.png
- button_pressed.png
- panel_background.png
- title_card.png
- pause_menu_bg.png
- settings_icon.png
- close_button.png

---

### **10. cutscenes/ (12 assets)**

**Opening (3):**
- tent_interior_dawn.png
- locket_open.png
- locket_closed.png

**Flashbacks (5):**
- flashback_babies.png
- flashback_children.png
- flashback_family.png
- flashback_troll.png
- flashback_ana_screaming.png

**Effects (4):**
- fade_black_overlay.png
- vignette.png
- dust_particle.png
- sparkle_effect.png

---

### **11. effects/ (32 assets)**

**Water (4):**
- water_tile_frame1.png
- water_tile_frame2.png
- water_tile_frame3.png
- water_tile_frame4.png

**Fire (4):**
- campfire_flame1.png
- campfire_flame2.png
- campfire_flame3.png
- campfire_flame4.png

**Weather (8):**
- rain_drop1.png
- rain_drop2.png
- rain_drop3.png
- rain_drop4.png
- cloud_light.png
- cloud_dark.png
- sun_ray.png
- fog_overlay.png

**Impact (8):**
- hit_spark1.png
- hit_spark2.png
- slash_effect.png
- dig_dirt_spray.png
- water_splash.png
- level_up_glow.png
- heal_particles.png
- damage_number_template.png

**UI Animations (8):**
- loading_spinner_1.png
- loading_spinner_2.png
- loading_spinner_3.png
- loading_spinner_4.png
- quest_marker_pulse1.png
- quest_marker_pulse2.png
- coin_spin1.png
- coin_spin2.png

---

## ✅ USAGE INSTRUCTIONS

### **To Check Progress:**
```bash
cd /Users/davidkotnik/repos/novafarma

# Count assets per folder
find assets/images/demo/characters -name "*.png" | wc -l
find assets/images/demo/npcs -name "*.png" | wc -l
find assets/images/demo/enemies -name "*.png" | wc -l

# Total count
find assets/images/demo -name "*.png" | wc -l
```

### **Generation Workflow:**

**Batch 1 - Characters (45):**
```bash
# Generate all Kai animations
# Save to: assets/images/demo/characters/
```

**Batch 2 - Terrain + Crops (32):**
```bash
# Generate zombie worker + terrain + wheat
# Save to: 
#   - assets/images/demo/enemies/ (zombie worker)
#   - assets/images/demo/terrain/
#   - assets/images/demo/crops/
```

**Batch 3 - Buildings + Items (26):**
```bash
# Generate buildings and tools
# Save to:
#   - assets/images/demo/buildings/
#   - assets/images/demo/items/
```

Continue for all batches...

### **After Generation:**
```bash
# Remove white backgrounds (batch process all)
python3 scripts/remove_background.py assets/images/demo/ --recursive
```

---

## 📊 PROGRESS TRACKING

**Use this checklist:**

- [ ] characters/ (0/45)
- [ ] npcs/ (0/15)
- [ ] enemies/ (0/18)
- [ ] buildings/ (0/8)
- [ ] terrain/ (0/24)
- [ ] crops/ (0/8)
- [ ] environment/ (0/20)
- [ ] items/ (0/18)
- [ ] ui/ (0/35)
- [ ] cutscenes/ (0/12)
- [ ] effects/ (0/32)

**TOTAL: 0/247**

---

## 🎯 COMPLETION CRITERIA

**Demo is ready when:**
- ✅ All 247 assets generated
- ✅ All in correct folders
- ✅ All backgrounds removed
- ✅ No duplicates
- ✅ All named correctly
- ✅ All load in game engine

---

**Created:** 30.12.2025 04:02  
**Total Assets:** 247  
**Folders:** 11  
**Status:** ⚠️ Empty, ready for generation!