# Uživatelská Příručka: NexusTables

Vítejte v Nexustables – hybridní stolní hře na hrdiny, která spojuje fyzický svět u jednoho stolu s digitálním doprovodem ve vašem prohlížeči. Tato příručka popisuje všechny herní mechanismy a provede vás použitím aplikace.

---

## 0. Zabezpečení, Účet a Registrace
Předtím než vstoupíte do světa, musíte mít vytvořený a ověřený účet. Naše platforma staví na striktních pravidlech slušnosti a morálky.
- **Ověření e-mailu:** Každý nový uživatel musí po registraci potvrdit svůj účet kliknutím na odkaz ve svém e-mailu. Do té doby mu systém neumožní přístup do Menu ani do Hry.
- **Lokální Filtr Přezdívek:** Integrovali jsme neprůstřelný filtr vulgarit a vyhrazených slov. Je zakázáno registrovat se s jakýmkoliv urážlivým nebo vulgárním jménem.
- **Zero Tolerance Policy:** Jakékoliv snahy obejít ochranu a zakládat světy či účty porušující morální kodex vedou k okamžitému trvalému smazání účtu, a to bez varování a bez náhrady.

---

## 1. Pro Pána Jeskyně (Dungeon Master)

Jako DM máte plnou kontrolu nad herním světem, pravidly i svými hráči. Aplikace je vaším hlavním nástrojem pro vyprávění příběhu a udržování atmosféry.

### Založení Kampaně (Wizard)
1. **Menu a Výběr:** Po přihlášení klikněte na `CREATE WORLD`. Otevře se vizuální 5krokový průvodce (Wizard).
2. **Krok 1 - Základy:** Zadáte Název světa, maximální počet hráčů a povolení AI botů.
3. **Krok 2 - Žánr:** Zvolíte základní pilíř světa (Fantasy, Cyberpunk, Lovecraft atd.). Určuje vizuál a styl vyprávění.
4. **Krok 3 - Tón a Obtížnost:** Chcete temný, krvavý příběh plný smrti (Grimdark & Hardcore), nebo heroickou komedii, kde se hrdinové nemohou trvale zranit?
5. **Krok 4 - Délka a Multiverzum:** Zvolíte, zda jde o klasickou session na jeden večer, nebo Async hraní po chvilkách. Zároveň určíte, zda je svět Privátní, nebo Veřejný v kánonu ostatních hráčů.
6. **Krok 5 - Potvrzení:** DM vygeneruje instanci. Automaticky se přejde do Lobby. Hra vygeneruje 6místný **PIN**, který sdělíte hráčům.

### Ústřední Obrazovka na Stůl (TV Plátno)
Při hře "u stolu" doporučujeme na velké obrazovce (např. tablet, notebook nebo TV uprostřed stolu) otevřít kampaň v prezentačním režimu.
- **Zpuštění TV:** TV plátno spustíte z hlavní nabídky přes **Světy** -> sekce **SPUSTIT TV PLÁTNO**. Zadáte 6místný PIN a obrazovka se automaticky přepne do režimu zobrazení (Host View) bez nutnosti přihlášení.
- **Funkce:** Běží zde interaktivní plátno s mapou. Ukazuje se zde velký QR kód pro hráče a promítají se sem vizuální efekty a události ze hry. Mapou lze hýbat nakláněním zařízení (Gyroskopický Parallax).
- **Audio Overlay (Povolit Zvuky):** Před prvním spuštěním ambientní hudby a efektů se na displeji objeví plovoucí okno žádající povolení přehrávání zvuku (nutnost prohlížečů). Po kliknutí je plně aktivována podkresová hudba i SFX.
- **Nezávislost na DM:** Otevření TV nijak neomezuje Pána Jeskyně – ten se do hry standardně připojí svým mobilem, kde má plnohodnotný ovládací panel.
- **Kinematografická Prezentace:** Během čekání na hráče TV Mód cyklicky promítá vizitku světa, dynamicky vykreslovaný Lore "Typewriter" efektem a detaily o Padouchovi, to vše s jemnými magickými částicemi na pozadí.

### Lobby pro Hráče a Správce (Připojování, Role a Pozvánky)
- **Generování Rolí (Postav):** Když AI vygeneruje svět (za doprovodu interaktivní Pixel Art animace), vytvoří i několik jedinečných Herních Postav přímo na míru danému příběhu. Tyto postavy se zobrazí hráčům v Lobby, kde si je mohou rozebrat.
- **Zvaní Hráčů a Chat:** Správce i hráči mají v Lobby k dispozici plnohodnotný **Chat**, kde si mohou domluvit role. Zprávy se navíc bezpečně uchovávají pro pozdější přesun do samotné hry. U volných pozic je také tlačítko `POZVAT`, které slouží k zaslání kódu přátelům.
- **AI Boti:** Pokud si nikdo nechce vzít nějakou vygenerovanou roli, může Správce kliknout na tlačítko `+ AI BOT`. Role se ihned obsadí botem, který se stane plnohodnotnou postavou ve světě a umožní spustit hru (vhodné i pro sólo hraní).
- **Správa Postav:** Správce může kliknutím na ikonu vedle jména hráče natvrdo změnit jeho roli, zablokovat jej, nebo případně pomocí rudého tlačítka `KICK` hráče okamžitě z místnosti vyhodit.

### Herní Panel pro DM
Po spuštění hry se dostáváte do DM ovládacího panelu.
- **Tension Pool (Míra napětí):** Tlačítky `+` a `-` upravujete Napětí v místnosti od 0 do 100%. Čím vyšší napětí, tím zlověstnější tep (audio heartbeat) a vizuální efekty se u hráčů spustí. Zvyšujte ho před velkou bitvou nebo při plížení temnou chodbou.
- **Global Event:** Pomocí textového pole nastavíte událost ("Začalo pršet", "Slyšíte řev draka"). Okamžitě se to objeví na TV a telefonech všech hráčů.
- **Správa hráčů:** Vidíte seznam hráčů. Můžete upravovat jejich HP ikonkami plus a minus, nebo jim přes ikonu oka poslat privátní Šepot.
- **God Mode a Pán Loutek:** Panel obsahuje speciální moduly. Můžete sesílat blesky a zemětřesení, nebo využít funkci "Pán Loutek" a napsat hlášku do chatu za jakékoliv NPC (např. "Temný Rytíř").
- **Hráčské akce:** Panel loguje vše, co hráči dělají. Vidíte zde i jejich hody kostkou. Historie je omezena na 50 posledních akcí.
- **Uložit a Pauznout:** Vytváří tzv. *Session Persistence*. Kampaně se ukládají lokálně (i do Firebase databáze). Pokud potřebujete hru přerušit, kliknete na `ULOŽIT A PAUZNOUT`. Všichni hráči jsou navráceni do Lobby a mohou aplikaci zavřít. Následně ji v menu najdete v sekci "Moje Kampaně" a můžete ji kdykoliv obnovit.
- **Rituál Času / Fate Roll:** Spustí pro celou místnost interaktivní hlasování, nebo epický náhodný hod osudu, který překryje obrazovky všech hráčů krví a vyzve je k hodu. Může zachránit nebo zničit celou partu.

