Audamir

časť 48

Ako vznikla stránka audamir.io a jej prepojenie s hrou

Z blogu o hre sa 1. a 2. novembra 2026 stal web s jazykmi, hlavnou stránkou, zoznamom zmien a kartou hráča medzi stránkou a hrou.

· 10 min čítania

Blog Kocky sú hodené bol do 1. novembra 2026 priečinok so štyridsiatimi súbormi Markdownu a šiestimi nástrojmi. Do 2. novembra večera z neho vznikol web audamir.io: hlavná stránka s tlačidlom PLAY, zoznam zmien hry, blog vo viacerých jazykoch, stránka 404, obrázok na zdieľanie a dohoda s hrou o tom, čo si stránka a hra vymieňajú. Tento článok hovorí, ako sa ktoré rozhodlo a prečo.

Z priečinka na web

Prvý commit repozitára z 1. novembra mal 40 článkov (01-dvadsat-rokov.md až 40-nahlady-v-nastaveniach.md), blog.json, planned.json, assets/ a šesť nástrojov. Žiadne jazyky, žiadna hlavná stránka, žiadne nasadenie.

Odpoveď na otázku, ako to urobiť viacjazyčne bez prepisovania, bola jedna veta: číslo článku je jeho identita vo všetkých jazykoch. Súbor sa volá posts/<jazyk>/NNN-slug.md, rovnaké číslo v inom jazyku je preklad toho istého článku. Slug sa môže líšiť, lebo adresa je /<jazyk>/blog/<NNN>-<slug>.html. Kontrola odmietne preklad bez originálu.

Číslo sa po zverejnení nemení, lebo je súčasťou odkazu, ktorý si niekto uloží alebo pošle ďalej. Kým je článok koncept, číslo sa dá zmeniť.

V blog.json je deväť jazykov, zapnuté sú dva (sk, en). Nový jazyk sa zapne v konfigurácii a dostane vlastný katalóg; kontrola odmietne katalóg, ktorému chýba kľúč.

Generátor je čistý Node bez závislostí (Node 18 a novší). Výstup sú statické súbory, na serveri netreba PHP ani Node. Stránky majú relatívne adresy, takže sa dajú otvoriť aj zo súboru.

Hlavná stránka a zoznam zmien

Hlavná stránka má popis, panel s tlačidlom PLAY, zástupný blok na video, posledné záznamy zoznamu zmien a šesť najnovších článkov.

Video sa nenačíta samo. Kým video.src v blog.json je prázdny, ukazuje sa zástupný blok; po vyplnení sa video načíta až po kliknutí. Poskytovateľ nie je rozhodnutý (YouTube bez cookies alebo vlastný súbor).

Zoznam zmien sa nepíše znova, číta sa zo zdroja hry. tools/changelog.js načíta js/data/changelog.js z repozitára hry (cesta gameRepo v blog.json). Stránka tak nemôže povedať iné než hra. Cena: zoznam sa číta v čase zostavenia, nie z nasadenej hry. Poistka je voľba --changelog-up-to (pri build:site --match-game), ktorá novšie záznamy skryje. Dnes (3. 11. 2026) skript vypísal varovanie: skopíroval hru 0.90.5, repozitár hry má 0.97.1. Zoznam má 88 záznamov a je po anglicky.

Ikona, ktorá je kópia

Ikona stránky je ikona hry (vikingská prilba na doske), od 1. novembra nahradila kocku.

  • Ikona je kópia, nie odkaz. Šesť súborov sa kopíruje príkazom npm run sync:icons, lebo stránka sa musí dať zložiť aj bez repozitára hry.
  • **Vloženie cez <img>, nikdy ako inline SVG.** Ikony hry majú vlastný <style>, ktorý by ovplyvnil celú stránku. Cena: SVG nevidí prepínač vzhľadu stránky. Pri zhode „systém svetlý, stránka ručne tmavá“ je v hlavičke svetlá dlaždica na tmavom pozadí. Čitateľné, nie dokonalé.

Panel PLAY ukazuje prilbu, kým hra nezapíše kartu hráča.

Karta hráča: malý dokument, nie prístup do hry

