---
title: 'WarpEngine Starter Kit'
url: 'https://wiki.teletypegames.org/hu/engines/warp-engine/starter-kit'
markdown: 'https://wiki.teletypegames.org/hu/engines/warp-engine/starter-kit.md'
lang: hu
date: '2026-11-17'
description: '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ékos…'
taxonomy:
  tag:
    - howto
    - warp-engine
    - getting-started
---

# 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](https://wiki.teletypegames.org/hu/engines/warp-engine), a szerver; a [WarpEngine Toolbox](https://wiki.teletypegames.org/hu/development/warpengine-toolbox), a szerkesztő; és a [boltok](https://wiki.teletypegames.org/hu/stores), 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](https://wiki.teletypegames.org/hu/engines/warp-engine) |
| **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](https://wiki.teletypegames.org/hu/development/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](https://wiki.teletypegames.org/hu/stores) |

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](https://wiki.teletypegames.org/wiki-assets/warp-engine/admin-sysinfo.png)

A motor repójában egy kész stúdió van: a katalógus az adminjával, egy [Gitea](https://about.gitea.com) forge és [Woodpecker](https://woodpecker-ci.org) 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](https://wiki.teletypegames.org/hu/engines/warp-engine/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](https://wiki.teletypegames.org/wiki-assets/development/warpengine-toolbox-new-game.png)

Telepítsd a toolboxot a [Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=TeletypeGames.warpengine-toolbox)-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](https://wiki.teletypegames.org/hu/platforms).

# 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](https://wiki.teletypegames.org/wiki-assets/development/warpengine-toolbox-play.png)

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](https://wiki.teletypegames.org/hu/development/warpengine-toolbox) és a [Referenciában](https://wiki.teletypegames.org/hu/engines/warp-engine/reference).

# 4. lépés — Add ki

![Egy játékrepó CI-pipeline-jai, ahogy a WarpEngine admin mutatja](https://wiki.teletypegames.org/wiki-assets/warp-engine/admin-pipeline.png)

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](https://wiki.teletypegames.org/wiki-assets/stores/warpengine-client.png)

Minden bolt ugyanazt a katalógus-API-t olvassa ([WECP](https://wiki.teletypegames.org/hu/engines/warp-engine/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](https://wiki.teletypegames.org/hu/engines/warp-engine/wecp) |
| **Asztali gép** (Linux, macOS, Windows) | A WarpEngine Client első indításkor elkéri a katalógusod címét | [WarpEngine Client](https://wiki.teletypegames.org/hu/stores/warp-engine-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](https://wiki.teletypegames.org/hu/stores/warp-engine-batocera-store) |
| **RetroArch** | Ugyanez `retroarch`-csal, lejátszási listaként, borítóképekkel — asztal, Android, Steam Deck | [RetroArch Store](https://wiki.teletypegames.org/hu/stores/warp-engine-retroarch-store) |
| **C64 Ultimate, DOS** | Polcok és az Assembly64-kimenet, a hoszt beállításában bekapcsolva | [Referencia](https://wiki.teletypegames.org/hu/engines/warp-engine/reference) |

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](https://marketplace.visualstudio.com/items?itemName=TeletypeGames.warpengine-toolbox), vagy a `.vsix` a [kiadásai](https://git.teletypegames.org/tools/warp-engine-toolbox/releases) közül.
- **A boltok** — az [Áruházak](https://wiki.teletypegames.org/hu/stores) 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](https://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.

 [howto](https://wiki.teletypegames.org/hu/tags?tag=howto)[warp-engine](https://wiki.teletypegames.org/hu/tags?tag=warp-engine)[getting-started](https://wiki.teletypegames.org/hu/tags?tag=getting-started) 

## Kapcsolódó lapok

- [WarpEngine Toolbox](https://wiki.teletypegames.org/hu/development/warpengine-toolbox) FejlesztésVS Code-bővítmény WarpEngine-játékokhoz: új játék a hoszt sablonjából, a hoszt által ellenőrzött metaadat, játék a webes runtime-ban, összekötés, kiadás és katalógus, a szerkesztőből ki sem lépve.
- [WarpEngine — Referencia](https://wiki.teletypegames.org/hu/engines/warp-engine/reference) WarpEngineA WarpEngine részletesen: platformok, végpontok, hozzáférés, képtár, Woodpecker-pipeline-ok, kimenetek, polcok, telepítés és adminintegráció.
- [WarpEngine BBS](https://wiki.teletypegames.org/hu/services/bbs/warp-engine-bbs) BBS-boardokA Teletype Games fájlterülete telnetvonalon: a C64-es és a Plus/4-es polc, ZMODEM- vagy XMODEM-letöltéssel
- [RDoc](https://wiki.teletypegames.org/hu/development/rdoc) FejlesztésRuby gemjeink API-referenciája: minden kiadási tagnél RDoc-kal épül a forrásból, és itt jelenik meg a /rdoc/ alatt.
- [WARP64U](https://wiki.teletypegames.org/hu/stores/warp64u) ÁruházakWARP64U, a Teletype Games programtára a C64-en: sima HTTP-n listázza a C64-polcot, lemezre telepíti és frissíti a címeket, és elindítja őket.

'; var prevLevel = 2; for (var i = 0; i < headings.length; i++) { var h = headings\[i\]; var text = h.textContent.trim(); var slug = text.toLowerCase() .replace(/\[áàâä\]/g,'a').replace(/\[éèêë\]/g,'e').replace(/\[íìîï\]/g,'i') .replace(/\[óòôöő\]/g,'o').replace(/\[úùûüű\]/g,'u') .replace(/\[^a-z0-9\]+/g, '-').replace(/^-|-$/g, ''); if (!slug) slug = 'heading-' + i; if (used\[slug\]) { slug += '-' + i; } used\[slug\] = true; h.id = slug; var level = parseInt(h.tagName.charAt(1)); var cls = level > 2 ? ' class="toc-child"' : ''; html += '- [' + text + '](#'%20+%20slug%20+%20')
'; } html += '
'; toc.innerHTML = html; // Scroll-spy: highlight current heading var links = toc.querySelectorAll('a'); var ids = \[\]; for (var j = 0; j < links.length; j++) ids.push(links\[j\].getAttribute('href').slice(1)); function updateActive() { var current = ''; for (var k = 0; k < ids.length; k++) { var el = document.getElementById(ids\[k\]); if (el && el.getBoundingClientRect().top <= 80) current = ids\[k\]; } for (var m = 0; m < links.length; m++) { links\[m\].parentNode.classList.toggle('active', links\[m\].getAttribute('href') === '#' + current); } } window.addEventListener('scroll', updateActive, { passive: true }); updateActive(); })();

---

## Navigation

- Parent: [WarpEngine](https://wiki.teletypegames.org/hu/engines/warp-engine.md)
- Previous: [WarpEngine — Referencia](https://wiki.teletypegames.org/hu/engines/warp-engine/reference.md)
- Next: [WECP](https://wiki.teletypegames.org/hu/engines/warp-engine/wecp.md)
