Játékmotor MI-vel
Hogyan építsünk AAA-osztályú játékmotort MI-ügynökökkel
Építjük a FRIENDLY? nevű túlélőjátékot saját, Rust és Vulkan alapú motoron, amely AAA-osztályú grafikára és hálózati kódra (netcode) törekszik. A motort MI-ügynökök írják emberi irányítással, szigorú szabályrendszer mellett: semmi sem kerül összefésülésre, amíg át nem megy a kapukon. Ez az oldal a ciklust és a mögötte álló kilenc szabályt mutatja be.
Mit építünk
A FRIENDLY? nevű túlélőjáték korai fejlesztési szakaszban van.
A motor Rustban (2024-es kiadás) íródott, közvetlenül a Vulkan 1.3-as vagy újabb verziójára épül, előre fordított Slang-shaderekkel, a Bevy ECS crate-tel, a Jolt Physics 5.6-tal és DLSS- és FSR-felskálázással.
A hálózati kód szerver-autoritatív, QUIC-on fut TLS 1.3-mal. A világ egy valódi völgy, nagyjából 6 × 6 km.
A kód nagyjából 100 %-át MI-ügynökök írják emberi irányítással. A játék projektfájlja egyetlen mondatban foglalja össze a szabályrendszert: „Strictness is the product.” (A szigor a termék.)
A ciklus: tervezés, döntés, sáv, kapuk, összefésülés
Ugyanez a ciklus hajtja a játékmotorunkat, és ez kerül az Ön repójába is, amikor beállítjuk az ügynökeit.
-
Tervezés
A terv a tulajdonosé. A funkciók útja: PRD → feladatok → végrehajtás.
-
Döntés
Minden döntést ADR-ként rögzítünk, mielőtt kód születne.
-
Sáv
Egy változtatás, egy sáv. Szakosodott ügynökök, egy irányító.
-
Kapuk
Tesztek és egy lint-fal, amely csak szigorúbb lesz. Egy új kapunak előbb egyszer el kell buknia.
-
Összefésülés
Csak a zöld munka kerül be. Az ügynökök nem lazíthatnak a saját szabályaikon.
Kilenc szabály, amely megbízhatóvá teszi az ügynököket
Minden szabályhoz tartozik az indoklása és egy konkrét példa a motorból.
-
A terv a tulajdonosé
- Szabály
- Az emberek döntik el, mi épül meg. Az ügynökök megépítik.
- Miért
- Az ügynökök jól végrehajtanak egy tervet. A terv kiválasztása az a rész, amelyet nem lehet átadni.
- Példa
- A funkciók útja: PRD → feladatok → végrehajtás, a terv pedig a tulajdonosnál marad.
-
Előbb döntés, írásban
- Szabály
- A döntést rögzítjük, mielőtt kód születne.
- Miért
- Egy rögzített döntés ellenőrizhető és visszavonható. Az, amelyik egy diffben lapul, nem.
- Példa
- Minden döntés ADR, és egy új crate-nek már a létrehozása előtt szüksége van a saját ADR-jére.
-
Egy változtatás, egy sáv
- Szabály
- Minden változtatás saját sávot kap.
- Miért
- Egy kicsi, különálló változtatást könnyű átnézni és könnyű elvetni.
- Példa
- A motor minden változtatása a saját sávjában él, és az összefésülés előtt át kell mennie a kapukon.
-
Kapuk az összefésülés előtt, és az új kapu előbb elbukik
- Szabály
- Semmi sem kerül összefésülésre, amíg át nem megy a kapukon, és minden új kaput előbb pirosnak kell látnunk, mielőtt megbízunk benne.
- Miért
- Egy ellenőrzés, amely még soha nem bukott el, talán semmit sem ellenőriz.
- Példa
- A lint-fal a clippy all, pedantic és nursery csoportjaiból, valamint nagyjából 70 restriction lintből áll. A kiadott kódban nincs panic, az unsafe kód csak a jóváhagyott listán szereplő crate-ekben található, minden elem dokumentált, és a tesztek készülnek el először.
-
Az ügynök nem lazíthat a saját szabályain
- Szabály
- A vezérlési réteg az ügynökök számára csak olvasható.
- Miért
- Az a szabály, amelyet egy ügynök átírhat, csak javaslat.
- Példa
- A szabályok, a hookok, az ügynökök és a lint-fal csak olvashatóra vannak zárva. A
#[allow]tilos; csak a#[expect(lint, reason)]megengedett, írásos indoklással. A fal csak szigorodhat.
-
A tudás fájlokban él
- Szabály
- Amit az ügynököknek tudniuk kell, az a tárolóban van leírva.
- Miért
- Ami egy csevegésben él, az a következő munkamenetben eltűnik. Ami a tárolóban él, azt minden alkalommal elolvassák.
- Példa
- A projekttudást a tárolóban lévő fájlokban tartjuk, amelyeket living skillsnek hívunk.
-
Egy fogadó ügynök és szakértők
- Szabály
- Egy vezető ügynök átveszi a munkát, és szakértőknek adja tovább.
- Miért
- Egy ügynök megtartja az átfogó képet. A szakértők hozzák a mélységet.
- Példa
- Egy vezető „door” ügynök dolgozik együtt a rendereléssel, a hálózati kóddal és a Rust-kódellenőrzéssel foglalkozó szakértő ügynökökkel.
-
A hookok megállítják a veszélyes műveleteket
- Szabály
- A veszélyes műveleteket hookok blokkolják, nem utasítások.
- Miért
- Az utasítás tanács. A hook kikényszerítés.
- Példa
- A motor tárolójában a hookok megállítják a veszélyes műveleteket, mielőtt azok lefutnának.
-
Állítás valódi futtatás nélkül nincs
- Szabály
- Számot csak akkor közlünk, ha egy valódi futtatás adta.
- Miért
- A fejből mondott szám csak szóbeszéd.
- Példa
- Csak valódi futtatásokból származó, mért számokat közlünk, a hardver megnevezésével. Ezért nincs ezen az oldalon képkockasebesség.
Három példa a motorból
Mindegyik példa a motor egy funkciója és a mögötte álló szabály.
Valódi mérésekre illesztett időjárás
Az időjárásmodell az ERA5 reanalízisre, valamint az NCEI és a DWD állomásainak méréseire van kalibrálva. Ez vezérli a volumetrikus felhőket, és a Nap és a Hold valódi helyzetét használja.
A 9. szabály a gyakorlatban: a modellt mért adatokhoz igazítottuk, nem ízlés szerint. A felhők az a rész, amely még nem kész; lásd lejjebb.

