# 📁 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