Silnik gier z AI
Jak zbudować silnik gier klasy AAA z agentami AI
Budujemy FRIENDLY?, grę survivalową na własnym silniku w Rust i Vulkanie, nastawioną na grafikę i netcode klasy AAA. Silnik piszą agenci AI pod kierunkiem człowieka, a obowiązuje ich ścisły kontrakt: nic nie jest scalane, dopóki nie przejdzie bramek. Ta strona pokazuje cykl i dziewięć reguł, które za nim stoją.
Co budujemy
FRIENDLY? to gra survivalowa na wczesnym etapie rozwoju.
Silnik jest napisany w Rust (edycja 2024) bezpośrednio na Vulkanie 1.3 lub nowszym, ze wstępnie skompilowanymi shaderami Slang, crate’em Bevy ECS, Jolt Physics 5.6 oraz upscalingiem DLSS i FSR.
Netcode działa w modelu z autorytatywnym serwerem, na QUIC z TLS 1.3. Świat to prawdziwa dolina o wymiarach około 6 × 6 km.
Około 100 % kodu piszą agenci AI pod kierunkiem człowieka. Plik projektu gry streszcza ten kontrakt jednym zdaniem: „Strictness is the product.” (Rygor jest produktem.)
Cykl: plan, decyzja, tor, bramki, scalenie
Ten sam cykl napędza nasz silnik gier i trafia do Twojego repozytorium, gdy konfigurujemy Twoich agentów.
-
Plan
Plan należy do właściciela. Funkcje przechodzą ścieżkę PRD → zadania → realizacja.
-
Decyzja
Każda decyzja jest spisywana jako ADR, zanim powstanie kod.
-
Tor
Jedna zmiana, jeden tor. Wyspecjalizowani agenci, jeden prowadzący.
-
Bramki
Testy i ściana lintów, która staje się tylko surowsza. Nowa bramka musi najpierw raz zawieść.
-
Scalenie
Wchodzi tylko zielona praca. Agenci nie mogą poluzować własnych reguł.
Dziewięć reguł, dzięki którym agenci są niezawodni
Każda reguła ma swoje uzasadnienie i jeden konkretny przykład z silnika.
-
Plan należy do właściciela
- Reguła
- Ludzie decydują, co powstaje. Agenci to budują.
- Dlaczego
- Agenci dobrze realizują plan. Wybór planu to część, której nie da się oddać.
- Przykład
- Funkcje przechodzą ścieżkę PRD → zadania → realizacja, a plan zostaje przy właścicielu.
-
Najpierw decyzja, na piśmie
- Reguła
- Decyzja jest spisywana, zanim powstanie kod.
- Dlaczego
- Spisaną decyzję można sprawdzić i cofnąć. Decyzji ukrytej w diffie nie.
- Przykład
- Każda decyzja to ADR, a nowy crate potrzebuje własnego ADR, zanim powstanie.
-
Jedna zmiana, jeden tor
- Reguła
- Każda zmiana ma własny tor.
- Dlaczego
- Małą, osobną zmianę łatwo zrecenzować i łatwo odrzucić.
- Przykład
- Każda zmiana w silniku żyje na własnym torze i musi przejść bramki, zanim zostanie scalona.
-
Bramki przed scaleniem, a nowa bramka najpierw musi zgłosić błąd
- Reguła
- Nic nie jest scalane, dopóki bramki nie przejdą, a każdą nową bramkę trzeba najpierw zobaczyć na czerwono, zanim jej zaufamy.
- Dlaczego
- Kontrola, która ani razu nie zgłosiła błędu, może niczego nie sprawdzać.
- Przykład
- Ściana lintów to grupy clippy all, pedantic i nursery oraz około 70 lintów z grupy restriction. Dostarczany kod nie zawiera panic, kod unsafe żyje tylko w crate’ach z listy dozwolonych, każdy element ma dokumentację, a testy powstają najpierw.
-
Agent nie może poluzować własnych reguł
- Reguła
- Warstwa sterowania jest dla agentów tylko do odczytu.
- Dlaczego
- Reguła, którą agent może edytować, jest tylko sugestią.
- Przykład
- Reguły, hooki, definicje agentów i ściana lintów są zablokowane w trybie tylko do odczytu.
#[allow]jest zakazane; dozwolone jest wyłącznie#[expect(lint, reason)]z pisemnym uzasadnieniem. Ściana może się tylko zaostrzać.
-
Wiedza żyje w plikach
- Reguła
- To, co agenci muszą wiedzieć, jest zapisane w repozytorium.
- Dlaczego
- To, co żyje w czacie, znika w następnej sesji. To, co żyje w repozytorium, jest czytane za każdym razem.
- Przykład
- Wiedzę o projekcie trzymamy w plikach w repozytorium, które nazywamy living skills.
-
Agent przyjmujący i specjaliści
- Reguła
- Jeden agent prowadzący przyjmuje pracę i przekazuje ją specjalistom.
- Dlaczego
- Jeden agent zachowuje całościowy obraz. Specjaliści dają głębię.
- Przykład
- Agent prowadzący, czyli „drzwi”, współpracuje ze specjalistami od renderowania, netcode’u i przeglądu kodu w Rust.
-
Hooki zatrzymują niebezpieczne działania
- Reguła
- Niebezpieczne działania blokują hooki, a nie polecenia.
- Dlaczego
- Polecenie jest radą. Hook jest wymuszeniem.
- Przykład
- W repozytorium silnika hooki zatrzymują niebezpieczne działania, zanim zostaną wykonane.
-
Żadnego twierdzenia bez prawdziwego uruchomienia
- Reguła
- Liczba jest publikowana tylko wtedy, gdy dało ją prawdziwe uruchomienie.
- Dlaczego
- Liczba z pamięci to plotka.
- Przykład
- Publikujemy wyłącznie liczby zmierzone w prawdziwych uruchomieniach, z podanym sprzętem. Dlatego na tej stronie nie ma danych o liczbie klatek na sekundę.
Trzy przykłady z silnika
Każdy przykład to funkcja silnika i reguła, która za nią stoi.
Pogoda dopasowana do prawdziwych pomiarów
Model pogody jest skalibrowany na reanalizie ERA5 oraz na pomiarach ze stacji NCEI i DWD. Steruje chmurami wolumetrycznymi i korzysta z prawdziwych pozycji Słońca i Księżyca.
Reguła 9 w działaniu: model jest dopasowany do zmierzonych danych, a nie do gustu. Chmury to część, która nie jest jeszcze skończona; patrz niżej.