---

## 2. Meta-progrese, Tržiště a Editor Hrdiny

Aplikace kromě hraní samotného obsahuje rozsáhlý systém meta-progrese, díky kterému získáváte odměny napříč všemi odehranými kampaněmi. Cílem není jen přežít jedno sezení, ale rozvíjet svůj účet.

### Tržiště a Nexus Coins (NC)
Za aktivitu a účast ve hrách získáváte herní měnu – **Nexus Coins (NC)**. Tyto mince lze na **Tržišti** směnit za různé položky:
- **Třídy (Archetypy):** Speciální hrdinové s unikátními schopnostmi a vyššími základními staty.
- **Předměty:** Startovní vybavení, které si hráč může vzít s sebou do každé kampaně (meče, lektvary atd.).
- **Moduly (Světy):** Pán Jeskyně může zakoupit nová dobrodružství, mapy a hudební podkresy. Odemknuté moduly pak může zvolit při zakládání nové místnosti (Wizard).
- **Kosmetika (Šatník):** Tituly, kostky a unikátní rámečky kolem avatara, kterými se odlišíte od ostatních v Lobby.

### Můj Hrdina (Editor Postavy)
Každý hráč má svůj sdílený profil hrdiny v sekci **Můj Hrdina**.
- Zde si zvolíte svůj Archetyp (k dispozici jsou výchozí Muž/Žena zdarma).
- Můžete sledovat úroveň své postavy (**Mastery Level**) a aktuální Zkušenosti (XP).
- V Editoru je rovněž možné nasadit si jedno zakoupené "Startovní vybavení" (např. meč nebo lektvar), jehož statistiky se přičtou k základním hodnotám Archetypu.

### Kosmetika a Šatník
Vaše kosmetické úpravy najdete v sekci **Můj Profil** -> **Šatník**. Můžete si zde libovolně vybavovat odemčené rámečky, kostky a tituly. Změny se ihned propíší do všech částí aplikace, kde je vidět vaše jméno.

---

## 3. Pro Hráče (Player)

Hráči se připojují pomocí svých mobilních telefonů. Váš telefon je vaším deníkem, kostkami i inventářem.

### Připojení do Hry
1. V menu zadejte 6místný **PIN** dodaný vaším Pánem jeskyně (nebo naskenujte QR kód z centrální obrazovky).
2. Zadejte jméno postavy a vyčkejte na schválení (pokud je vyžadováno).
3. Do menu přibyla složka **Moje Kampaně**. Jakmile se jednou do hry připojíte, uloží se vám zde pro snadné navrácení, i když hru vypnete. Uvidíte u ní rovnou i její stav (Probíhá, Lobby, Pauza).

### Herní Obrazovka na Mobilu
- **Avatary a HP:** V horní liště vidíte své HP a ikonku avatara. 
- **Multiboxing (Více Postav):** Pokud jste si vzali více rolí (např. při Solo hraní, nebo pokud ovládáte více postav), kliknutím na vaše jméno v záhlaví vysunete **Přepínač Postav**. Jakákoliv následná akce, stav inventáře nebo ztráta HP se počítá pouze u právě zvoleného hrdiny.
- **In-Game Chat:** V pravém dolním rohu obrazovky visí zlaté plovoucí tlačítko chatu. Pokud vám někdo napíše, rozbliká se na něm červená bublina s upozorněním. Po kliknutí se vysune panel konverzace, ve kterém můžete zprávu přečíst, odepsat, a panel opět zasunout.
- **Akční pole a D20:** Do textového pole popisujete, co vaše postava dělá (např. "Hledám tajné dveře"). Vedle je ikonka kostky D20 pro ověření šance na úspěch. Výsledek se pošle DM.
- **Šepot (Whisper Box):** Pán jeskyně vám může poslat privátní tajnou zprávu (např. "Cítíš vůni krve. Ostatní ne."). Tato zpráva se objeví ve stylizovaném rámečku s ikonou oka. Nikdo jiný ji nevidí.
- **Rituál Krve (Blood Ritual):** Pokud jste ve složité situaci, můžete stisknout kapku krve. Tím nevratně obětujete 10 HP za získání speciální herní výhody. Očekávejte grafické defekty a varovnou animaci!
- **Inventář:** Tlačítkem vespod otevřete svůj inventář. Obsahuje ukázkové předměty jako *Léčivý lektvar* a speciální *Krvavou dýku* – zbraň s Egem, která na vás občas sama "křičí", jelikož má vlastní mysl.

---

## 4. Technické a Atmosférické Mechaniky pod Kapotou

Aplikace využívá sérii pokročilých "next-level" efektů pro maximální zahuštění atmosféry bez nutnosti instalovat jakoukoliv aplikaci:

### Zvukové Efekty (Web Audio API)
- **Web Audio Heartbeat:** Jakmile DM zvedne Tension Pool nad 50 %, ozve se pulzování srdce. Frekvence se exponenciálně zrychluje s blížící se 100% mírou napětí.
- **Dynamic Audio Ambience:** Na pozadí hry se spouští zlověstný syntetický dron. Jak DM zvyšuje napětí, tento temný vítr nabývá na hlasitosti a "otevírá se" přes zvukový filtr.
- **Audio Jump Scares:** Když vám Pán Jeskyně pošle tajný Šepot (Whisper Box), ve sluchátkách se vám ozve krátký, tichý a velmi nepříjemný zvuk z náhodné strany, aby vás znejistil.
- **Typing Sound:** Když DM aktualizuje událost v místnosti, doprovází ji mechanické klapání psacího stroje.

