EN /HU | Belépés

WarpEngine Starter Kit

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.

Mi van a csomagban

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:

  • Pusholsz egy játékot, és már a boltban van. A játékrepóban egy sor mondja meg a platformot; a pipeline a szerveren él.
  • Ki sem kell lépned a szerkesztőből. Új játék, metadata, kipróbálás, kiadás — VS Code-ból.
  • A játékosaid minden képernyőn. Böngésző, asztali gép, retró dobozok, igazi 8 bites vas — a saját neveden.
MERMAID
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"]

1. lépés — Állítsd fel a stúdiódat

Egy WarpEngine-katalógus SysInfo oldala: a teljes beállítás, minden során állapottal

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.

Ami kell hozzá

  • Docker Compose-zal: Docker Desktop, OrbStack, vagy Linuxon Docker Engine a compose pluginnal.
  • git és curl.

Más nem: se Ruby, se MySQL, se megírandó konfiguráció.

Klónozás és beállítás

SH
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:

  1. elindítja a katalógust: az app telepíti a gemjeit, lefuttatja a motor telepítő generátorát és a migrációkat, betölt három demójátékot, és telepíti a webes runtime-okat;
  2. elindítja a Giteát egy adminnal (warp / warpengine) és egy games szervezettel a játékaidnak;
  3. elindítja a Woodpeckert, összeköti a Giteával és egyszer bejelentkezteti, hogy a motor repókat kapcsolhasson be és pipeline-t adhasson nekik;
  4. minden létrehozott tokent beír a .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.

Nézz körül

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.

2. lépés — Indítsd el az első játékodat

New Game a VS Code-ban: platform a hoszt által kiszolgáltak közül

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á.

TEXT
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.

3. lépés — Játszd és teszteld

Play a VS Code-ban: a C64-demó ugyanabban az emulátorban fut, amit a katalógus használ

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.

4. lépés — Add ki

Egy játékrepó CI-pipeline-jai, ahogy a WarpEngine admin mutatja

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:

TEXT
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.

5. lépés — Juss el a játékosaidhoz

A WarpEngine Client: a katalógus kártyarácsként, egy kattintás a telepítés és a játék

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):

SH
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 motorháztető alatt

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.

Kiadás kézzel

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:

SH
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.

Mi van a példában

Az examples/compose/host_app egy egyszerű, kis Rails-app — ugyanaz a néhány dolog, amit bármelyik hoszt hozzáad a motorhoz:

  • egy sor a 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;
  • egy teljesen téma nélküli katalógusoldal (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;
  • ActiveAdmin és Devise az adminhoz (opcionális — nélkülük a motor fej nélkül fut: API és publikálás);
  • a képtár: az 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.

Leállítás, törlés

SH
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

Honnan szerzed be

Nincs regisztráció, nincs mit aláírni: minden közvetlenül tőlünk húzható, nyilvánosan, belépés nélkül.

  • A motor — 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.
  • A builder-image-ek — git.teletypegames.org/build/…, egy dátumozott készletre rögzítve, amit a példa megnevez; a motor README-je felsorolja őket.
  • A toolbox — a Visual Studio Marketplace, vagy a .vsix a kiadásai közül.
  • A boltok — az Áruházak oldalai, mindegyik a saját telepítési lépéseivel.

Amit (még) nem tud

  • Steam vagy itch.io — a katalógus a tiéd; a nagy boltokba még nincs feltöltés.
  • Fizetés — a katalógus hozzáférési szabállyal védheti a letöltéseket, de pénzt nem kezel.
  • Bármilyen forge — új repó Giteán (vagy Forgejón) jön létre; GitHub és GitLab ehhez még nem támogatott.
  • Aláírt asztali buildek — a Windows- és macOS-buildek aláíratlanul készülnek.
  • Natív arm64 builderek — a builder-image-ek amd64-esek; Apple Silicon gépen emulálva, lassabban futnak.

Mi is ezen futunk

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.