Stránka a hra sú na jednej doméne a zdieľajú localStorage. Stránka chcela ukázať, kto hrá: meno hrdinu, avatar a číslo, ktoré hovorí, ako ďaleko je. Rozhodnutie: jeden malý, verzovaný, tolerantne čítaný dokument, kľúč audamir.card, ktorý píše hra a číta stránka. Tvar je v docs/GAME-CARD.md.

Prečo nie čítať profil hry? Toto je odvodené z návrhu, nie citát z dokumentov:

  1. Stránka nemá načítať kód hry. Má byť statická, bez skriptov tretích strán. Čítať jeden kľúč je lacné, spustiť hru kvôli menu nie.
  2. Vnútro úložiska hry sa mení. Karta je tvar, ktorý sa drží stabilný a rozširuje sa len pridávaním polí.
  3. Karta je zhrnutie, nie zdroj pravdy. Keď sa stratí, hra ju znova zapíše z profilu; nič v hre ju nečíta (DESIGN §131.5).

Dôkaz na bod 2 prišiel o deň neskôr: hra 2. novembra premenovala predponu kľúčov z diceWars. na audamir.. Karta to nezasiahlo. Zasiahol jediný druhý kľúč, ktorý stránka číta, nastavenia hry (kvôli jazyku). Stránka ho musela hľadať pod oboma menami.

Prečo audamir.card a nie diceWars.card: karta je rozhranie k stránke, nie vnútorný stav hry. Hra nesmie nazvať žiadny svoj kľúč theme, lang ani card; test v tests/pages.test.js to stráži.

Čo karta nesie

Karta je JSON v1. Stránka toleruje chýbajúce aj neznáme polia.

PolePovinnéPravidlo čítania na stránke
vánoverzia tvaru, teraz 1
leveláno1 až 999; zobrazí sa, keď karta nemá platnú reputáciu
reputationniecelé číslo 1 až 9999; ak platí, panel ukáže reputáciu namiesto úrovne a pruhu XP
namenienajviac 40 znakov, len ako text
xp, xpNextniepruh postupu úrovne
avatar.imageniedata: URL (PNG, WebP alebo SVG), najviac 20 000 znakov
avatar.labelniepopis obrázka pre čítačky obrazovky
realm, gameVersion, updatednieinformatívne; stránka ich nepoužíva

Stránka karte nedôveruje. AudamirCard.parse() pri zlom JSON-e, nie-objekte alebo chýbajúcom v alebo level vráti „bez karty“. Všetko sa vkladá cez textContent; src obrázka sa nastaví len pri data: URL typu PNG, WebP alebo SVG v base64. Pri akejkoľvek chybe ostane všeobecný obrázok s prilbou a PLAY.

Obrázok kreslí hra

Avatar je hotový obrázok, ktorý pripraví hra. Stránka nemá vlastné kreslenie prilieb: 21 foriem by sa muselo udržiavať na dvoch miestach.

Hra kreslí prilbu štýlmi, takže <img src="data:…"> sa k nim nedostane. Riešenie z DESIGN §131.4: js/ui/helmet-image.js vyrobí samostatné SVG a farby, ktoré prehliadač vypočítal, zapíše ako triedy v jeho <style>. Dĺžka je od 9 474 znakov (forma 1) po 13 238 (forma 21), pod limitom 20 000.

Ktorá úroveň patrí na kartu

Hra nemá jedinú úroveň: každé cárstvo má vlastnú (R3a). Jediné číslo nad cárstvami je reputácia v Asgarde, súčet úrovní, z ktorej vzniká prilba aj titul.

Zvolené pravidlo (DESIGN §131.2): na karte je úroveň cárstva, v ktorom je hrdina najďalej; pri remíze cárstvo s väčším postupom, potom Kastgard, potom prvý registrovaný. Hráč bez hier má úroveň 1 Kastgardu. Obrázok je prilba celej reputácie. Zamietnuté boli tri možnosti: reputácia ako úroveň (číslo bez pruhu, ktoré žiadna obrazovka hry nevolá úrovňou), cárstvo hrané naposledy (karta by skákala) a vždy Kastgard (hráč, čo hrá len Rokgard, by mal úroveň 1). Cena: prilba je celý hrdina a úroveň jedno cárstvo, dve čísla, ktoré sa nezhodujú, ako na domovskej obrazovke hry.

Stránka 2. novembra chcela na paneli reputáciu v Asgarde (DESIGN §131.8). Riešenie je aditívne: karta dostala pole reputation, v ostalo 1. Ak pole chýba (kartu napísala staršia hra), panel spadne na úroveň s pruhom.