### Vizuální Efekty a Animace (CSS + JS)
- **Interactive Particle Dice:** Kliknutím na tlačítko hodu D20 z něj vyletí drobné částice. Při "Critical Success (20)" prší zlaté jiskry a při "Critical Failure (1)" rudé.
- **Screen Shake & Hit Pause:** Při extrémních hodech kostkou (20 nebo 1) či obětování životů se vám silně zachvěje celá obrazovka mobilu doprovázená zamrznutím obrazu (Hit Pause) pro AAA herní odezvu.
- **Blood Vignette (Krvavá Opona):** Pokud klesne hodnota vašich životů (HP) pod 30, okraje vašeho displeje se zbarví doruda a začnou pulzovat jako varování před blížící se smrtí.
- **Panic UI:** Přesáhne-li napětí v místnosti 100 %, samotné texty herního rozhraní začnou nervózně vibrovat v nekonečné panické micro-animaci.
- **Floating Damage Numbers:** Během Rituálu Krve odletí animované krvavé číslo `-10` rovnou z vašeho ukazatele zdraví směrem nahoru, jako ve videohře.
- **Reality Warp (SVG Glitch):** Rituál Osudu vyvolá v místnosti grafický defekt zprostředkovaný hardwarově akcelerovaným SVG filtrem (`feDisplacementMap`), díky čemuž se prostředí roztřese a zdeformuje.
- **Volumetrické efekty a Mlha (Host View):** Zobrazení mapy pro stůl je prostoupeno animovanou procedurální mlhou (Perlin noise) a objemovými paprsky světla (God rays). Plátno se celkově naklání díky efektu plynulého dýchání kamery (Camera Drift).
- **Particle System:** Na Host obrazovce padají z nebe částice popela, jejichž barva a kadence se řídí úrovní napětí (Tension).
- **OLED UI & Neon Bloom:** Uživatelské rozhraní na mobilu využívá čistě černou barvu (Pure Black) s jemnými neonovými odlesky kolem zdraví a mincí pro perfektní vizuál na moderních displejích.
- **Gyroskopický Hologram (Inventář):** Vzácné předměty a ego-zbraně v inventáři hází světelné odlesky podle toho, jak fyzicky nakláníte svůj mobilní telefon (využití senzorů DeviceOrientation).
- **Cursor Blood Trail:** Pán Jeskyně manipulující s myší po centrální obrazovce občas na "papír" upustí pixelovou kapku krve, která za sebou zanechá stékající stopu.
- **Ego Weapon Pulzování:** Předměty označené jako *Ego zbraň* na hráče útočí i z inventáře. Text "*NAKRM MĚ KRVÍ!*" u prokleté dýky pulzuje střídavě v purpurových a rudých barvách.

### Real-time a Persistence
- **Real-time synchronizace (Firestore):** Celý přenos dat (akce, změny zdraví, šepoty) běží s nulovým zpožděním přes Firebase. Nemusíte stránku obnovovat, hra se hraje čistě "live".
- **Bezpečnost Relace (State Persistence):** I v případě pádu prohlížeče o nic nepřijdete. Systém ukládá vaše spojení do paměti prohlížeče (Local Storage) a Firebase eviduje "Last Active". Příště vás hra okamžitě nasměruje zpět na váš stůl.

## 4. Světy a Klonování (Multiverzum)

Aplikace funguje jako rozsáhlé sdílené multiverzum. Díky tomu se nemusíte vždy spoléhat na generování zbrusu nového světa.

### Veřejné Kánony
- Pokud při zakládání místnosti zvolíte v posledním kroku **"Veřejný Kánon (Public)"**, vaše kampaň se stane součástí globálního archivu v sekci **Světy** (odkaz `🌍 SVĚTY` v hlavním menu).
- Zde mohou **všichni uživatelé** (i nepřihlášení) procházet databázi stávajících her. Vidí vizitky obsahující název, žánr, tón a příběhový úvod (Lore).

### Klonování (Pro registrované)
Líbí se vám nějaký svět a chtěli byste si ho zahrát se svou partou? Můžete jej adoptovat! Po kliknutí na `ZOBRAZIT DETAIL` má přihlášený uživatel k dispozici dvě možnosti:
1. **ČISTÝ ZAČÁTEK (Clean Start):** Vygeneruje se zbrusu nová oddělená místnost, která kompletně převezme původní Příběh, Padoucha a seznam herních Postav (Rolí). Mapa je čistá, Napětí je nulové. Jste Pánem Jeskyně zbrusu nové instance.
2. **ODŠTĚPENÍ REALITY (Fork):** Chcete navázat v půlce příběhu? Tato volba zkopíruje i **aktuální nakreslenou mapu** a **aktuální hodnotu Napětí (Tension Pool)**. Původní hrdinové na mapě zůstanou, ale ztratí ovládání svých původních reálných hráčů a stanou se z nich tzv. "Boti" s dochovaným počtem životů (HP) a jmény. Vy je pak v novém Lobby můžete "vnutit" svým přátelům a nechat je dohrát příběh!

## 5. DM Nástroje (Pokročilé Funkce a Finále Webové Verze)

Kromě základní práce s napětím a osudem má Pán Jeskyně (DM) v rámci plnohodnotné webové verze k dispozici sadu mocných administrátorských nástrojů:

### Dynamický Systém Inventáře
- **Přidělování předmětů:** Vedle každého hráče v "Správě hráčů" je tlačítko balíčku `[📦]`. Kliknutím může DM okamžitě vytvořit hráči předmět, specifikovat, zda je k léčení, a definovat jeho popis.
- **Používání:** Hráči vidí svůj inventář po kliknutí na tlačítko "INVENTORY". Jakmile použijí např. léčivý lektvar, okamžitě se jim obnoví zdraví a předmět zmizí. Systém na to upozorní prostřednictvím Toast notifikace.

### Vyhodnocování Tahových Akcí (Rychlá zpětná vazba)
- V DM panelu "Hráčské Akce" vidí Pán Jeskyně vše, co hráči napisí, včetně výsledku jejich hodu D20.
- Lze okamžitě kliknout na tlačítko **[ÚSPĚCH]** (zelené) nebo **[NEÚSPĚCH]** (červené). Tím hra hráči tajně pošle upozornění (Whisper) o výsledku a v případě chyby ho ihned potrestá ztrátou 5 HP. Lze použít i přímý Šepot **[WHISPER]** pro narativní dobarvení situace.

