Herní engine s AI
Jak postavit herní engine třídy AAA pomocí AI agentů
Stavíme FRIENDLY?, survivalovou hru na vlastním enginu v Rustu a Vulkanu, směřující ke grafice a netcodu třídy AAA. Engine píšou AI agenti pod lidským vedením a platí pro něj přísná pravidla: nic se nesloučí, dokud to neprojde kontrolami. Tato stránka ukazuje cyklus a devět pravidel, která za ním stojí.
Co stavíme
FRIENDLY? je survivalová hra v rané fázi vývoje.
Engine je napsaný v Rustu (edice 2024) přímo nad Vulkanem 1.3 nebo novějším, s předkompilovanými shadery Slang, cratem Bevy ECS, Jolt Physics 5.6 a upscalingem DLSS a FSR.
Netcode je serverově autoritativní, na QUIC s TLS 1.3. Svět je skutečné údolí o rozloze zhruba 6 × 6 km.
Zhruba 100 % kódu píšou AI agenti pod lidským vedením. Projektový soubor hry shrnuje tento závazek jedinou větou: „Strictness is the product.“ (Přísnost je produkt.)
Cyklus: plán, rozhodnutí, linie, kontroly, sloučení
Stejný cyklus řídí náš herní engine a při nastavení vašich agentů ho dostane i váš repozitář.
-
Plán
Plán patří vlastníkovi. Funkce jdou cestou PRD → úkoly → realizace.
-
Rozhodnutí
Každé rozhodnutí se zapíše jako ADR dřív, než vznikne kód.
-
Linie
Jedna změna, jedna linie. Specializovaní agenti, jeden vedoucí.
-
Kontroly
Testy a lint, který je jen přísnější. Nová kontrola musí nejdřív jednou selhat.
-
Sloučení
Projde jen zelená práce. Agenti si nemůžou sami zmírnit pravidla.
Devět pravidel, která dělají agenty spolehlivými
U každého pravidla najdete jeho důvod a jeden konkrétní příklad z enginu.
-
Plán patří vlastníkovi
- Pravidlo
- Lidé rozhodují, co se postaví. Agenti to staví.
- Proč
- Agenti plán dobře provedou. Výběr plánu je část, kterou předat nelze.
- Příklad
- Funkce procházejí cestou PRD → úkoly → realizace a plán zůstává u vlastníka.
-
Nejdřív rozhodnout, písemně
- Pravidlo
- Rozhodnutí se zapíše dřív, než vznikne kód.
- Proč
- Zapsané rozhodnutí lze ověřit a vzít zpět. Rozhodnutí ukryté v diffu ne.
- Příklad
- Každé rozhodnutí je ADR a nový crate potřebuje svůj ADR dřív, než vznikne.
-
Jedna změna, jedna linie
- Pravidlo
- Každá změna dostane vlastní linii.
- Proč
- Malou, oddělenou změnu lze snadno zkontrolovat a snadno zahodit.
- Příklad
- Každá změna v enginu žije ve vlastní linii a musí projít kontrolami, než se sloučí.
-
Kontroly před sloučením a nová kontrola nejdřív selže
- Pravidlo
- Nic se nesloučí, dokud kontroly neprojdou, a každou novou kontrolu je třeba nejdřív vidět selhat, než jí uvěříme.
- Proč
- Kontrola, která nikdy neselhala, nemusí kontrolovat nic.
- Příklad
- Zeď lintů tvoří skupiny clippy all, pedantic a nursery plus asi 70 lintů ze skupiny restriction. Dodávaný kód neobsahuje žádný panic, kód unsafe žije jen v cratech ze schváleného seznamu, každá položka je zdokumentovaná a testy vznikají jako první.
-
Agent si nemůže zmírnit vlastní pravidla
- Pravidlo
- Řídicí vrstva je pro agenty jen ke čtení.
- Proč
- Pravidlo, které agent může upravit, je jen návrh.
- Příklad
- Pravidla, hooky, agenti i zeď lintů jsou zamčené jen pro čtení.
#[allow]je zakázáno; povoleno je jen#[expect(lint, reason)]s písemným zdůvodněním. Zeď se může jen zpřísňovat.
-
Znalosti žijí v souborech
- Pravidlo
- Co agenti potřebují vědět, je zapsáno v repozitáři.
- Proč
- Co žije v chatu, je v další relaci pryč. Co žije v repozitáři, se čte pokaždé.
- Příklad
- Znalosti o projektu držíme v souborech v repozitáři, kterým říkáme living skills.
-
Vstupní agent a specialisté
- Pravidlo
- Jeden vedoucí agent práci přijme a předá ji specialistům.
- Proč
- Jeden agent drží celkový obraz. Specialisté přinášejí hloubku.
- Příklad
- Vedoucí agent „door“ spolupracuje se specializovanými agenty pro rendering, netcode a revizi kódu v Rustu.
-
Hooky zastaví nebezpečné akce
- Pravidlo
- Nebezpečné akce blokují hooky, ne pokyny.
- Proč
- Pokyn je rada. Hook je vynucení.
- Příklad
- V repozitáři enginu hooky zastaví nebezpečné akce dřív, než se provedou.
-
Žádné tvrzení bez skutečného běhu
- Pravidlo
- Číslo se zveřejní, jen když ho přinesl skutečný běh.
- Proč
- Číslo z paměti je fáma.
- Příklad
- Zveřejňujeme jen změřená čísla ze skutečných běhů s uvedeným hardwarem. Proto tato stránka neuvádí žádné snímkové frekvence.
Tři příklady z enginu
Každý příklad je funkce enginu a pravidlo, které za ní stojí.
Počasí podle skutečných měření
Model počasí je kalibrovaný na reanalýze ERA5 a na záznamech stanic NCEI a DWD. Řídí volumetrická oblaka a používá skutečné polohy Slunce a Měsíce.
Pravidlo 9 v praxi: model je nastavený podle naměřených záznamů, ne od oka. Oblaka jsou část, která ještě není hotová; viz níže.