Pri reputácii 0 sa pole vynechá: „1“ pre hráča bez hier by dala rovnakú kartu hráčovi, čo nehral nič, aj hráčovi s jednou hrou.

Kto a kedy kartu píše

Len keď hra beží na webe (Build.target je web). Zápis nastane na konci App.init a po zmene profilu alebo nastavení, a to len keď sa niečo zmenilo. V karte nie je nič osobné okrem mena, ktoré hráč dal hrdinovi; hra dovolí 16 znakov, karta 40.

Overené (DESIGN §131.6): testy tvaru proti pravidlám čítania, všetkých 21 foriem prilby proti index.html, úložisko, ktoré odmieta zápis, a 44 mutantov; šesť prežilo prvé testy, po doplnení všetky zabité. V Chromiu z panela aplikácie: čistý profil s ?lang=sk zapísal kartu s úrovňou 1; profil úrovne 31 dal riadok „Ivka, Level 31, 100 / 1575 XP“.

?lang= v adrese: omyl, ktorý ukázal prehliadač

PLAY pridáva k adrese hry jazyk stránky (/game/?lang=sk). Pôvodné pravidlo znelo: adresa sa pýta, nerozhoduje (uložený jazyk vyhráva).

Pravidlo prešlo testami, ale zlyhalo na čistom origine v skutočnom prehliadači (DESIGN §131.9): ?lang=sk na prázdnom úložisku otvorilo slovenčinu, no akákoľvek zmena nastavenia (napríklad vypnutie zvuku) zapísala celé nastavenia vrátane lang. Odvtedy uložený jazyk vyhrával nad adresou, hoci hráč jazyk nikdy nezvolil. Kliknutie na EN a potom PLAY otvorilo hru po slovensky.