### God Mode (Rozšířené VFX & SFX Ovládání)
V sekci God Mode může DM napříč celou sítí všem aktivním zařízením i centrální mapě vyvolat jeden z kritických vizuálních a zvukových efektů:
- **Zemětřesení:** Rozvibruje na moment celou UI strukturu na všech mobilech.
- **Hrom / Blesk:** Krátce problikne celá obrazovka oslnivou bílou v doprovodu děsivého zvukového výboje blesku.
- **Blackout:** Úplná, absolutní tma na všech připojených zařízeních na zhruba 2 sekundy (např. pokud zhasnou louče).

### Kreslení do "Mlhy Války" (DM Mapování)
- DM vidí na svém telefonu malé interaktivní kreslící plátno. Když po něm přejede prstem, tahy se vykreslí a v absolutním reálném čase přenesou na centrální "TV Host" obrazovku přímo doprostřed mlhy.
- Kreslí se ostrým zeleným tahem připomínajícím staré radarové displeje.
- Pomocí tlačítka **[VYMAZAT]** lze okamžitě mapu vyčistit a začít kreslit nové patro dungeonu.

## 5. Herní Režimy, Audio Management a HD-2D Vizuál
Finální webová verze hry zahrnuje komplexní zpracování vizuální stránky a chytré směrování audia, aby nedocházelo k ozvěnám, když hrajete fyzicky v jedné místnosti.

### HD-2D Phaser.js Mapa
- O rendering centrální mapy a postav se na TV obrazovce Hostitele stará plnohodnotný WebGL herní engine (Phaser 3).
- **Křišťálový pixel-art:** Engine využívá dedikovaný Light2D pipeline. Znamená to, že ačkoliv jde o retro grafiku (Pixel Art), vrhají plameny a postavy dynamické vržené stíny.
- Centrální obrazovka se navíc jemně naklání na základě polohy telefonu Hostitele pomocí integrovaného gyroskopu (Parallax).

### Audio Modality a Chování Zvuku
Při založení hry v Průvodci volí Hostitel jeden z **Herních režimů**:
1. **Režim "U Stolu" (Tabletop):** Globální hudba (Ambient), zvuky hromu, útoků i hlas umělé inteligence hrají **pouze** z centrálního zařízení (např. z reprosoustavy u televize). Klientské mobily hráčů jsou naopak pro globální události potichu. Mobily do sluchátek reprodukují pouze "soukromé zvuky" – například děsivý ASMR šepot Pána Jeskyně, který slyší jen daná oběť.
2. **Režim "Vzdáleně" (Remote):** Ideální pro hru přes Discord. Veškeré globální zvuky i soukromé šepoty si přehrává každý hráč sám na svém zařízení.
3. **Režim "Hybrid":** Slouží pro namixovanou skupinu (někdo u stolu, někdo doma). Zvuky se chovají primárně vzdáleně, ale každý hráč si je může upravit.

### Audio Panel Hráče
Ať už se hraje v jakémkoliv režimu, má každý hráč v záhlaví svého UI ikonu **[🎧]**. Ta otevře **Audio Nastavení**, kde si může lokálně na daném mobilu zapnout/vypnout:
- **Ambientní hudbu** (drony a hluboké tóny napětí).
- **SFX Efekty** (údery srdce, zemětřesení, hromy).
- **Hlas AI Vypravěče** (TTS syntézu).
- **Soukromé Šepoty** (cílené jump scare efekty do vlastního telefonu).

## 6. Divácký Režim (Panteon) a Hardcore Mechaniky

### Panteon (Spectator Mode)
Pokud se chce uživatel pouze dívat na probíhající kampaň bez aktivní účasti, může využít Divácký režim:
- Na hlavní obrazovce stačí po zadání PINu kliknout na **"VSTOUPIT JAKO DIVÁK (PANTEON)"**.
- Divák je okamžitě přesměrován do hry v roli nezviditelněného pozorovatele.
- V tomto režimu je hráčské rozhraní skryto (chybí házení kostkou, inventář, chat) a divák pouze v klidu sleduje dění, hody ostatních a mapu, aniž by zasahoval do chodu kampaně.

### Pytlík Osudu (Fate Bag)
Pro hráče vyhledávající extrémní zážitky obsahuje hra mechaniku Pytlíku osudu:
- **Tahání Run:** V hráčském rozhraní vedle D20 kostky je tlačítko s ikonou Křišťálové koule 🔮. Jeho stisknutím si hráč naslepo vytáhne z Pytlíku osudu runu (Zlatá, Krvavá, Černá atd.).
- **Následky:** Runa se propíše do veřejného logu. V případě vytažení Krvavé nebo Černé runy systém vyvolá vizuální a zvukový "Jump Scare" efekt otřesu obrazovky.
- **Správa DM:** Pán jeskyně může Pytlík osudu v sekci God Mode kdykoliv obnovit do původního stavu pomocí tlačítka "RESET PYTLÍKU OSUDU".

## 7. Sémantický Crafting a Oživlé Zbraně (Ego Weapons)

### Sémantický Crafting
Hráči mají možnost kreativně rozšiřovat svůj inventář pomocí propojení s umělou inteligencí:
- V UI hráče (pod tlačítkem `INVENTORY`) se nachází sekce **✨ SÉMANTICKÝ CRAFTING**.
- Po rozkliknutí může hráč do textového pole slovně popsat, o co se pokouší (např. *"Spojím svůj měč s pavoučím jedem, který jsem našel v lahvičce."*).
- AI Vypravěč tento požadavek ihned vyhodnotí a vygeneruje zcela nový unikátní předmět (včetně vhodné ikony, popisku a případně léčivého potenciálu).
- Nový předmět je okamžitě natrvalo zapsán do hráčova inventáře.