Stromy tam, kde stojí skutečné stromy
Mapa je skutečné údolí u Ružomberku na Slovensku, zhruba 6 × 6 km skutečného terénu. Stromy stojí tam, kde je zachycují data LiDAR z tohoto údolí s rozlišením 1 m.
Rozhodnutí postavit hru na skutečném údolí je zapsáno v ADR, jako každé rozhodnutí (pravidlo 2).

Kulky bez hitscanu
Každý projektil letí po vlastní dráze pod vlivem gravitace, odporu závislého na Machově čísle a větru. Hitscan neexistuje.
U takové funkce „vypadá to dobře“ nic nedokazuje, a proto metoda vyžaduje kontroly a skutečné běhy (pravidla 4 a 9).
Co ještě není hotové
- Tvary oblaků. Model počasí řídí volumetrická oblaka, ale jejich tvary ještě nejsou tam, kde je chceme mít.
- Globální osvětlení. Ve vývoji, ve výchozím stavu vypnuté.
- Samotná hra. Jde o rozpracovanou práci v rané fázi: malá hratelná scéna se dvěma domy, rozsáhlými lesy a počasím a zástupní zombie, kteří dokládají detekci zásahů a síťovou balistiku.
- Cíl třídy AAA. Je to cíl, ke kterému směřujeme. Netvrdíme, že se vyrovnáme kterémukoli jinému enginu, a neuvádíme žádné snímkové frekvence.
Zázemí, které za tím stojí
Naše vlastní AI prostředí nad Claude Code v číslech: systém 27 specializovaných agentů, 73 znalostních modulů a pět vlastních serverů MCP.
U našich vlastních produktů se nedodá nic, co neprojde PHPStanem na nejvyšší úrovni a ESLintem, Stylelintem, TypeScriptem, Dartem a Clippym v nejpřísnějším nastavení a k tomu 215 vlastními pravidly. Ani generovaný kód nemá výjimku.
Za tím stojí přes 20 let full-stack vývoje webu, více než čtyři roky práce s AI a vlastní webový framework v 18 jazycích.
Časté dotazy
Mohou AI agenti postavit herní engine?
U nás píšou zhruba 100 % kódu AI agenti pod lidským vedením. Výsledkem je rozpracovaná práce v rané fázi a správnost drží přísný soubor pravidel a kontrol.
Čím je kód psaný umělou inteligencí spolehlivý?
Kontrolami před sloučením: testy, zdí lintů ze skupin clippy plus asi 70 lintů restriction a dalšími kontrolami. K tomu pravidla a hooky, které agenti nemohou zmírnit.
Je hra hotová?
Ne. Stavíme ji a je v rané fázi. Co ještě chybí, je uvedeno v části „Co ještě není hotové“.