Opravené pravidlo je schválené: platné ?lang=xx vyhráva nad uloženým jazykom, hra ho uloží a vymaže parameter z adresy (history.replaceState). Pri neplatnom parametri sa nič neuloží. Odkazy, ktoré hráč posiela ďalej (#c=, #R=, text výsledku), parameter nenesú, inak by ten, kto zdieľa, vnútil svoj jazyk každému, kto odkaz otvorí.

Dôkazy (DESIGN §131.9): 28 mutantov (26 zabitých, dva neboli mutantmi a vyhodili sa z kódu) a dáta starého kódu: bez ?lang= ostanú nastavenia bajt po bajte.

Aký jazyk otvorí stránka

Rozcestník / otvorí /{jazyk}/ podľa štyroch krokov: (1) jazyk naposledy zvolený na stránke (audamir.lang), (2) jazyk hry z jej nastavení, (3) jazyk prehliadača, (4) en. Prvý krok pôvodné zadanie nemalo; pridal ho tvorca stránky, lebo prepínač by inak po návrate na / nič neznamenal.

Druhý krok číta audamir.settings, potom diceWars.settings. Rozhodnutie: kľúč bez čitateľného jazyka sa preskočí, lebo omyl rozcestníka stojí najviac nesprávny jazyk, ktorý návštevník prepne. Každé čítanie má vlastné try/catch. Nasadiť sa to má pred hrou s novými kľúčmi.

Odkaz na hru, ktorý je súbor

Odkaz je relatívny: zo sk/index.html je to ../game/index.html?lang=sk. Dôvod: dist/site/ sa dá prezerať aj zo súboru, kde absolútne /game/ vedie do koreňa disku. Cena: hra má z webu dve adresy tej istej stránky (/game/index.html?lang=sk a /game/?lang=sk), obe fungujú. Zo súboru nefunguje karta, lebo každá stránka z file:// má vlastný pôvod. Skutočný náhľad aj s kartou je npm run serve -- --site.

Menej viditeľné rozhodnutia

Názvy príkazov. Pôvodné build stavalo náhľad aj web. Commit z 2. 11. ich rozdelil: npm run build:preview robí náhľad do dist/preview/ a nenahráva sa; npm run build:site robí celý web a je jediným vstupom nasadenia. npm run build zanikol.

Stránka 404. Hosting ju ukáže na ľubovoľnej adrese, preto má všetky adresy v koreni (/assets/style.css). Je bez ohľadu na jazyk, nie je v sitemape a má noindex.

Ochrana čísel zverejnených článkov. Pravidlo bolo od 1. novembra len veta v README. Commit z 2. 11. ho previedol na published.json po jazykoch. node tools/check.js zlyhá, keď sa zapísané číslo alebo slug zmení, článok zmizne alebo sa vráti na koncept, aj keď je zverejnený a v zozname ešte nie je. Dnes je v zozname 25 slovenských záznamov a anglický je prázdny; zapisuje ho npm run published -- --add. Zoznam hovorí, čo sa považuje za zverejnené, nie čo je na webe.

Obrázok na zdieľanie. assets/og-image.png (1 200 × 630 px) je len ikona hry uprostred pozadia v odtieňoch ikony. Žiadny text ani vymyslené logo. Nástroj tools/og-image.js píše PNG sám.

Dobové snímky

Snímky sú z prvého commitu, v ktorom príslušná časť webu existuje.

Zoznam článkov blogu v slovenčine, 1. 11. 2026
Vtedy, 1. 11. 2026, hra 0.84.0: zoznam článkov blogu, 23 článkov v slovenčine; v angličtine zatiaľ žiadny
Úvodná stránka, 1. 11. 2026
Vtedy, 1. 11. 2026, hra 0.84.0: úvodná stránka s tlačidlom HRAŤ a miestom pre video
Zoznam zmien hry, 1. 11. 2026
Vtedy, 1. 11. 2026, hra 0.84.0: zoznam zmien hry, ešte nepublikovaný; texty zmien sú po anglicky
Úvodná stránka wiki, 3. 11. 2026
Vtedy, 3. 11. 2026, hra 0.103.0: úvodná stránka wiki; pod nadpisom poznámka, že anglické texty prekladala AI a čakajú na kontrolu
Verejný beta web s kartou Hra čoskoro, 4. 11. 2026
Vtedy, 4. 11. 2026, hra 0.110.1: karta hry v stave pripravujeme, tlačidlo Hra čoskoro a text, že hra sa pripravuje
Celý web s aktívnym tlačidlom HRAŤ, 4. 11. 2026
Vtedy, 4. 11. 2026, hra 0.110.1: celý web s aktívnym tlačidlom HRAŤ a v menu Výzvy a Zmeny

Čo je rozhodnuté a čo ostáva otvorené

Rozhodnuté: číslo je identita článku vo všetkých jazykoch; karta audamir.card v1 s poľom reputation; adresa jazyka vyhráva a hra ho uloží (so schválením autora); stránka číta nastavenia hry pod dvoma menami; zoznam zmien sa číta zo zdroja hry; ikona je kópia; published.json je po jazykoch.

Čaká na mňa: zapnúť anglický blog (otázka 5); schváliť texty hlavnej stránky (16); vybrať poskytovateľa videa (17); doplniť právnu stránku (19).

Čo si z toho odnášam

  • Rozhranie medzi dvoma vecami má byť malý dokument, nie prístup do vnútra. Karta prežila premenovanie kľúčov hry; jediný kľúč, ktorý stránka čítala priamo, si vynútil zmenu kódu aj testu.
  • Rozhranie sa rozširuje pridávaním polí. reputation prišlo bez zmeny v.
  • **Chybu v ?lang= našiel skutočný prehliadač na čistom origine, nie test.** Test overoval pravidlo, ktoré bolo samo chybné.
  • Hodnota uložená bez rozhodnutia nie je voľba. Uložený lang bol predvolená hodnota zapísaná pri zmene iného nastavenia.
  • Zverejnené číslo je zmluva, tak ju má strážiť nástroj, nie pamäť.

Zdroje a poznámky

  • git log repozitária stránky (21 commitov, 1. až 2. novembra 2026); README.md, docs/GAME-CARD.md, docs/OPEN-QUESTIONS.md.
  • Dokumenty hry (0.97.1 v čase písania): docs/DESIGN.md §131.1 až §131.9, docs/ROADMAP.md kapitola 31.
  • Merania 3. 11. 2026: node tools/build-site.js (83 súborov, 25 článkov, 88 záznamov). Čísla z DESIGN sú prevzaté bez prepočtu.
  • Súvisiace články: Dvadsať rokov, Políčka, Kmene: kópia, ktorá sa dá zmerať.