### Oživlé Zbraně (Ego Weapons)
Pokud hráč pomocí craftingu (nebo vygenerováním místnosti) vytvoří dostatečně zlověstný nebo magický předmět, umělá inteligence mu vdechne život a vznikne takzvaná **Ego zbraň**:
- **Požírání duší (zabití):** Ego zbraně mají vlastní skryté statistiky. Kdykoliv DM vyhodnotí akci hráče, který takovou zbraň vlastní, jako "ÚSPĚCH", zbraň se "nakrmí krví" a zaznamená se jí další úroveň zabití (kill count).
- **Hlad a Šepot:** Tyto předměty vyžadují pravidelnou akci. Pokud hráč provede úspěšný útok, zbraň se nasytí. Jestliže ovšem uběhnou více než 2 minuty bez úspěšného "nakrmení" a hráč otevře inventář, Ego zbraň k němu promluví.
- **Asymetrický šepot:** Zbraň si sama vynutí pozornost prostřednictvím soukromé zprávy zaslané přímo do **Whisper Boxu** (např. *"Tvá zbraň se chvěje a šeptá do tvé mysli: Nakrm mě... dlouho jsem nepila krev..."*). Tento děsivý zážitek je exkluzivní pouze pro držitele zbraně.

## 8. Záchranné Brzdy a Hardcore Tresty (Fáze 7)

Tato fáze přináší do hry kritické mechanismy pro řešení okrajových, smrtelných a nestandardních situací.

### 1. Skutečný Rituál Času (Hlasování a Fantomová Ráma)
- V extrémních situacích (např. Napětí = 100%) může Pán Jeskyně navrhnout **Rituál Času**.
- Odesláním návrhu z God Mode se všem živým hráčům objeví na obrazovce **Hlasovací Modal**.
- Pokud hráči jednohlasně souhlasí, Pán Jeskyně může hru vrátit v čase nebo odvrátit zkázu.
- Daní za tento rituál je však takzvaná **Fantomová rána**. Náhodný žijící hráč trvale ztratí 20 bodů ze svých Maximálních HP jako oběť za roztříštění časoprostoru.

### 2. Disconnect Protocol (Opuštění hry)
- Systém nyní monitoruje aktivitu každého hráče (odesílání zpráv, hody kostkou).
- Pokud je hráč **neaktivní po dobu delší než 2 minuty**, u jeho jména v seznamu hráčů u Hostitele se objeví rudý štítek `OFFLINE`.
- V takovém případě má Pán Jeskyně k dispozici tlačítko `TO BOT`, kterým může spícího hráče okamžitě odpojit a převést jeho postavu na NPC Bota, čímž uvolní hratelný slot pro případného náhradníka.

### 3. Předání Duše (Soul Transfer po smrti)
- Smrt ve hře NexusTables nemusí znamenat konec zábavy pro hráče. Pokud postava klesne na `0 HP`, obrazovka se promění na rudé vizuální peklo a objeví se zpráva "Zemřel jsi".
- V rámci Modalu smrti má mrtvý hráč možnost **Posednout schránku**. Zobrazí se mu seznam všech aktuálně volných NPC / Botů ve hře.
- Výběrem jednoho z nich hráč okamžitě "předá svou duši" (Soul Transfer), získá jeho jméno, inventář a historii a může pokračovat ve hře.

### 4. Karmický Systém (Probabilistická mitigace)
- Hra skrytě pomáhá těm, od kterých se odvrátilo štěstí.
- Pokud hráč hodí kostkou třikrát za sebou hodnotu **5 nebo méně**, aktivuje se u něj tajný buff "Karmická rovnováha".
- Obdrží 10 HP zpět a jeho další odeslaná akce vůči AI má garantovaný epický úspěch. Systém zároveň diskrétně upozorní DM o této záchraně (hráč obdrží Whisper "Osud se nad tebou slitoval...").

## 9. Rozšířená AI, Smysly a Záznamy (Fáze 8)

V této fázi byl umělé inteligenci přidělen větší prostor k vyprávění a řízení atmosféry světa. Zároveň byly rozděleny AI modely na základě jejich síly a zaměření:
*   **Gemini 3.5 Flash:** Extrémně rychlý model používaný pro vyhodnocování okamžitých akcí, generování sémantického vybavení a rychlého shrnutí ("Catch-up").
*   **Gemini 3.1 Pro Preview:** Kognitivně silný model s hlubokým uvažováním, využívaný pro ty nejnáročnější úkoly – tvorbu světů s detailním lore a sepisování knižní kroniky. Zajišťuje, že příběhy a detaily jsou naprosto "bez kompromisů".

### 1. Kniha Jízd (Epická Kronika)
- Historie událostí se už neztrácí v historii. Pán Jeskyně má nyní v God Mode panelu magické tlačítko **VYGENEROVAT KRONIKU**.
- Toto tlačítko vezme všechny izolované hráčské akce a hodí je do superpočítače Gemini 3.1 Pro, který z nich poskládá soudržnou, strhující a knižně napsanou kapitolu příběhu.
- Tuto Kroniku si následně mohou všichni hráči kdykoli otevřít tlačítkem **KRONIKA** ve svém herním rozhraní.

### 2. Smart Catch-up (Zatímco jsi spal...)
- Odpojil ses, šel sis pro pití, nebo ses vrátil ke stolu po delší pauze?
- Pokud hra zaznamená, že jsi byl offline déle než 2 minuty a mezitím se událo více než 5 významných akcí, automaticky při načtení obrazovky vygeneruje okno **Zatímco jsi spal...**
- V něm tě AI Vypravěč ihned stručně a atmosféricky shrne, co se během tvé nepřítomnosti odehrálo, abys mohl okamžitě naskočit do děje.

### 3. Schrödingerovy Smysly (Paranoia Engine)
- Pán Jeskyně nyní vlastní mocný nástroj v God Mode panelu: **SESLAT SMYSLOVOU STOPU**.
- Jedno jediné kliknutí, a AI vygeneruje děsivou halucinaci, podivný pach nebo znepokojivý zvuk (např. *"Zezadu cítíš něčí studený dech... ale nikdo tam není"*).
- A to nejdůležitější: Tuto stopu systém asymetricky zašle tajnou Whisper zprávou **jen jednomu náhodně vybranému hráči**. Ostatní nic nevidí ani neslyší. Výsledkem je instantní a naprosto geniální stolní paranoia!

## 10. Panteon, Ekosystém a Multiverzum (Fáze 9)

Tato fáze posouvá hru z lokálního sezení na propojený ekosystém světů s novými vrstvami pro komunitu a diváky.