Drzewa tam, gdzie rosną prawdziwe drzewa
Mapa to prawdziwa dolina koło Ružomberoka na Słowacji, około 6 × 6 km rzeczywistego terenu. Drzewa stoją tam, gdzie dane LiDAR doliny o rozdzielczości 1 m wskazują drzewa.
Decyzja, by oprzeć mapę na prawdziwej dolinie, jest zapisana w ADR, jak każda decyzja (reguła 2).

Pociski bez hitscanu
Każdy pocisk leci własnym torem pod wpływem grawitacji, oporu zależnego od liczby Macha i wiatru. Hitscanu nie ma.
W takiej funkcji „wygląda dobrze” niczego nie dowodzi, dlatego metoda wymaga bramek i prawdziwych uruchomień (reguły 4 i 9).
Czego jeszcze nie skończyliśmy
- Kształty chmur. Model pogody steruje chmurami wolumetrycznymi, ale ich kształty nie są jeszcze takie, jakich chcemy.
- Globalne oświetlenie. W fazie rozwoju, domyślnie wyłączone.
- Sama gra. To praca w toku na wczesnym etapie: niewielka grywalna scena z dwoma domami, rozległymi lasami i pogodą oraz tymczasowe zombie, które dowodzą działania wykrywania trafień i sieciowej balistyki.
- Cel klasy AAA. To cel, do którego dążymy. Nie twierdzimy, że dorównujemy jakiemukolwiek innemu silnikowi, i nie publikujemy danych o liczbie klatek na sekundę.
Zaplecze tego wszystkiego
Nasze własne środowisko AI oparte na Claude Code w liczbach: system 27 wyspecjalizowanych agentów z 73 modułami wiedzy i pięcioma własnymi serwerami MCP.
W naszych własnych produktach nic nie jest dostarczane, jeśli nie przejdzie PHPStan na najwyższym poziomie oraz ESLint, Stylelint, TypeScript, Dart i Clippy w najostrzejszym ustawieniu, a do tego 215 własnych reguł. Dla kodu generowanego nie ma taryfy ulgowej.
Za tym stoi ponad 20 lat full-stackowego tworzenia stron i aplikacji webowych, ponad cztery lata pracy z AI oraz własny framework webowy w 18 językach.
Najczęstsze pytania
Czy agenci AI mogą zbudować silnik gier?
U nas około 100 % kodu piszą agenci AI pod kierunkiem człowieka. Efektem jest praca w toku na wczesnym etapie, a poprawność zapewnia ścisły kontrakt reguł i bramek.
Co sprawia, że kod pisany przez AI jest niezawodny?
Bramki przed scaleniem: testy, ściana lintów złożona z grup clippy oraz około 70 lintów z grupy restriction, a także dalsze kontrole. Do tego reguły i hooki, których agenci nie mogą poluzować.
Czy gra jest skończona?
Nie. Budujemy ją i jest na wczesnym etapie. To, czego jeszcze brakuje, wymieniamy w części „Czego jeszcze nie skończyliśmy”.
