A stúdiód saját pipeline-ja, katalógusa és boltjai — percek alatt felállítva, a saját gépeden vagy szervereden, kilenc platformra a Godot-tól a Commodore 64-ig. A WarpEngine Starter Kit három, egymáshoz illő darab: a WarpEngine, a szerver; a WarpEngine Toolbox, a szerkesztő; és a boltok, a játékosaid képernyői. Ez az oldal végigvezet az egész úton, az üres géptől egy retró dobozra telepített játékig.
| Darab | Mit ad neked | Olvasd |
|---|---|---|
| WarpEngine | A szerver: játékkatalógus adminnal, CI-pipeline-ok minden platformra, build- és publikáló végpontok, az API, amit minden kliens olvas | WarpEngine |
| WarpEngine Toolbox | A szerkesztő: VS Code-bővítmény, amely sablonból indít játékot, ellenőrzi, a valódi runtime-ban játssza le, és kiadja | WarpEngine Toolbox |
| A boltok | A játékosaid képernyői: asztali app, Batocera-doboz, RetroArch, Commodore 64 Ultimate, DOS — mind a te katalógusodat olvassa | Áruházak |
Három ígéret fut végig rajta:
flowchart LR
ED["VS Code + Toolbox"] -->|"New Game, Connect"| FORGE["Gitea-repó"]
FORGE -->|"push, tag"| CI["Woodpecker"]
CI -->|"elkéri a pipeline-t"| WE["WarpEngine"]
CI -->|"feltöltés, publikálás"| WE
WE --> WEB["Böngésző: játék és letöltés"]
WE --> DESK["WarpEngine Client"]
WE --> RETRO["Batocera, RetroArch"]
WE --> SMALL["C64 Ultimate, DOS-polcok"]

A motor repójában egy kész stúdió van: a katalógus az adminjával, egy Gitea forge és Woodpecker CI, mind konténerben. Egy szkript elindítja és összeköti őket, így az első pusholt játékod megépül és bekerül a katalógusba.
Más nem: se Ruby, se MySQL, se megírandó konfiguráció.
git clone https://git.teletypegames.org/engines/warp_engine.git
cd warp_engine/examples/compose
bin/setup
Az első futás pár percig tart. A szkript:
warp / warpengine) és egy games szervezettel a játékaidnak;.env-be, ezekkel újraindítja a katalógust, és — ha a gitnek van credential helpere — elmenti a Gitea-jelszót a pushokhoz.A végén kiírja a címeket és a belépéseket. Bármikor újrafuttatható: ami már be van állítva, marad. Csak a katalógus és az admin kell? bin/setup --no-ci.
| Cím | Mi ez |
|---|---|
| http://localhost:8080/ | A katalógusoldal, amit a játékosaid látnak: egyszerű lista és játékonként egy oldal, hogy a saját oldaladra cseréld |
| http://localhost:8080/admin | Az admin, admin@example.org / warpengine |
| http://localhost:8080/file/starhop/1.0.0/html/index.html | Egy demójáték webes buildje, böngészőben játszható |
| http://localhost:8080/api/software | A katalógus JSON-ként (WECP) — ezt olvassák a bolt-kliensek |
| http://localhost:8080/api/docs | Interaktív API-dokumentáció |
| http://gitea.localhost:3000 | Gitea, warp / warpengine |
| http://woodpecker.localhost:8000 | Woodpecker CI |
A *.localhost címek minden böngészőben, a curlben és a gitben a saját gépedre mutatnak, ezért az /etc/hosts-hoz nem kell nyúlni. Foglalt egy port? Állítsd az APP_PORT, GITEA_PORT vagy WOODPECKER_PORT értéket a .env-ben, és futtasd újra a bin/setup-ot.
Az admin WarpEngine menüjében minden ott van, amit a motor hoz: a szoftverek a kiadásaikkal és fájljaikkal, a képtár, a fájlkezelő, a letöltési statisztika, az alkalmazás-tokenek, a CI-pipeline-ok és a SysInfo oldal, amely a teljes beállítást mutatja, minden során állapottal.

Telepítsd a toolboxot a Visual Studio Marketplace-ről, állítsd a katalógusodra és jelentkezz be: a szerkesztő mutat egy kódot, amit az admin Tool Sign In oldalán hagysz jóvá.
WarpEngine: Set Host… → http://localhost:8080
WarpEngine: Sign In
WarpEngine: New Game → platform, név, cím, licenc
A projekt a platform sablonjából indul (ha kéred, a demójátékával), a pipeline egysoros jelölőjével és a kitöltött metadatával. Az összes platform: Platformok.

A Play a VS Code-on belül pontosan abban a runtime-ban futtatja a játékot, amit a katalógus is használ — a böngészős buildet, vagy C64-en, Plus/4-en és DOS-on az emulátort. A toolbox még a publikálás előtt ellenőrzi a metadatát aszerint, amit a szerver elfogad.
Minden pusholt ág saját fejlesztői buildet kap saját linkkel, a pull request pedig kommentben megkapja; egy 1.3.0-beta.1-hez hasonló verzió a béta csatornán megy ki, azoknak a játékosoknak, akik bétát kérnek. Bővebben a Toolboxban és a Referenciában.