### 1. Panteon (Divácký Režim s Frakcemi)
- Divácký režim již není jen pasivním sledováním. Diváci se stávají bohy zasahujícími z Panteonu!
- Při vstupu do cizí rozehrané hry ze Světů (tlačítko **"VSTOUPIT JAKO DIVÁK (PANTEON)"**) si divák zvolí, jakou frakci bohů reprezentuje: **Bůh Války**, **Bůh Chaosu**, nebo **Bůh Zdraví**.
- Ve svém herním rozhraní divák nesleduje inventář a neposílá akce. Místo toho má tlačítko **SESLAT MODLITBU**, na které může se specifickým cooldownem klikat.
- Hra na pozadí shromažďuje modlitby všech diváků dané frakce. Jakmile barometr víry jedné z frakcí dosáhne 50 bodů, vůle bohů se hmatatelně manifestuje do hry:
  - **Bůh Války:** Vyšle krvavý trest; náhodný živý hráč nečekaně ztratí 10 HP.
  - **Bůh Zdraví:** Sešle vlnu požehnání; všichni žijící hráči si vyléčí 10 HP.
  - **Bůh Chaosu:** Roztrhá nebe a vyvolá bouři; vzroste Napětí o 20 % doprovázené VFX zásahem blesku a hromem.

### 2. Hřbitovy v Kánonu (Persistentní Scars)
- Pokud hráč během herní seance zemře (jeho HP klesnou na 0), jeho oběť není zapomenuta. 
- Systém do kánonu světa na pozadí uloží jeho **Náhrobek** se jménem, rolí a časem úmrtí.
- Pokud se následně kdokoliv v sekci Světy rozhodne daný svět naklonovat (či už *Clean* nebo *Fork* klonováním) a vstoupit do něj se svou vlastní družinou, **jizvy z minulosti přetrvávají**.
- Při vstupu do takto naklonovaného světa AI oznámí všem novým hráčům varování (např. *"Kráčíš po půdě, kde zahynulo dříve [počet] hrdinů"*). Představuje to jedinečný prvek asynchronního multiplayeru napříč servery.

### 3. Tržiště Archetypů (Příprava Ekosystému)
- V hlavním menu pod Světy byla přidána brána do **Tržiště**.
- Toto je nově tvořený prostor pro pokročilý komunitní obsah, kde si hráči v budoucnu budou moci za herní měnu (Nexus Coin) odemykat prémiové, temné, nebo silně utilitní role (např. *Posedlý*, *Chronomág*, *Alchymista* nebo *Krvavý Šaman*), jež znatelně ovlivňují možnosti jak Sémantického Craftingu, tak i řešení příběhových situací.

## 11. Monetizace a Ekonomika (Fáze 10)

Hra nyní obsahuje plně funkční ekonomický model založený na prémiové měně **Nexus Coins (NC)**. Zavedení tohoto systému otevírá cestu k meta-progresi napříč světy.

### 1. Uživatelská Peněženka
- Po přihlášení každý uživatel uvidí ve svém Profilu svůj aktuální zůstatek mincí (např. `💎 0 NC`).
- Tento stav se automaticky ukládá do databáze a je vázán na profil hráče.

### 2. Pseudo-platební Brána
- Z Tržiště má hráč možnost kliknout na `DOBÍT COINY`.
- Tím se otevře modál "NEXUS BANKA", simulující platební bránu (fiktivní zadávání kreditní karty).
- Po potvrzení transakce proběhne falešný schvalovací proces a na účet uživatele se okamžitě připíše 500 NC.

### 3. Nákup Archetypů (Mikrotransakce)
- Archetypy na Tržišti již nejsou pouhými ukázkami, ale dají se plnohodnotně nakupovat!
- Systém v reálném čase vyhodnotí, zda má hráč dostatek NC.
- Pokud ano, kliknutím na `KOUPIT ZA [X] NC` se daná částka strhne, a Archetyp získá štítek `ZAKOUPENO`. Tím se trvale odemkne v hráčově seznamu vlastněných položek (`unlockedArchetypes`).

## 12. Pán Jeskyně jako Loutkář (Fáze 11)

Abyste jako DM mohli ještě lépe utvářet atmosféru a vžít se do roleplaye, představujeme funkci **Puppet Master**.

### 1. Změna Identity
- V DM panelu najdete novou sekci **Pán Loutek (Poslat zprávu jako...)**.
- Místo pouhé úpravy globálního textu máte nyní možnost psát přímé vzkazy s vlastní Identitou. Do pole *Identita* zadejte jméno libovolného NPC (např. "Temný Rytíř", "Hlas ze tmy", "Krvavý nápis na zdi").

### 2. Zobrazení a Imerze
- Jakmile odešlete zprávu s vyplněnou identitou, objeví se ihned na Hostující obrazovce (Panteon/TV) uprostřed jako důležitý **Globální Event**, zformátovaný např.: `Temný Rytíř: "Tady vaše cesta končí..."`.
- Zároveň se spustí automatický **AI TTS Vypravěč**, který zprávu přečte nahlas dramatickým hlasem.
- V logu akcí na DM panelu bude tato zpráva odlišena tmavě fialovou barvou a prefixem `🎭 LOUTKÁŘ: [Identita]`, abyste měli přehled o všech svých "hereckých" vstupech.

## 13. Solo / Coop Režim s AI (Bez Pána Jeskyně)

Aby si hru mohli užít i hráči bez dedikovaného Pána Jeskyně (nebo aby se ulevilo DM od vymýšlení drobností), disponuje NexusTables vysoce autonomní AI, která zastoupí chybějící prvky:

### 1. AI Vyhodnocování Akcí
- Zadejte akci do formuláře na svém telefonu a odešlete ji i bez hozené kostky.
- Umělá inteligence okamžitě (v reálném čase) vyhodnotí pravděpodobnost úspěchu, vygeneruje narativní výsledek a rovnou sjedná následky.
- Úspěšný nebo neúspěšný hod na vás může okamžitě vrhnout ztrátu HP (zranění se odečte automaticky).
- Vše se zobrazí ve formě epické **Cinematic Action Card** přímo na obrazovce hráče, odpadá tak čekání na schválení DMkem.

