i;nint

AKO_HRAT.md

@@ -1,77 +1,89 @@
-# Ako Hrat PokerRogue (Prototyp)
+# Ako hrat PokerRogue (prototyp)
 
-PokerRogue je singleplayer hra, kde sa boj riesi pokerom.
-Kazde kolo boja je jedna poker handa.
+PokerRogue je singleplayer poker-combat hra. Kazda handa je jeden suboj.
 
 ## Ciel
 
 - Znizit HP nepriatela na 0 skor, ako nepriatel znizi tvoje HP na 0.
-- Boj trva obmedzeny pocet hand (`Hand X/Y` hore na obrazovke).
+- Boj ma limit hand (`Hand X/Y` v hornom paneli).
 
-## Zakladny priebeh
+## Priebeh handy (aktualna logika)
 
-1. Zobrazi sa tvoja ruka (2 karty), board (5 kariet) a zamer nepriatela.
-2. Vyberies akciu (`1`, `2`, `3`).
-3. Vyhodnoti sa handa:
-- kto ma silnejsiu kombinaciu, vyhrava handu,
-- podla Pot/Edge/Shield sa vypocita damage.
-4. Na 5 sekund sa ukaze showdown:
-- nepriatelove karty,
-- zlate obrysy vitaznej 5-kartovej kombinacie.
-5. Zacne dalsia handa.
+1. Dostanes 2 karty, nepriatel ma 2 karty, na stole je board 5 kariet.
+2. Rozhodujes sa po streetoch:
+- `Flop` (3 karty),
+- `Turn` (4 karty),
+- `River` (5 kariet).
+3. Na kazdom kroku vyberas akciu (`1` az `7`), okrem `Fold`, ktory handu okamzite ukonci.
+4. Po River sa z troch vybranych akcii vypocita finalna bojova akcia.
+5. Vyhodnoti sa showdown (najlepsich 5 zo 7 kariet), aplikuje sa damage.
+6. Vysledok ostane na obrazovke, pokracujes az po `Space`/`Enter`.
 
 ## Ovládanie
 
-- `1` = `Strike` (agresivne)
-- `2` = `Guard` (defenzivne)
-- `3` = `Dodge` (znizenie rizika)
-- `R` = restart boja
-- `Esc` = ukoncit hru
+- `1` = `Strike`
+- `2` = `Guard`
+- `3` = `Dodge`
+- `4` = `Check`
+- `5` = `Probe`
+- `6` = `All-In`
+- `7` = `Fold` (okamzite skonci handu)
+- `Space` / `Enter` = pokracovat po showdowne
+- `R` = novy run
+- `Esc` = koniec hry
 
 ## Co robia akcie
 
-### Strike (`1`)
+- `Strike`: `Pot +3`, `PlayerEdge +10`
+- `Guard`: `Shield +6`, `PlayerEdge +5`
+- `Dodge`: `Pot -2` (minimum 1), `Shield +2`
+- `Check`: `Shield +1`, `PlayerEdge +2`
+- `Probe`: `Pot +1`, `PlayerEdge +6`
+- `All-In`: `Pot +8`, `PlayerEdge +18`, `EnemyEdge +8`
+- `Fold`: okamzita prehra handy, ziskavas vacsi `Shield`, damage je znizeny oproti beznej prehre
 
-- zvysi `Pot`
-- zvysi tvoj `Edge`
-- vhodne, ked chces tlacit na vysoky damage
+## Edge a Shield (dolezite)
 
-### Guard (`2`)
+### Edge
 
-- prida `Shield`
-- mierne zvysi tvoj `Edge`
-- vhodne, ked cakas silny utok nepriatela
+`Edge` je percent bonus k damage:
 
-### Dodge (`3`)
+- ak vyhras handu ty: `EnemyDamage = Pot * (100 + PlayerEdge) / 100`
+- ak vyhra nepriatel: `RawPlayerDamage = Pot * (100 + EnemyEdge) / 100`
 
-- znizi `Pot` (mensie riziko aj odmena)
-- da mensi `Shield`
-- vhodne na stabilizaciu pri nevyhodnej hande
+Cim vyssi `Edge`, tym vacsie potencialne zranenie.
+
+### Shield
+
+`Shield` znizuje damage, ktory dostanes pri prehratej hande:
+
+- `PlayerDamage = max(0, RawPlayerDamage - Shield)`
+
+`Shield` sa pocita len pri damage do hraca v danej hande.
 
 ## Ako sa urcuje vitaz handy
 
-Hra vyhodnocuje najlepsiu 5-kartovu kombinaciu zo 7 kariet:
+Vyhodnocuje sa najlepsia 5-kartova kombinacia zo 7 kariet:
 
-- 2 hole cards + 5 board cards
+- tvoje 2 karty + 5 kariet na stole,
+- nepriatelove 2 karty + tych istych 5 kariet na stole.
 
-Porovnanie funguje ako v pokri:
+Porovnanie:
 
-1. najprv typ kombinacie (napr. Pair, Two Pair, Straight, Flush...)
-2. pri rovnakom type rozhoduju kickery
+1. Typ kombinacie (Pair, Two Pair, Straight, Flush, ...)
+2. Pri rovnosti rozhoduju kickery (rank vector).
 
-Panel vpravo ukazuje:
+## Vizualne pomocky v hre
 
-- nazov kombinacie hraca a nepriatela,
-- dovod vyhry/prehry,
-- vysledny vypocet damage.
+- Hore vpravo su animovane bary:
+- `Player Edge`,
+- `Enemy Edge`,
+- `Shield`.
+- Po showdowne su vitazne karty zvyraznene zlatym obrysom.
+- Nepriatelove karty sa odkryju pri showdowne.
 
-## Tipy pre zaciatok
+## Tipy
 
-- Ak mas dobru kombinaciu, casto sa oplati `Strike`.
-- Ak je nepriatel agresivny, `Guard` ti casto zachrani HP.
-- `Dodge` pouzi, ked nechces prehrat velky pot.
-- Sleduj zlate obrysy po hande, rychlo sa naucis, ktore karty rozhodli.
-
-## Poznamka k verzii
-
-Toto je prototyp. Balans, grafika a pravidla sa budu postupne menil.
+- Silna handa + vyssi `PlayerEdge` = velky tlak na HP nepriatela.
+- Pri riziku prehry pomaha `Guard`, `Check` alebo `Dodge` (kvoli `Shield`).
+- `Fold` je takticky ustupok: prehras handu, ale casto prezijes lacnejsie.