managarten/apps/figgos/FEATURES.md

Figgos — Game Features

Game Idea

Figgos ist ein AI-powered Collectible Figure Game. User erstellen personalisierte Action-Figuren im Toy-Packaging-Stil — realistische Spielzeugverpackungen mit Karton-Rueckwand, Plastik-Blister und Zubehoer. Die Figuren koennen alles sein: man selbst, Freunde, Fantasy-Charaktere, Promis — egal was. Jede Figur hat ein Rarity-Level, Artefakte/Items und eine Hintergrundgeschichte. Figuren koennen gegeneinander kaempfen oder miteinander gemercht werden um neue Figuren zu erzeugen.

---

Core Features

1. Figure Generation

User erstellt eine neue Action Figure in Toy-Box-Verpackung.

Inputs:

• Foto/Gesicht (optional — fuer personalisierte Figuren)
• Name (Pflicht)
• Beruf / Rolle / Beschreibung (Pflicht)
• Accessoire-Items (optional, bis zu 4-6 Stueck)
• Accessoire-Bilder (optional — KI recreated diese exakt im Bild)
• Special Styling (optional — Farben, Themes, Hintergrund)

AI Pipeline:

1. Text-KI generiert Character-Info:
   • Description + Lore
   • 3 Artefakte/Items (je mit Name, Description, Lore)
   • Style-Description fuer Bild-Generierung
2. Rarity wird gewuerfelt (oder vom User gewaehlt)
3. Bild-KI generiert die Figur in Toy-Box-Verpackung:
   • Karton-Rueckwand mit Name + Titel
   • Plastik-Blister mit Figur
   • Items/Accessoires um die Figur arrangiert
   • Professionelles Produktfoto-Rendering
4. Bild wird in S3 gespeichert
5. Figur wird in DB gespeichert

Output:

• Fertige Figur mit: Toy-Box-Bild, Name, Rarity, Character-Info, 3 Items

---

2. Battle

Zwei Figuren treten gegeneinander an.

Konzept:

• User waehlt eigene Figur + Gegner-Figur (aus Community oder eigener Sammlung)
• KI analysiert beide Figuren (Stats, Items, Rarity) und simuliert einen Kampf
• Ergebnis: Kampfbericht + Gewinner + ggf. generiertes Battle-Bild
• Rarity beeinflusst die Kampfstaerke (Legendary > Epic > Rare > Common)
• Items/Artefakte geben Boni

Details zur Battle-Mechanik (Rundenbasiert? Automatisch? Stats-System?) noch zu definieren.

---

3. Merge

Zwei Figuren werden zu einer neuen Figur verschmolzen.

Konzept:

• User waehlt zwei eigene Figuren zum Mergen
• KI kombiniert Eigenschaften beider Figuren:
  • Visuell: Neues Toy-Box-Bild als Mix beider Figuren
  • Character-Info: Merged Lore + kombinierte Items
  • Rarity: Chance auf hoeheres Rarity-Level als die Eingangsfiguren
• Ergebnis: Neue, einzigartige Figur
• Originalfiguren bleiben erhalten (oder werden verbraucht? — zu definieren)

Details zur Merge-Mechanik noch zu definieren.

---

4. Figure Detail View

Detailansicht einer einzelnen Figur.

• Grosses Toy-Box-Bild
• Rarity-Badge (farbig)
• Character-Info:
  • Description
  • Lore / Hintergrundgeschichte
• 3 Items/Artefakte (je mit Name, Description, Lore)
• Like-Button + Like-Count
• Share-Funktion
• Creator-Attribution
• Aktionen: Battle starten, Merge starten

---

5. Collection / Shelf

Eigene Figurensammlung.

• Grid-Ansicht aller eigenen Figuren
• Rarity-Badges sichtbar
• Sortierung: Neueste zuerst
• Filter: nach Rarity
• Archivieren (Soft-Delete)
• Schnellzugriff auf Battle / Merge von hier aus

---

6. Rarity System

Rarity	Chance	Farbe	Effekt auf Generierung
Common	60%	Grau	Standard-Detaillevel
Rare	25%	Blau	Mehr Details in Lore + Items
Epic	12%	Lila	Elaborierte Beschreibung, besondere Items
Legendary	3%	Gold	Maximale Detailtiefe, einzigartige Items

• Beeinflusst KI-Generierung (hoehere Rarity = aufwaendigere Figur)
• Beeinflusst Battle-Staerke
• Beeinflusst Merge-Ergebnis (hoehere Chance auf Upgrade)
• Visuell: Badge-Farben, Card-Border-Effekte, ggf. Glitter/Glow

---

7. Settings / Profile

• Dark/Light Mode
• Theme-Auswahl
• Account-Info
• Logout
• Figuren-Statistiken (Anzahl, Raritaeten-Verteilung)

---

Spaetere Features

Feature	Beschreibung
Community Feed	Oeffentliche Figuren aller User, Likes, Sortierung
Reveal	Reveal-Mechanik beim Erhalten neuer Figuren (Unboxing-Animation?)
Credits	Generierung kostet Credits, Free Tier + kaufbare Pakete
Trading	Figuren zwischen Usern tauschen
Challenges	Woechentliche Themes ("Erstelle eine Legendary Pirate Figure")
Leaderboards	Ranglisten: meiste Legendaries, Battle-Wins, etc.
Web App	SvelteKit Web-Version

---

Datenmodell

Figure

id: UUID
name: string
subject: string
imageUrl: string
enhancedPrompt: string (optional)
rarity: 'common' | 'rare' | 'epic' | 'legendary'
characterInfo: {
  character: { description, imagePrompt, lore }
  items: [{ name, description, imagePrompt, lore }]  // 3 Items
  styleDescription?: string
}
stats: {                    // fuer Battle-System
  attack: number
  defense: number
  special: number
}
parentFigures: UUID[]       // leer bei generierten, gefuellt bei gemergten
isPublic: boolean
isArchived: boolean
likes: number
userId: string
createdAt: timestamp
updatedAt: timestamp

FigureLike

id: UUID
figureId: UUID (FK -> figures)
userId: string
createdAt: timestamp
UNIQUE(figureId, userId)

Battle (spaeter)

id: UUID
figure1Id: UUID (FK -> figures)
figure2Id: UUID (FK -> figures)
winnerId: UUID (FK -> figures)
battleLog: JSONB
userId: string
createdAt: timestamp

Merge (spaeter)

id: UUID
parent1Id: UUID (FK -> figures)
parent2Id: UUID (FK -> figures)
resultFigureId: UUID (FK -> figures)
userId: string
createdAt: timestamp