### 2. Sémantický Crafting (Alchymie)
- V inventáři klikněte na tlačítko **✨ SÉMANTICKÝ CRAFTING**.
- Pokuste se spojit dvě libovolné suroviny z inventáře. AI posoudí jejich reaktivitu a fyzikální vlastnosti.
- Při úspěchu AI rovnou vymyslí a zanese nový legendární předmět nebo EGO zbraň do vašeho inventáře.
- Při selhání experiment vybuchne a vy automaticky ztratíte cenné životy.

### 3. Můj Osud (Individuální Quests)
- Jakmile si v Lobby zvolíte roli, AI na pozadí vygeneruje tajný a unikátní příběhový úkol (např. *'Najdi prastarý krystal a ochraň ho'*).
- Tento úkol vidíte ve svém herním rozhraní pod tlačítkem **MŮJ OSUD**.
- Ostatní hráči se po vašem připojení pouze dozvědí v chatu tajemnou notifikaci *(Hráč X přijal tajemný osud...)*.
- Během hraní zapisujete své činy do chatu. Jakmile usoudíte, že jste úkol splnili, kliknete na **OVĚŘIT SPLNĚNÍ (AI)**.
- Umělá inteligence pročte celou Kroniku (historii akcí) a zhodnotí, zda jste osud skutečně naplnili. Pokud ano, odmění vás 20 Nexus Coins a do chatu vyšle slavnostní prohlášení.

### 4. Boss Fight Mód (Finální Zúčtování)
- Napětí (Tension) se už nezvyšuje jen tak. Jakmile dosáhne **100 %**, hra automaticky přechází do **Boss Fight** režimu!
- Barometr napětí zčervená a promění se v **HP Bar Finálního Bosse**.
- AI ihned vytvoří jméno Bosse a úvodní text hrozby.
- Všechny další bojové akce (odevzdané do chatu) posuzuje AI jako útoky proti Bossovi. Při úspěchu strhne systém Bossovi reálné HP a posune HP bar na obrazovce, dokud Boss nezemře.

## 14. Závěr Hry, Konec Epické Výpravy a Prémiová Kronika (Fáze 12)

Když je hra dohrána do samotného finále a hlavní hrozba (Boss) je poražena, rozbíhá se sekvence událostí, která odmění hráče a zachová historii.

### 1. Vítězství a Odměna
- Ve chvíli, kdy padne Boss, se hra přepne do stavu **Dokončeno (Completed)**.
- Všem na obrazovce se zjeví masivní epický modal VÍTĚZSTVÍ, shrnující průběh výpravy a přeživší hrdiny.
- Z modalu si každý živý ne-AI hráč může vybrat odměnu `5 NC` (Nexus Coins) a zároveň je vyzván ohodnotit zážitek ze hry pomocí interaktivního slideru (1-10).

### 2. Globální Statistiky (Rating a Hranost Světů)
- Každý svět uchovává svou statistiku. V záložce **Světy** na profilové vizitce každé hry vidíte počet spuštění (zahrání), počet úspěšných dokončení a průměrné hodnocení hráčů.
- Pokud je svět vyklonován, ať už pro čistý průběh nebo odštěpení (Fork), hra to pozná a veškeré dohrání a skóre propíše i na konto **původního světa**, což tvoří sociální uznání tvůrcům úspěšných scénářů.

### 3. Prémiová Ilustrovaná Kronika (Za 150 NC)
- Závěrečná obrazovka Vítězství poskytuje DM (zakladateli světa) magickou možnost: **VYGENEROVAT KNIHU (150 NC)**.
- Jde o prémiovou funkci. Tlačítko pošle všechny nedávné záznamy kampaně pokročilému AI (Gemini 3.1 Pro Preview). To je přetvoří v poutavé vyprávění rozdělené do 3 až 5 kapitol.
- Každé kapitole je vygenerována detailní 16-bitová grafická ilustrace (Pixel Art). 
- Kniha je **natrvalo zapsána do historie světa**. V záložce **Světy** se po kliknutí na detail zobrazí fialové tlačítko **📖 PŘEČÍST KRONIKU SVĚTA**, takže si kdokoliv z komunity může přečíst vaši vygenerovanou Legendu, obohacenou o atmosférické ilustrace!

## 15. Interaktivní Průvodce a Registrace
Ihned po úspěšné registraci (a ověření e-mailu) jsou noví hráči přivítáni komplexním Průvodcem. 
Tento průvodce slouží jako odrazový můstek do složitějších mechanik NexusTables.

### 1. První krůčky (Checklist)
- Po dokončení registrace je hráč přesměrován na svůj Profil (na záložku **📖 Průvodce**).
- V interaktivním akordeonovém seznamu se nachází **8 klíčových úkolů**, např.: Zvolení archetypu hrdiny, změna kosmetiky (šatník), klonování veřejných světů, využití Sémantického Craftingu přes AI a spuštění TV módu.
- Každý dokončený úkol tiše přidělí na konto hráče **5 NC** jako malou odměnu.

### 2. Poutník Multiverzem (Finální Odměna)
- Po úspěšném odškrtnutí všech 8 bodů se seznam transformuje ve zlatou herní truhlu 🎁.
- Hráč si jejím otevřením navíc přičte **20 NC** (celkem si z průvodce odnese 60 NC do začátku) a odemkne exkluzivní herní titul: **Poutník Multiverzem**.

## 16. Komplexní Týmová Dynamika a Statusy (Fáze 13)

Tato fáze přidává pokročilé RPG prvky zaměřené na interakci mezi hráči, frakce a záludnosti uvnitř družiny.

### 1. Skrytý Zrádce (Traitor Mode)
- Při zakládání světa má Pán jeskyně možnost povolit mechaniku **Skrytý zrádce**.
- Pokud je zapnuta, hra tajně (a zcela náhodně) přidělí jednomu z hráčů atribut *Zrádce* společně s unikátním záškodnickým osobním osudem (Můj Osud).
- Zrádce má svůj panel "MŮJ OSUD" podbarvený temně rudě, zatímco ostatní hráči mají standardní fialový.
- AI Vypravěč na pozadí ví, kdo je zrádce a bedlivě sleduje, jak zrádce jedná proti týmu. Pokud je hráč podezřelý, svět na to může reagovat!

