Audamir

č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.

· 11 min čítania

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:

KdeRiadkovSúborov
js/33871
docs/23924
tests/6634
tools/1510
README.md a style.css282
Spolu686141

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árstvoKastgardRokgard
ObrázokCSS kocka, šesť stien s bodkami9 vrstiev v preserve-3d
Pokojová polohax −24°, y 32°x −22°, y 28°
Otáčanie1 až 3 štvrťotáčky okolo jednej osipol otáčky okolo zvislej osi, sklon do ±12° od pokojového
Hlasrozprá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á.

Kocka Kastgardu: štvrťotáčky okolo jednej osi
Kocka (Kastgard): štvrťotáčky okolo jednej osi
Žetón Rokgardu: pol otáčky ako minca
Žetón (Rokgard): pol otáčky ako minca

Ž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

Obrazovka Tvoj hrdina z 1. novembra 2026 (verzia 0.84): panel Kastgardu s kockou, panel Rokgardu so žetónom v hráčovej farbe, prilby v riadku s šípkami
Tvoj hrdina z 1. novembra 2026, verzia 0.84: každé cárstvo má vlastný panel; Kastgard kocku, Rokgard žetón v hráčovej farbe, ktorý zatiaľ nemá hlas

Ď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čiloPo zmene
Roh hry (kocka, žetón)časovač v Avatarnezmenené
Domov a hub Kastgardu (kocka)jeden avatar, ktorý placeHero presúvanezmenené
Domov a hub Rokgardu (žetón)nič, holý span.tokenavatar so spoločným časovačom
Obrazovka Tvoj hrdina (kocka)iba ruka, FaceView.cubeFaceView.turnable
Obrazovka Tvoj hrdina (žetón)nič, holý span.tokenFaceView.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:

JazykAvatar v rohuPohyb avataraRotating / Static
enAvatar in the cornerAvatar motionRotating / Static
skAvatar v rohuPohyb avataraRotujúci / Statický
csAvatar v rohuPohyb avataraRotující / Statický
srAvatar u ugluKretanje avataraOkreće se / Miruje
ruАватар в углуДвижение аватараВращается / Неподвижен
esAvatar en la esquinaMovimiento del avatarGira / Quieto
pt-brAvatar no cantoMovimento do avatarGira / Parado
frAvatar dans le coinMouvement de l’avatarTourne / Fixe
deAvatar in der EckeBewegung des AvatarsDreht 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)
Testy3 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áznamybajt po bajte rovnakébajt po bajte rovnaké
Migračné nástroje14 v poriadku14 v poriadku
Texty na jazyk (i18n.js --check)3 8313 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.