TITLE=Home ROUTE=/ LOCALE=en MODIFIED=1792409344 URL=https://wiki.teletypegames.org/ L=1 #1 L=2 #22 L=3 #31 L=4 https://teletypegames.org L=5 #68 L=6 #42 L=7 #70 L=8 #58 L=9 #56 L=10 #60 L=11 #61 L=12 #62 L=13 #64 L=14 #57 L=15 #63 L=16 #7 L=17 #10 L=18 #12 L=19 #24 L=20 #20 L=21 #21 L=22 #66 L=23 #46 L=24 #45 L=25 #47 L=26 #43 L=27 #44 L=28 #34 L=29 #72 L=30 #28 L=31 #33 L=32 #71 L=33 #69 L=34 #51 L=35 #52 L=36 #48 L=37 https://git.teletypegames.org L=38 https://ci.teletypegames.org L=39 https://pm.teletypegames.org L=40 https://uptime.teletypegames.org L=41 https://assets.teletypegames.org q│ bTeletype Gamesq is an independent game development collective. We make small q│ retro-flavoured games on eight platforms — from Go and Godot to the q│ Commodore 64 — and we build the whole road they travel: a CI pipeline that q│ turns a push into a release, a public catalog where every title plays in the q│ browser or downloads for desktop, and stores that carry the catalog onto a q│ Batocera box, into RetroArch or onto a desktop. This wiki documents all of q│ it. The engineering pages are public; the team and project pages need a q│ login. 1The road from a repo to a player 1════════════════════════════════ t┌─────────────────┬─────────────────────────────────┬────────────────────────┐ t│h Stage t│h What happens t│h Read t│ t├─────────────────┼─────────────────────────────────┼────────────────────────┤ t│0 b1. A game repo0 t│0 A project on our Gitea holds t│0 1Platforms t│ t│0 t│0 its sources and a one-line t│0 t│ t│0 t│0 c.woodpecker.yaml0 marker naming t│0 t│ t│0 t│0 its platform. t│0 t│ t├─────────────────┼─────────────────────────────────┼────────────────────────┤ t│0 b2. The pipeline0 t│0 Woodpecker asks the catalog t│0 2WarpEngine, 3Deployment t│ t│0 t│0 server, and WarpEngine serves t│0 t│ t│0 t│0 the whole build config: t│0 t│ t│0 t│0 version, build, package, t│0 t│ t│0 t│0 upload, publish. The builder t│0 t│ t│0 t│0 images live server-side. t│0 t│ t├─────────────────┼─────────────────────────────────┼────────────────────────┤ t│0 b3. The catalog0 t│0 The release lands on t│0 5Public site t│ t│0 t│0 4teletypegames.org: a web build t│0 t│ t│0 t│0 to play in the browser, native t│0 t│ t│0 t│0 zips to download, a cartridge t│0 t│ t│0 t│0 for real hardware. t│0 t│ t├─────────────────┼─────────────────────────────────┼────────────────────────┤ t│0 b4. The stores0 t│0 The same catalog is installed t│0 6Stores t│ t│0 t│0 onto a Batocera box, rendered t│0 t│ t│0 t│0 as RetroArch playlists, or t│0 t│ t│0 t│0 browsed in the desktop client. t│0 t│ t├─────────────────┼─────────────────────────────────┼────────────────────────┤ t│0 b5. The shop0 t│0 Teletype Orbit puts prices, t│0 7Teletype Orbit t│ t│0 t│0 entitlements and gated t│0 t│ t│0 t│0 downloads on top of the t│0 t│ t│0 t│0 catalog, with the same client t│0 t│ t│0 t│0 on the other end. t│0 t│ t└─────────────────┴─────────────────────────────────┴────────────────────────┘ r────────────────────────────────────────────────────────────────────────────── 1Platforms 1═════════ Every platform page has the same shape: how a project is laid out, the Makefile for local work, the served pipeline step by step, and what the release carries. t┌──────────────────┬───────────────┬─────────────────────────────────────────┐ t│h Platform t│h Language t│h What a release carries t│ t├──────────────────┼───────────────┼─────────────────────────────────────────┤ t│0 8Ebitengine t│0 Go t│0 Web build, Windows and Linux binaries; t│ t│0 t│0 t│0 macOS by hand t│ t├──────────────────┼───────────────┼─────────────────────────────────────────┤ t│0 9Bevy t│0 Rust t│0 Web build, Windows and Linux binaries t│ t├──────────────────┼───────────────┼─────────────────────────────────────────┤ t│0 10Godot t│0 GDScript / C# t│0 Web build, Windows, Linux and a t│ t│0 t│0 t│0 universal macOS build t│ t├──────────────────┼───────────────┼─────────────────────────────────────────┤ t│0 11LÖVE t│0 Lua t│0 Web build via love.js, Windows, Linux t│ t│0 t│0 t│0 and macOS t│ t├──────────────────┼───────────────┼─────────────────────────────────────────┤ t│0 12Phaser t│0 JavaScript t│0 Web build — no compilation at all t│ t├──────────────────┼───────────────┼─────────────────────────────────────────┤ t│0 13TIC-80 t│0 Lua t│0 Cartridge, source, docs, web build and t│ t│0 t│0 t│0 native players t│ t├──────────────────┼───────────────┼─────────────────────────────────────────┤ t│0 14Commodore 64 t│0 6502 assembly t│0 c.prg0 cartridge, a browser player and t│ t│0 t│0 t│0 native players for Linux, Windows and t│ t│0 t│0 t│0 macOS t│ t├──────────────────┼───────────────┼─────────────────────────────────────────┤ t│0 15Commodore Plus/4 t│0 6502 assembly t│0 The same as the C64, on the 264 series t│ t└──────────────────┴───────────────┴─────────────────────────────────────────┘ Alongside the platforms: 16LibreSprite and 17Pixelorama for pixel art, and the 18RoR 18Styleguide, the rules our Rails applications follow. r────────────────────────────────────────────────────────────────────────────── 1Engines 1═══════ The reusable parts, each its own repository and product. t┌────────────┬──────────┬────────────────────────────────────────────────────┐ t│h Engine t│h Language t│h What it is t│ t├────────────┼──────────┼────────────────────────────────────────────────────┤ t│0 2WarpEngine t│0 Ruby t│0 Mountable Rails engine: the retro software t│ t│0 t│0 t│0 catalog, the CI pipeline server, the build t│ t│0 t│0 t│0 endpoints and the public JSON API behind the t│ t│0 t│0 t│0 public site and Teletype Orbit t│ t├────────────┼──────────┼────────────────────────────────────────────────────┤ t│0 19warpstore t│0 Python t│0 The shared core of the store engines: one t│ t│0 t│0 t│0 dependency-free file that knows a WarpEngine t│ t│0 t│0 t│0 catalog t│ t├────────────┼──────────┼────────────────────────────────────────────────────┤ t│0 20Inkwell t│0 Go t│0 Point-and-click adventure framework on Ebitengine, t│ t│0 t│0 t│0 a SCUMM-era skeleton as a thin DSL t│ t├────────────┼──────────┼────────────────────────────────────────────────────┤ t│0 21RuBBS t│0 Ruby t│0 Framework for Synchronet-style Telnet BBS servers, t│ t│0 t│0 t│0 behind our own 22BBS Server t│ t└────────────┴──────────┴────────────────────────────────────────────────────┘ r────────────────────────────────────────────────────────────────────────────── 1Stores 1══════ How the catalog reaches a player's machine. t┌────────────────────────┬─────────────────────────┬─────────────────────────┐ t│h Store t│h Runs on t│h What it does t│ t├────────────────────────┼─────────────────────────┼─────────────────────────┤ t│0 23WarpEngine Client t│0 Windows, Linux, macOS t│0 Desktop app: the t│ t│0 t│0 t│0 catalog as a grid of t│ t│0 t│0 t│0 cards, with the store t│ t│0 t│0 t│0 engine built in t│ t├────────────────────────┼─────────────────────────┼─────────────────────────┤ t│0 24WarpEngine Batocera t│0 Batocera t│0 Installs a catalog into t│ t│0 24Store t│0 t│0 the ROM folders under t│ t│0 t│0 t│0 its own t│ t│0 t│0 t│0 EmulationStation menu t│ t├────────────────────────┼─────────────────────────┼─────────────────────────┤ t│0 25WarpEngine RetroArch t│0 Anything RetroArch runs t│0 Renders a catalog as t│ t│0 25Store t│0 on t│0 c.lpl0 playlists with box t│ t│0 t│0 t│0 art t│ t├────────────────────────┼─────────────────────────┼─────────────────────────┤ t│0 26TTG Batocera Store, t│0 — t│0 Our own store t│ t│0 27TTG RetroArch Store t│0 t│0 definitions on top of t│ t│0 t│0 t│0 the two engines t│ t└────────────────────────┴─────────────────────────┴─────────────────────────┘ r────────────────────────────────────────────────────────────────────────────── 1Infrastructure 1══════════════ t┌───────────────────────┬────────────────────────────────────────────────────┐ t│h Page t│h What it covers t│ t├───────────────────────┼────────────────────────────────────────────────────┤ t│0 28Server t│0 The self-hosted box: Nginx, Traefik, Gitea, t│ t│0 t│0 Woodpecker and the rest t│ t├───────────────────────┼────────────────────────────────────────────────────┤ t│0 3Deployment t│0 Docker Compose architecture and the CI/CD path t│ t│0 t│0 from push to running service t│ t├───────────────────────┼────────────────────────────────────────────────────┤ t│0 5Public site t│0 teletypegames.org: the Rails catalog API and the t│ t│0 t│0 retro-styled frontend t│ t├───────────────────────┼────────────────────────────────────────────────────┤ t│0 7Teletype Orbit t│0 The shop platform on WarpEngine: purchases, t│ t│0 t│0 entitlements, gated downloads t│ t├───────────────────────┼────────────────────────────────────────────────────┤ t│0 29Wiki Site t│0 This wiki: Grav, the git-backed content, the t│ t│0 t│0 fetcher, the JSON API, the two languages t│ t├───────────────────────┼────────────────────────────────────────────────────┤ t│0 22BBS Server t│0 The Telnet front-end of the wiki t│ t├───────────────────────┼────────────────────────────────────────────────────┤ t│0 30Backup, 31ResourceSpace t│0 Off-site backups; the asset library for artwork t│ t│0 t│0 and media t│ t└───────────────────────┴────────────────────────────────────────────────────┘ r────────────────────────────────────────────────────────────────────────────── 1Team and projects 1═════════════════ These sections need a login. • bTeam0 — the Constitution, Communication channels, Members, the Accounts onboarding guide, weekly Meetings and the PDLC development lifecycle. • bProjects0 — Definitely Not an Impostor and Underwater Sun Rising, the two games of the Norman Arc, with the Neumatronic Universe lore behind them; Rabbit Roller and its C64 port Rabbit Scooter; Blessing of Ra and the C64 Demo. r────────────────────────────────────────────────────────────────────────────── 1Others 1══════ t┌──────────────────────────┬─────────────────────────────────────────────────┐ t│h Page t│h What it is t│ t├──────────────────────────┼─────────────────────────────────────────────────┤ t│0 32Discord Updater Bot t│0 Polls the wiki, Redmine and Gitea and announces t│ t│0 t│0 new activity on Discord t│ t├──────────────────────────┼─────────────────────────────────────────────────┤ t│0 33Discord Thread Scheduler t│0 Opens the weekly meeting thread at a set time t│ t├──────────────────────────┼─────────────────────────────────────────────────┤ t│0 34Paper Sketch t│0 A guide to designing a game on paper before t│ t│0 t│0 touching a tool t│ t├──────────────────────────┼─────────────────────────────────────────────────┤ t│0 35Useful materials t│0 Curated indie articles, films and funding t│ t│0 t│0 sources t│ t└──────────────────────────┴─────────────────────────────────────────────────┘ r────────────────────────────────────────────────────────────────────────────── 1Where to start 1══════════════ • bStarting a game?0 Pick a platform above; each page ends with the pipeline that publishes it. • bA release is missing something?0 2WarpEngine explains the asset kinds and the checklist that finds the gaps. • bPutting the games on a retro box?0 6Stores. • bJoining the team?0 Accounts and Communication, after signing in. • bSomething the wiki names and you have never heard of?0 The 36Technologies register lists every language, tool and library with a link to where it is used. • bHow this wiki itself works?0 29Wiki Site. 1Around the wiki 1═══════════════ 37Gitea · 38Woodpecker CI · 4teletypegames.org · 39Redmine · 40Uptime Kuma · 41ResourceSpace