### 2. Týmový Sémantický Crafting
- Při použití **✨ SÉMANTICKÉHO CRAFTINGU** již nejste odkázáni jen na svůj vlastní inventář.
- V modálním okně si můžete zvolit jiného hráče z party (pokud žije) a zkombinovat svůj předmět s jedním z jeho předmětů!
- **Pozor:** Oběti craftingu (vy i váš spojenec) o dané suroviny okamžitě přijdou. Výsledný mocný předmět ovšem spadne do inventáře VÁM (iniciátorovi). AI vyhodnotí, co spojením vašich sil vzniklo.

### 3. Dynamické Stavy (Status Engine)
- Vyhodnocení vašich akcí může nyní vést k zisku negativních i pozitivních Stavů, o kterých rozhoduje AI na základě situace.
- Například můžete začít **Krvácet (🩸)**, být **Otráveni (🧪)** nebo **Hořet (🔥)**, případně můžete být oslněni či omráčeni.
- Tyto stavy se ihned objeví u vašich životů v podobě ikon a trvají určitý počet kol (akcí).
- Hra sama kontroluje ubíhání vašeho času – aktivní jedy a ohně vám po každé další akci automaticky snižují HP (např. -2 HP za kolo), dokud stav nevyprchá!

### 4. Systém Renomé a Frakce (Faction Reputation)
- Vaše družina si svým jednáním buduje vztahy se světem. AI sleduje, komu pomáháte a komu ubližujete.
- V klientském rozhraní se nově nachází tlačítko **⚖️ FRAKCE**. Zde vidíte seznam všech frakcí, měst nebo společenství, se kterými jste přišli do styku.
- Každá akce družiny (např. urážka krále, záchrana vesničanů) mění hodnotu Renomé. Ikony i barvy u frakcí se vyvíjí od nepřátelské (červená 👿) přes neutrální až po obdivnou (zelená 😎). AI na tyto reputace reaguje při vyhodnocování šancí na úspěch při vyjednávání!

## 17. Metaprogrese a Personalizace (Fáze 14)

### 1. Zkušenosti a Mastery Level
- Za každého poraženého Finálního Bosse získáte **100 XP** (zkušeností).
- Ve vašem Profilu naleznete ukazatel Mastery Levelu a Progress bar do další úrovně (každá úroveň = 1000 XP).

### 2. Aktivní Vybavení (Loadout) a Premium Moduly
- Z Tržiště můžete získat perzistentní předměty a prémiové světy.
- V sekci **Aktivní Vybavení** ve vašem Profilu si můžete do každé nové hry připnout 1 startovní artefakt, který se okamžitě objeví ve vašem inventáři při startu hry.
- **Premium Moduly:** Při vytváření nové hry (Create World) se v nabídce Žánrů objeví vaše zakoupené moduly. Můžete hrát kampaně plné skriptovaných dějů.

### 3. Aplikace Kosmetiky (Šatník) a Síň Slávy
- Kosmetika jako Zlaté nebo Krvavé rámečky či speciální hrací kostky se po vybavení propisuje v reálném čase do všech her (v Lobby, do 3D/2D animací atd.).
- **Síň Slávy:** Podařilo se vám zabít bosse s 1 HP? Vycraftili jste Ego zbraň? Naklonoval někdo váš svět? Tato významná dějství sledujeme a odměňujeme vás exkluzivními odznaky ve vašem Profilu!

## 18. Závěrečné obrazovky, Smrt a Kronika (Fáze 15)

### 1. Obrazovka po úmrtí hráče (Death Screen)
- Pokud klesnou HP hráče na 0 (nebo méně), hráč se stává "Mrtvým".
- Obrazovka se zatáhne krvavým full-screen překryvem s nápisem **💀 YOU DIED**.
- Mrtvý hráč od tohoto okamžiku nemůže odesílat příkazy do chatu, nicméně má stále přístup k "Limbu", ze kterého může po dohodě s Pánem Jeskyně posednout jiného bota/NPC a vrátit se do hry.

### 2. Závěrečná obrazovka (Victory Screen) a Hodnocení
- Poražením finálního bosse se všem hráčům spustí epická Vítězná obrazovka.
- Zobrazí se statistiky hry (počet přeživších, celkový počet akcí) a automaticky obdržíte **5 NC** za úspěšné zdolání dungeonu (pouze živí hráči).
- **Hodnocení:** Přímo z této obrazovky mohou hráči na slideru 1-10 ohodnotit zážitek ze světa. Toto hodnocení se následně počítá do globálních statistik kánonu.

### 3. AI Kronika (Kniha Průběhu Hry)
- Na Vítězné obrazovce naleznete tlačítko **Zvěčnit příběh v Kronice**.
- Zkrze integraci AI (Gemini 3.1 Pro Preview) dojde k vygenerování obsáhlé příběhové knihy (kapitola po kapitole) z reálné historie chatu, včetně pixel-art ilustrací (Imagen).
- **Cena je dynamická:** Odvíjí se od množství akcí (minimálně **250 NC**).
- Kniha se následně trvale uloží ke kánonu a bude čitelná přes archiv v sekci Světy.

### 4. Statistiky Světů (Archiv kánonů)
- V hlavním menu v sekci **Světy** můžete procházet jakékoliv existující kampaně. U každé vidíte tyto sledované ukazatele:
  - **Hráno:** Kolikrát byl svět odštěpen / klonován.
  - **Dohráno:** Kolikrát byla v tomto světě a v jeho klonech dosažena vítězná obrazovka.
  - **Hodnocení:** Globální průměr hodnocení hráčů.

## 19. Administrace Systému
NexusTables obsahuje skrytou administrační sekci pro majitele a vyvolené hráče.
- **Přístup:** Do administrace má přístup pouze uživatel s rolí `admin` přes tajnou url `/admin.php`.
- **Funkce Administrace:**
  - **Přehled:** Statistiky hráčů, mincí a světů. Možnost migrace tržiště.
  - **Uživatelé:** Seznam všech registrovaných hráčů. Možnost přidělovat a odebírat Zůstatky (NC) nebo povyšovat hráče na administrátory.
  - **Světy:** Přehled běžících místností (živé kampaně) s možností neaktivní instance rovnou smazat.
  - **Editor Tržiště:** Vkládání nových předmětů, kosmetiky, rolí a modulů přímo z webového prohlížeče (zápis ihned do databáze Firestore).