A Connect létrehozza a repót a forge-odon, bekapcsolja a CI-ban a saját tokenjével, és feltölti a játékot; az első build azonnal elindul. Innentől a Release megemeli a verziót, megírja a changelogot és pusholja a taget:
WarpEngine: Connect
WarpEngine: Release → Stable / Beta, verzió
A pipeline-t a WarpEngine szolgálja ki, így egy javított lépés vagy egy új builder egyszerre jut el minden játékhoz. Egy perc múlva a kiadás a katalógusban van: böngészőben játszható webes build, letölthető zipek, cartridge az igazi vasra. Ha az adminban Released állapotra állítod, ott van a katalógusoldaladon is a http://localhost:8080/ címen — egyszerű lista és játékonként egy oldal, téma nélkül, hogy a stúdiód saját oldalává írd át.

Minden bolt ugyanazt a katalógus-API-t olvassa (WECP), így mind a te játékaidat viszi, nem a mieinket:
| Képernyő | Hogyan kapja meg a katalógusodat | Olvasd |
|---|---|---|
| Böngésző | Minden webes buildes kiadás a saját címén játszható; a letöltéseket az API szolgálja ki | WECP |
| Asztali gép (Linux, macOS, Windows) | A WarpEngine Client első indításkor elkéri a katalógusod címét | WarpEngine Client |
| Batocera | A rails g warp_engine:store batocera megírja a bolt konfigját és telepítőjét a katalógusodhoz |
Batocera Store |
| RetroArch | Ugyanez retroarch-csal, lejátszási listaként, borítóképekkel — asztal, Android, Steam Deck |
RetroArch Store |
| C64 Ultimate, DOS | Polcok és az Assembly64-kimenet, a hoszt beállításában bekapcsolva | Referencia |
Batocera-bolt a példa-stackhez, azzal a címmel, amit a doboz elér (a géped a helyi hálózaton):
docker compose exec app bin/rails g warp_engine:store batocera \
--base-url http://192.168.1.20:8080 --name "My Studio" --id mystudio
# aztán a Batocera-dobozon:
curl -fsSL http://192.168.1.20:8080/stores/batocera/install.sh | sh
A doboz saját My Studio menüpontot kap az EmulationStationben, a játékaiddal és egy frissítővel. A generált konfig a hosztod fájlja, szabadon szerkesztheted.
A példa-stack egy egyszerű Rails-app a mountolt motorral; ez van benne, és így játszhatod el kézzel a CI szerepét.
Egy CI-pipeline néhány HTTP-hívással publikál, így a pipeline szerepét magad is eljátszhatod. Futtasd ezt bármelyik üres mappából:
cat > demo-0.1.0.metadata.json <<'JSON'
{ "name": "demo", "title": "Demo Game", "author": "You", "desc": "Hello", "license": "MIT", "category": "demo" }
JSON
echo '<h1>demo</h1>' > index.html && zip demo-0.1.0.html.zip index.html
echo hello > game.bin && zip demo-0.1.0-win-x64.zip game.bin
for f in demo-0.1.0*; do
curl -fs -H "X-Update-Secret: example-update-secret" \
-F "file=@$f" "http://localhost:8080/build/upload?name=demo&version=0.1.0"
done
curl -X POST -H "X-Update-Secret: example-update-secret" \
"http://localhost:8080/build/publish?platform=love&name=demo&version=0.1.0"
Töltsd újra az admint: ott a Demo Game a webes buildjével (http://localhost:8080/file/demo/0.1.0/html/index.html) és a Windows-zippel. Egy új cím In development állapotban indul, amit a nyilvános katalógus nem listáz; a Released állapottal jelenik meg.
Az examples/compose/host_app egy egyszerű, kis Rails-app — ugyanaz a néhány dolog, amit bármelyik hoszt hozzáad a motorhoz:
Gemfile-ban: gem "warp_engine";config/initializers/warp_engine.rb: hol vannak a buildek, a forge, a CI platformonkénti builder-image-dzsel, a projektsablonok, az Admin API;mount WarpEngine::Engine => "/" a config/routes.rb-ben;CatalogController és két nézet az app/views/catalog-ban), ugyanazzal az adattal, amit a /api/software ad — írd át, vagy cseréld a saját oldaladra;Image modell, az /api/image/:id végpont és az admin oldala. Szándékosan a hoszté, hogy ugyanazok a képek az oldal többi részét is kiszolgálhassák.A motort a klónozott repóból mountolja, így ha a motor kódjában változtatsz, az a futó példában is megjelenik.
docker compose --profile ci down # leállítás; az adatok maradnak
docker compose --profile ci down -v # leállítás és minden törlése
Nincs regisztráció, nincs mit aláírni: minden közvetlenül tőlünk húzható, nyilvánosan, belépés nélkül.
git clone https://git.teletypegames.org/engines/warp_engine.git (MIT-licenc), vagy gemként a registrynkből: source "https://git.teletypegames.org/api/packages/engines/rubygems" egy Rails-app Gemfile-jában.git.teletypegames.org/build/…, egy dátumozott készletre rögzítve, amit a példa megnevez; a motor README-je felsorolja őket..vsix a kiadásai közül.A teletypegames.org WarpEngine-hoszt, pontosan úgy felépítve, ahogy ez az oldal leírja: 2026. november 17-én a nyilvános katalógusában 25 cím volt 9 platformon, 64 kiadással és közel 800 letöltéssel, böngészőknek, az asztali kliensnek, Batocera-dobozoknak, RetroArchnak, Commodore 64 Ultimate-eknek és DOS-gépeknek kiszolgálva. Mindegyik játék ugyanazon a pipeline-on ment át, amin az első játékod is fog.