diff --git a/references/README.md b/references/README.md new file mode 100644 index 000000000..06fa57af3 --- /dev/null +++ b/references/README.md @@ -0,0 +1,87 @@ +# 📁 REFERENCES - Master Visual Law + +**Purpose:** Visual references that define the EXACT look for all characters. +**Rule:** NOTHING gets generated without matching these references. + +--- + +## 📂 **Folder Structure:** + +### **`/main_characters/`** +Main playable characters and key story NPCs: +- `kai/` - Kai Marković (pink+green dreads, katana, piercings) +- `ana/` - Ana Marković (blonde, blue eyes WITH pupils) +- `gronk/` - Gronk (pink dreads, vape, troll) + +### **`/npcs/`** +Town service NPCs: +- `ivan_kovac/` - Blacksmith (✅ HAVE: download.jpg in assets/slike 🟢/konsistentno/) +- `mayor/` - Župan (town administrator) +- `miro_pravnik/` - Lawyer +- `arborist/` - Tree planter +- `tehnik/` - Technician +- `sivilja/` - Seamstress +- `pek/` - Baker +- `kustos/` - Museum Curator +- `teacher/` - School Teacher + +### **`/companions/`** +Friendly followers: +- `zombie_scout/` - Zombi Skavt (red bandana, backpack, red eyes WITH pupils) + +### **`/enemies/`** +Hostile NPCs: +- `nomad_raiders/` - Desert Nomads, Frost Bandits, etc. +- `zombies/` - Various zombie types + +### **`/species/`** +Fantasy races: +- `trolls/` - Troli (town inhabitants) +- `fairies/` - Vilinci +- `elves/` - Škratje + +--- + +## 🎨 **What to Put in Each Folder:** + +**Each character folder should contain:** +1. **Master Reference** - Full body portrait, front-facing +2. **Face Close-up** (optional) - For dialogue portraits +3. **Action Poses** (optional) - Specific animations + +**File Naming:** +- `master_reference.png` - Main reference image +- `face_closeup.png` - Dialogue portrait +- `action_01.png`, `action_02.png` - Specific poses + +--- + +## ✅ **Style Rules (Style 32 - Dark-Chibi Noir):** + +**ALL references must follow:** +- ✅ 32x32px base (or multiples: 64x64, 96x96) +- ✅ Thick black outlines (4-5px) +- ✅ Chibi proportions (big head, small body) +- ✅ Flat colors with subtle shading +- ✅ Top-down or isometric view +- ✅ Green background (#00FF00) for easy keying + +**Eye Rules:** +- 👥 **Friendly NPCs/Humans:** Red eyes WITH dark pupils +- 🧟 **Weak/Tamed Zombies:** White eyes, NO pupils +- 🧟 **Strong/Wild Zombies:** Red eyes, NO pupils +- 🧡 **Zombi Skavt (exception):** Red eyes WITH pupils + +--- + +## 🔒 **Visual Law:** + +Once a reference is approved and placed here: +- **NO changes** without user approval +- **ALL future generations** must match this reference +- **Consistency** is LAW + +--- + +**Status:** 🟢 Ready for reference images +**Next:** User will add existing references to appropriate folders diff --git a/references/npcs/ivan_kovac/master_reference.jpg b/references/npcs/ivan_kovac/master_reference.jpg new file mode 100644 index 000000000..dd405adaf Binary files /dev/null and b/references/npcs/ivan_kovac/master_reference.jpg differ