From d7f08f1ff32d389aeefb7e21611b6db1aee62f16 Mon Sep 17 00:00:00 2001 From: David Kotnik Date: Tue, 30 Dec 2025 04:03:36 +0100 Subject: [PATCH] feat: Create demo asset folder structure with complete 247-asset manifest --- assets/images/demo/MANIFEST.txt | 18 ++ assets/images/demo/README.md | 471 ++++++++++++++++++++++++++++++++ 2 files changed, 489 insertions(+) create mode 100644 assets/images/demo/MANIFEST.txt create mode 100644 assets/images/demo/README.md diff --git a/assets/images/demo/MANIFEST.txt b/assets/images/demo/MANIFEST.txt new file mode 100644 index 000000000..461a1b8df --- /dev/null +++ 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. diff --git a/assets/images/demo/README.md b/assets/images/demo/README.md new file mode 100644 index 000000000..af8493bb8 --- /dev/null +++ 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!