Files
novafarma/docs/GRAVITY_GENERATION_README.md
2026-01-20 01:05:17 +01:00

213 lines
5.4 KiB
Markdown

# 🎨 GRAVITY BATCH GENERATION - DolinaSmrti Assets
**Created:** 30.12.2025 02:47
**Status:** ✅ ACTIVE - ComfyUI/Ufi DISCONTINUED
---
## 🚀 NOVA STRATEGIJA
### **Staro (DISCONTINUED):**
- ❌ ComfyUI lokalni server (`127.0.0.1:8000`)
- ❌ Ufi workflow
- ❌ Kompleksna konfiguracija
- ❌ Tehnični problemi
### **Novo (ACTIVE):**
-**Gravity** (Antigravity AI generate_image tool)
- ✅ Direktna generacija preko asistenta
- ✅ Enostavna kontrola kvalitete
-**Gritty Noir** stil konsistenca
---
## 🎯 Art Style: "Gritty Noir Hand-Drawn 2D Stylized Indie"
### Ključne Značilnosti:
```
✅ Bold black outlines (1.4x emphasis)
✅ Gritty noir aesthetic (1.2x emphasis)
✅ Flat colors, muted palette
✅ Exaggerated features
✅ Warped perspective, wonky proportions
✅ Mature post-apocalyptic vibe
✅ Don't Starve inspired
✅ High contrast noir elements
✅ TRANSPARENT background PNG
```
### Negative Prompt (Kar NE želimo):
```
❌ Pixel art, pixels
❌ 3D rendering, realistic photo
❌ Shading gradients
❌ Disney style, cute kawaii
❌ Bright colors
❌ Background elements, text, watermark
```
---
## 📊 Asset Registry Overview
Na podlagi `DODATNA_VSEBINA_REGISTRY_V1.14.md`:
| Kategorija | Št. Assetsov | Primeri |
|:---|---:|:---|
| **Buildings** | 19 | Church, Workshop, Barn, Farmhouse, Store... |
| **Workstations** | 10 | Furnace, Vape Lab, Sprinklers... |
| **Items** | 40+ | Bows, Arrows, Tools, Resources, Food... |
| **Živali** | 30+ | Livestock, Wildlife, Marine, Dogs, Slimes... |
| **Mutanti** | 15+ | Zombies, Werewolves, Mythical creatures... |
| **Bosses** | 7 | Mutant King, Troll King, Fire Dragon... |
| **Environment** | 20+ | Crops, Trees, Graves, Rocks, Portals... |
| **UI** | 12+ | Health bar, Icons, Buttons... |
| **TOTAL** | **~150+** | (Base set, expandable) |
---
## 🛠️ Kako uporabljati
### **Opcija 1: Interaktivno (Priporočeno za testiranje)**
Preprosto povejte Antigravity asistentu:
```
"Generiraj mi [asset_name] v Gritty Noir stilu"
```
Primer:
```
"Generiraj mi church_ruined building"
```
Asistent bo:
1. ✅ Ustvaril pravilen prompt z Gritty Noir stilom
2. ✅ Generiral sliko z generate_image
3. ✅ Shranil v `/assets/images/buildings/church_ruined.png`
---
### **Opcija 2: Batch Generation (Za mass production)**
1. **Review script:**
```bash
cat /Users/davidkotnik/repos/novafarma/scripts/generate_gravity_batch.py
```
2. **Povejte asistentu:**
```
"Zaženi batch generation vseh assetsov iz generate_gravity_batch.py"
```
3. **Asistent bo:**
- Prebral seznam vseh assetsov
- Za vsakega ustvaril pravilen prompt
- Generiral slike ena za drugo
- Shranil v pravilne direktorije
- Posodabljal progress
---
## 📁 File Structure
```
/Users/davidkotnik/repos/novafarma/
├── assets/
│ └── images/
│ ├── buildings/ ← 19 buildings
│ ├── workstations/ ← 10 workstations
│ ├── items/ ← 40+ items
│ ├── zivali/ ← 30+ animals
│ ├── mutanti/ ← 15+ mutants
│ ├── bosses/ ← 7 bosses
│ ├── environment/ ← 20+ env objects
│ └── ui/ ← 12+ UI elements
├── scripts/
│ └── generate_gravity_batch.py ← Batch generator
└── GRAVITY_GENERATION_README.md ← Ta dokument
```
---
## ✅ Prednosti Gravity sistema
| Feature | ComfyUI/Ufi | Gravity |
|:---|:---:|:---:|
| Setup kompleksnost | ❌ Visoka | ✅ Preprosta |
| Stil konsistenca | ⚠️ Variabilna | ✅ 100% |
| Kvalitetni control | ❌ Ročni check | ✅ Interaktiven review |
| Troubleshooting | ❌ Težko | ✅ Enostavno |
| Batch processing | ✅ Da | ✅ Da |
| Iteration hitrost | ⚠️ Počasno | ✅ Hitro |
---
## 🎨 Primer Generacije
### Input (Command):
```
"Generiraj zombie_brown_dreads v Gritty Noir stilu"
```
### Generated Prompt:
```
zombie brown dreads, mutant creature, zombie character, monster enemy,
(bold black outlines:1.4), dark hand-drawn stylized indie game asset,
(gritty noir aesthetic:1.2), flat colors, muted color palette,
exaggerated features, warped perspective, wonky proportions,
mature post-apocalyptic vibe, Don't Starve inspired,
high contrast noir elements, transparent background PNG
```
### Output:
```
/assets/images/mutanti/zombie_brown_dreads.png
```
---
## 📝 Naslednji Koraki
### **Prioriteta 1: Test Generation** ✅ NEXT
1. Testirajte 5-10 random assetsov iz različnih kategorij
2. Review kvalitete in stil konsistence
3. Adjust prompt če potrebno
### **Prioriteta 2: Batch Generation**
1. Zaženite batch generation celega registryja (~150 assetsov)
2. Monitor progress
3. Review batch quality
### **Prioriteta 3: Integration**
1. Import slik v game
2. Test v Tiled
3. Animation sequences
---
## 🐛 Troubleshooting
### Problem: "Slike nimajo transparentnega ozadja"
**Rešitev:** Dodajte "transparent background PNG" v prompt (že included)
### Problem: "Stil ni konsistenten"
**Rešitev:** Preverite da je STYLE_PROMPT enak v vseh generacijah
### Problem: "Asset ni pravilen"
**Rešitev:** Regenerirajte samo ta asset z bolj specifičnim promptom
---
## 📞 Support
Za vprašanja ali troubleshooting, preprosto vprašajte Antigravity asistenta! 🤖
---
**Last Updated:** 30.12.2025 02:47
**By:** Antigravity AI Assistant
**Status:** 🟢 READY FOR PRODUCTION