feat: Create demo asset folder structure with complete 247-asset manifest

2025-12-30 04:03:36 +01:00
parent 93c1c7f2d1
commit d7f08f1ff3
2 changed files with 489 additions and 0 deletions
--- a/assets/images/demo/MANIFEST.txt
+++ b/assets/images/demo/MANIFEST.txt
@@ -0,0 +1,18 @@
+# Demo Assets - Quick Reference
+
+Total: 247 assets needed for demo
+
+## Folders Created:
+- characters/ (45) - Kai animations
+- npcs/ (15) - NPCs with clear facial features
+- enemies/ (18) - Zombies & wolves  
+- buildings/ (8) - Structures
+- terrain/ (24) - Ground tiles
+- crops/ (8) - Wheat cycle
+- environment/ (20) - Trees, rocks, decorations
+- items/ (18) - Tools & resources
+- ui/ (35) - Interface elements
+- cutscenes/ (12) - Opening sequence
+- effects/ (32) - Animations & VFX
+
+See README.md for complete asset list.
--- a/assets/images/demo/README.md
+++ b/assets/images/demo/README.md
@@ -0,0 +1,471 @@
+# 🎮 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!