časť 37
Z Hero Dice na Avatar: žetón, ktorý sa točí, slider prilieb a nastavenie pohybu
Výraz Hero Dice sa nepreložil ani po slovensky; 1. novembra 2026 sa z neho stal Avatar v deviatich jazykoch. Rokgard dostal v rohu žetón namiesto cudzej kocky, žetón sa točí, prilby sú slider. Jednu skutočnú chybu našiel až dôkaz proti starému kódu.
Dňa 1. novembra 2026 pribudli do hry Audamir vydania 0.80.1 a 0.81.2, ktoré menia jednu vec: ako sa ukazuje hráčov hrdina. Výraz Hero Dice sa pre hráča volá Avatar. Rokgard (Kolónia a Čiary; do 31. októbra Taflgard) mal v rohu kocku Kastgardu. Teraz tam je žetón vo farbe hráča, ktorý sa preklápa ako minca, točí sa aj na domovskej obrazovke a dá sa otáčať rukou. Premenovanie je malé: sedem textov v deviatich jazykoch. Väčšina výskytov starého názvu, 686 riadkov v 141 súboroch, má zostať ako história. Nastavenie, ktoré hovorí, či sa avatar točí, by bez dôkazu proti starému kódu odmietlo každý uložený snapshot hry.
Meranie a názov: sedem textov z 686 riadkov
Požiadavka z 1. novembra 2026 je v docs/DESIGN.md §126 doslova: „We use the phrase Hero Dice in Slovak too. I want to rename it to avatar or something more fitting (hero face / icon / avatar); the name is the same for all realms.“ Zásada „jeden názov vo všetkých jazykoch“ ostala, mení sa slovo. docs/HERO-DICE.md (časť 3) z 19. októbra zahodil slovenský pracovný názov Hrdinská kocka. Zoznam zmien hry (vydanie 0.22, 20. októbra) k tomu dodáva, že slovenské nastavenie rozprávača odteraz hovorí „Hero Dice“ namiesto prekladu.
Pred zmenou git grep -i "hero dice" vo verzii 0.77.3 našiel:
| Kde | Riadkov | Súborov |
|---|---|---|
js/ | 338 | 71 |
docs/ | 239 | 24 |
tests/ | 66 | 34 |
tools/ | 15 | 10 |
README.md a style.css | 28 | 2 |
| Spolu | 686 | 141 |
Skoro všetko sú komentáre a mená histórie („Hero Dice H2“, modul HeroDice). To, čo číta hráč, je menej: osem kľúčov katalógu a dvanásť riadkov zoznamu zmien (jedenásť je text starších vydaní). V index.html, manifeste, sw.js a package.json výraz nie je. Sedem kľúčov sa zmenilo, jeden ostal:
| Kľúč | Pred (sk) | Po (sk) | Prečo |
|---|---|---|---|
core.settings.avatar.label | „Hero Dice v rohu“ | „Avatar v rohu“ | platí pre každé cárstvo |
core.settings.narrator.label | „Komentáre Hero Dice“ | „Komentáre avatara“ | hlas je spoločný |
core.settings.narrator.values.off.desc | „Hero Dice mlčí.“ | „Avatar mlčí.“ | to isté |
core.chain.hero_level.desc | „Dosiahni v Hero Dice úroveň {n}.“ | „Dosiahni s hrdinom úroveň {n}.“ | úroveň patrí hrdinovi |
kastgard.campaign.act.1.text | „…potrebuje Hero Dice a jej spoločníkov“ | „…potrebuje hrdinskú kocku a jej spoločníkov“ | dej je Kastgardu, jeho hrdina je kocka |
kastgard.campaign.camp.story | „Z východu prichádza Hero Dice“ | „Z východu prichádza hrdinská kocka“ | to isté |
kastgard.campaign.tal.intro | „úroveň Hero Dice žiadne nedáva“ | „úroveň hrdinu žiadne nedáva“ | úroveň patrí hrdinovi |
core.changelog.v0_10_0.hero | „Hero Dice: …“ | nezmenené | záznam o starom názve vydania 0.10 |
Slovo „Avatar“ používa kód už dnes (Avatar, .avatar, kľúč nastavenia) a pomenúva obrázok v rohu, nech je to kocka alebo žetón. „Hero face“ a „Hero in the corner“ majú „hero“, čo je slovo pre osobu. Pracovný názov z 19. októbra sa vrátil jediným miestom: v deji kampane je „hrdinská kocka“ bežné podstatné meno, nie názov funkcie. Žiadny kľúč sa nepremenoval, takže migrácia nevznikla. Je to ten istý princíp ako pri premenovaní celej hry: identifikátor sa s názvom nemení.
Texty sú jedna tabuľka kľúč × jazyk (7 × 9 = 63 riadkov). Skript nahradil iba riadok každého starého textu; tools/i18n.js --import by prepísal celý súbor a zahodil by 33 starých komentárov. Commit s premenovaním má 21 súborov.
Prvá verzia dala nastavenie „Avatar v rohu“ na kartu Všetky cárstva. Pokyn z toho istého dňa to opravil: obrázok v rohu má hrdina každého cárstva, takže nastavenie patrí k oknu „Tvoj hrdina“ (karty nastavení opisuje článok o jednom okne). Uložený kľúč avatar je ten istý, takže ani tu nevznikla migrácia.
Rokgard mal v rohu cudziu kocku
Kolónia a Čiary mali dovtedy v rohu kocku Kastgardu, lebo aplikácia mala jediný avatar a nič nerozhodovalo o jeho podobe. Oprava je v dátach: manifest každého cárstva hovorí, aký je jeho hrdina (hero: { look: 'die' } pri Kastgarde, 'token' pri Rokgarde). Funkcia paintCornerHero v js/ui/app.js prečíta toto slovo a dá avatarovi setForm(look, { color }) s farbou ľudského miesta. Ani app.js, ani avatar.js nepomenúvajú cárstvo alebo tvar a test to kontroluje čítaním zdroja bez komentárov. Nové cárstvo sa zaregistruje slovom v manifeste, riadkom v tabuľke Avatar.FORMS a pravidlom v style.css.
Kocka (die) | Žetón (token) | |
|---|---|---|
| Cárstvo | Kastgard | Rokgard |
| Obrázok | CSS kocka, šesť stien s bodkami | 9 vrstiev v preserve-3d |
| Pokojová poloha | x −24°, y 32° | x −22°, y 28° |
| Otáčanie | 1 až 3 štvrťotáčky okolo jednej osi | pol otáčky okolo zvislej osi, sklon do ±12° od pokojového |
| Hlas | rozprávač | žiadny |
Obrázky ukazujú oba tvary v rovnakom čase a mierke. Kocka sa otáča štvrťotáčkami okolo jednej osi, žetón sa preklopí o pol otáčky ako minca. Čas je skrátený: v hre trvá jedno otočenie 3,4 s; farba žetónu je ukážková.