Fák ott, ahol valódi fák állnak
A térkép egy valódi völgy Ružomberok közelében, Szlovákiában, nagyjából 6 × 6 km valódi terep. A fák ott állnak, ahol a völgy 1 m felbontású LiDAR-adatai fákat mutatnak.
A valódi völgy mellett szóló döntést ADR rögzíti, mint minden döntést (2. szabály).

Lövedékek hitscan nélkül
Minden lövedék a saját pályáján repül a gravitáció, a Mach-számtól függő légellenállás és a szél hatására. Hitscan nincs.
Egy ilyen funkciónál a „jól néz ki” semmit sem bizonyít, ezért a módszer kapukat és valódi futtatásokat követel (4. és 9. szabály).
Ami még nincs kész
- A felhők alakja. Az időjárásmodell volumetrikus felhőket vezérel, de az alakjuk még nem ott tart, ahol szeretnénk.
- Globális megvilágítás. Fejlesztés alatt, alapértelmezés szerint kikapcsolva.
- Maga a játék. Még korai fázisban járó, folyamatban lévő munka: egy kis játszható jelenet két házzal, nagy erdőkkel és időjárással, valamint ideiglenes zombikkal, amelyek a találatérzékelést és a hálózati ballisztikát igazolják.
- Az AAA-osztályú cél. Ez az a cél, amely felé haladunk. Nem állítunk egyenértékűséget más motorokkal, és nem közlünk képkockasebességet.
A háttér
Saját MI-környezetünk a Claude Code-on, számokban: 27 specializált ügynökből álló rendszer 73 tudásmodullal és öt saját MCP-szerverrel.
Saját termékeinknél semmi sem kerül kiadásra, ami nem megy át a PHPStan legmagasabb szintjén, valamint az ESLint, a Stylelint, a TypeScript, a Dart és a Clippy legszigorúbb beállításán, továbbá 215 saját szabályon. A generált kód sem kap kivételt.
Mögötte több mint 20 év full-stack webfejlesztés áll, több mint négy év MI-vel végzett építkezés és egy saját webes keretrendszer 18 nyelven.
Gyakori kérdések
Építhetnek MI-ügynökök játékmotort?
Nálunk a kód nagyjából 100 %-át MI-ügynökök írják emberi irányítással. Az eredmény még korai fázisban járó, folyamatban lévő munka, a helyességét pedig a szabályok és kapuk szigorú rendszere biztosítja.
Mitől megbízható az MI által írt kód?
Kapuk az összefésülés előtt: tesztek, a clippy-csoportokból és nagyjából 70 restriction lintből álló lint-fal és további ellenőrzések. Ehhez jönnek a szabályok és hookok, amelyeken az ügynökök nem lazíthatnak.
Kész van a játék?
Nem. Építjük, és korai fázisban van. Ami még hiányzik, azt az „Ami még nincs kész” rész sorolja fel.