Žetón je disk z deviatich vrstiev (.slab) posunutých po osi z: dve vonkajšie majú lesk a prstenec, sedem medzi nimi je okraj, ktorý je vidieť pri naklonení. Farba je premenná --token a žetón má farbu hráča v tejto hre, nie farbu z profilu.
Pravidlá otáčania sú pre oba tvary rovnaké: nový náklon každých 5,2 až 8,2 sekundy (TURN_EVERY v js/ui/avatar.js), prechod 3,4 sekundy, vlastný semienkový generátor, žiadne otáčanie pri prefers-reduced-motion, pri skrytej záložke, počas ťažkej animácie dosky ani pri zloženom avatarovi. Žetón v rohu tvoria dva commity, statický (päta feature) a preklápanie (päta fix), aby sa animácia dala vziať späť samostatne.
Rokgard nemá hlas. Režimy Kolónie a Čiar majú hud.narrator: false; žetón je obrázok. Vypína ho aj nastavenie „Avatar v rohu“.
Točí sa aj doma, rukou a prilby sú slider

Ďalšie zadanie z 1. novembra (DESIGN §127) malo päť bodov: žetón Rokgardu na obrazovke Tvoj hrdina sa nedá točiť rukou, 21 prilieb má byť jeden riadok, žetón v paneli a v hube je statický a chýba nastavenie pohybu. Kto čo točil:
| Miesto | Čo ho točilo | Po zmene |
|---|---|---|
| Roh hry (kocka, žetón) | časovač v Avatar | nezmenené |
| Domov a hub Kastgardu (kocka) | jeden avatar, ktorý placeHero presúva | nezmenené |
| Domov a hub Rokgardu (žetón) | nič, holý span.token | avatar so spoločným časovačom |
| Obrazovka Tvoj hrdina (kocka) | iba ruka, FaceView.cube | FaceView.turnable |
| Obrazovka Tvoj hrdina (žetón) | nič, holý span.token | FaceView.turnable |
Kocka mala dva kódy točenia (časovač v Avatar, ruka vo FaceView) a žetón tri obrázky. Po zmene je jeden obrázok žetónu (Avatar.FORMS.token.make()), jedno točenie časovačom a jedno točenie rukou.
Na domovskej obrazovke a v hube drží aplikácia jeden avatar na cárstvo. Kocka je jeden avatar pre celú domovskú, lebo hovorí: jedna bublina, jeden hlas. Žetón nehovorí, preto stačí mapa podľa id cárstva. Avatar sa presúva z panelu do bloku hrdinu v hube ako kocka a tam, kde obrazovka nemá dlaždicu, sa zruší spolu s časovačom. Holý žetón dlaždice sa počas avatara schová; pri vypnutom „Avatar v rohu“ ostáva ako dovtedy. Kliknutie je „poke“ (počíta sa do tajného úspechu) a hub neotvorí. Panel cárstva opisuje článok o hlavnej stránke.
Točenie rukou je jedna funkcia FaceView.turnable: ťah myšou alebo prstom, šípky, Home a dvojklik. Kocka aj žetón majú vlastnú pózu počas otvorenej stránky a žetón má popis pre čítačku: „Tvoj žetón. Ťahaním alebo šípkami ho otáčaš; Home ho vráti späť.“
Prilby. Obrazovka ukazuje 21 tvarov prilby, jeden pre každý piaty bod povesti do 100 (článok o prilbe, DESIGN §118.2). Boli v mriežke (repeat(auto-fill, minmax(62px, 1fr))), teraz sú jeden riadok, .hero-slider: tlačidlo, zoznam, tlačidlo. Zoznam sa posúva vodorovne a prichytáva sa na stred (scroll-snap); odsadenie nechá na stred prísť aj prvú a poslednú prilbu. Prilba hráča je v strede hneď po vykreslení, takže od šírky okna nezávisí. Je to len obrázok: nič sa nevyberá a nič sa nevyhráva. Tlačidlá „Predchádzajúca/Ďalšia prilba“ sú na koncoch vypnuté, šípky posúvajú o jednu, Home a End idú na konce. Ťah prstom a koliesko robí prehliadač; myš ťahá riadok, ktorý sa po pustení usadí na najbližšej prilbe. Kroky kĺžu iba bez prefers-reduced-motion. Pasca: scroll-behavior: smooth kĺže aj pri scrollTo({ behavior: 'auto' }), preto prvý pohľad žiada 'instant'.
Nastavenie pohybu a chyba, ktorú ukázal dôkaz
Nastavenie Avatar motion (kľúč avatarMotion, hodnoty turning a still, predvolené je rotujúci) platí pre roh hry, kocku domovskej obrazovky a žetóny dlaždíc. Systémové prefers-reduced-motion má prednosť. Texty oboch nastavení majú všetkých deväť katalógov:
| Jazyk | Avatar v rohu | Pohyb avatara | Rotating / Static |
|---|---|---|---|
| en | Avatar in the corner | Avatar motion | Rotating / Static |
| sk | Avatar v rohu | Pohyb avatara | Rotujúci / Statický |
| cs | Avatar v rohu | Pohyb avatara | Rotující / Statický |
| sr | Avatar u uglu | Kretanje avatara | Okreće se / Miruje |
| ru | Аватар в углу | Движение аватара | Вращается / Неподвижен |
| es | Avatar en la esquina | Movimiento del avatar | Gira / Quieto |
| pt-br | Avatar no canto | Movimento do avatar | Gira / Parado |
| fr | Avatar dans le coin | Mouvement de l’avatar | Tourne / Fixe |
| de | Avatar in der Ecke | Bewegung des Avatars | Dreht sich / Ruhend |
Dve rozhodnutia z DESIGN §127.3 stoja za pozornosť. Statický znamená, že sa nič nehýbe samo, vrátane kliknutia: poke sa počíta, ale nič sa neotočí. A ruka hráča nie je pohyb avatara: kocka a žetón na obrazovke Tvoj hrdina sa dajú točiť aj pri Statickom. Popis to hovorí hráčovi: „Avatar stojí všade. Kocku alebo žetón môžeš aj tak otáčať rukou na obrazovke Tvoj hrdina.“
Pri tomto nastavení sa ukázala chyba. Nový kľúč v cfg nepísal starý kód, a preto zlyhal rad dôkazov, ktoré porovnávajú nový kód so starým (DESIGN §127.4): fixtúry starých nastavení, presety Kniežatstiev, zálohy so starou značkou, počty slovníka a štyri nástroje, ktoré púšťajú starý a nový kód vedľa seba. Stačilo naučiť, že avatarMotion je „neskôr“ a vynecháva sa na oboch stranách porovnania (tools/_support/later-settings.js). Jeden nástroj však neukázal pin, ale skutočnú chybu.
Oprava je malá: hashSnapshot v snapshot.js preskakuje nastavenia zo zoznamu HASH_SKIPS = ['avatarMotion'], lebo nastavenie vzhľadu nič z hry nereprodukuje. Test vyrobí starý snapshot (zmaže kľúč a prepočíta hash tak, ako ho starý build zapísal) aj starý súbor a overí, že sa čítajú s pôvodným hashom; zmenená veľkosť mapy sa odmietne ako predtým. Cena je v komentári: zmena avatarMotion sa hashom nezachytí. Pravidlo pre DESIGN: **nové nastavenie vzhľadu mení cfg každej hry** a čokoľvek, čo hashuje celé cfg, to musí vedieť.
Čo sa overilo a čo ostáva
Pečiatky overenia stromu v .git/verify-stamps (stav pred commitom verzie):
| Premenovanie a žetón (→ 0.80.1) | Pohyb avatara (→ 0.81.2) | |
|---|---|---|
| Testy | 3 725, prešlo 3 724, 1 preskočený | 3 735, prešlo 3 734, 1 preskočený |
Odtlačky bežných hier (baseline.js) | všetkých 188 sedí | všetkých 188 sedí |
| Zlaté záznamy | bajt po bajte rovnaké | bajt po bajte rovnaké |
| Migračné nástroje | 14 v poriadku | 14 v poriadku |
Texty na jazyk (i18n.js --check) | 3 831 | 3 839 (+8 kľúčov) |
Odovzdávacie poznámky oboch relácií dopĺňajú: pri premenovaní a žetóne sa skúšalo 18 a po oprave zadania 6 mutácií kódu, pri pohybe ďalších 18, vždy jedna naraz na kópii stromu, a všetky sa zachytili. Pri poslednej sade to bolo 16 hneď a dve prežili, kým sa ich testy neposilnili (jeden z nich bol práve hash snapshotu). Zo živého prehliadača: pri preklápaní sa rotateY menil 28° → 208° → 388° → 568°; slider mal prilbu „od 30“ v strede, tlačidlo „›“ posunulo o jednu (7 → 8), kláves End skočil na 21. prilbu a ťah myšou o 260 px posunul 21 → 18; Statický zastavil žetón na 13 sekúnd a Rotujúci ho znova rozhýbal. Na 375 px bol slider široký 219 px s tromi prilbami.
Čo ostáva:
- Žetón nehovorí. Rokgard nemá rozprávača.
- Žetón na dlaždici je pri vypnutom avatarovi holý. Nové cárstvo s iným tvarom hrdinu potrebuje riadok v
Avatar.FORMS, pravidlo v CSS a vlastný obrázok dlaždice.
Zdroje a poznámky
- Zadanie a rozhodnutia:
docs/DESIGN.md§126 a §127,docs/HERO-DICE.mdčasť 3. - Kód:
js/ui/avatar.js,js/ui/app.js,js/core/settings.js,js/realms/kastgard/games/stacks/core/snapshot.js. - Merania:
git grep -i "hero dice"a pečiatky overenia z 1. 11. 2026, len čítanie. - Súvisiace články: Ako sa hra volá, Hlavná stránka, Prilba, ktorá rastie, Jedno okno.
Čo sa nepodarilo overiť: GIF je z CSS hry vykresleného v prehliadači, nie zo živej hry; čas je skrátený a farba žetónu je ukážková. prefers-reduced-motion sa v živom prehliadači neemuloval; správanie dokazuje test a pravidlo v CSS. Dotykové potiahnutie slidera robí prehliadač a nikto ho neskúšal. Texty v cs, sr, es, pt-br a fr prešli kontrolou katalógu, ale nečítal ich rodený hovorca. Testy a hra sa pri písaní nespúšťali; počty sú z pečiatok a git grep.