# CONVERSION RECEIPT — The Minecraft Launcher, Re-founded in OmnaScript

*Lane: CONVERSION (founder order 2026-11-11 05:53 EST — "Convert it to our
programming language and call it a fucking day"). Credit: N8toriousAi.
Evidence class: HOST throughout. Filed 2026-11-11.*

## Problem

The founder uploaded a 2017 Debian package — T-Launcher 1.72 — whose entire
job is: take any username, no Mojang/Microsoft account, download the real
game, launch it. Its endpoints belong to another era
(`s3.amazonaws.com/Minecraft.Download/`, `authserver.mojang.com`,
`tlaun.ch/update/mcl.json` — census in SPECIMEN-CENSUS.md). The order was
not to resurrect it but to RE-FOUND what it does in our own language,
against today's official endpoints, on the stack's own pattern: a program
that carries the decisions, an executor that performs only what the
program pins.

## Attempts

1. **Specimen census first** (SPECIMEN-CENSUS.md): deb control data, the
   2,060,562-byte jar's 894-class census by family, and every endpoint
   string in the 2017 binary. The specimen is archaeology and a
   behavioural reference only — nothing was decompiled or translated.
2. **Language gap found and grown (Amendment A2).** OmnaScript v0.1 + A1
   had no way to declare a launcher. SPEC.md gained the `launcher` program
   kind: one `launcher {}` block of closed, cross-checked decision fields
   (version · official manifest · username 3–16 · java · memory · verify
   closed to sha1 · natives closed set · entry server/title · server/port
   iff entry=server · workspace-relative game-dir · Fabric loader ·
   controller mod · resource-pack slot). Orphan-version declarations
   refuse at compile time. Compiled output exports `createLauncherPlan()`.
   Compiler suite: **17/17 green**; pre-A2 program IR hashes unchanged;
   the vendored gym copy re-synced (sha256 `2f7b5639…` both sides).
   Caught by the suite mid-build: an orphan controller-version case —
   the refusal was correct, the test's needle was wrong; the test was
   corrected to the law and a second case added.
3. **Executor** (`launcher-executor.cjs`, zero-dependency, curl as the
   fetch tool per this host's proxy record): `provision | verify |
   launch`. Provision is the only network phase. Launch contains no
   network code path at all.
4. **Provision run 1 REFUSED at the Fabric step** — the executor treated
   Fabric meta's two-parameter loader response (an object) as the
   one-parameter array. Fixed to accept both shapes; the refusal did its
   job (nothing unpinned was ever fetched).
5. **Launch evidence bug, self-caught:** run 2 "reached tier 3" instantly
   because launch.log was appended across runs — the executor killed a
   healthy client mid-boot on the previous run's markers. Fixed: fresh
   per-run log, mtime-gated latest.log, longer post-tier grace. Filed
   here because the instrument lied once and the record should say so.
6. **The join frontier** (below, under What worked / Reason): three real
   client attempts + one vanilla control run against the spike's Paper
   server.

## What worked

- **The program compiles and reproduces.** `examples/launcher.omna`
  (Minecraft 1.21.11, per the spike lane's pin; manifest
  `https://piston-meta.mojang.com/mc/game/version_manifest_v2.json`;
  user Nomos; entry server 127.0.0.1:25565; Fabric 0.20.1; Controlify
  3.0.1+lts; resource-pack slot `house` awaiting-pin). Source sha256
  `d0b557cd09ed266d…`, IR sha256
  `03017275bfa6c1bbb17b4c18cc28dd1dc3d9f5ea90bf9dc79f80b3e4461ea518`,
  reproduced byte-identical on a second compile (Archive reproduction
  record).
- **Full-data provision completed.** 4,715 artifacts, 580,954,184 bytes,
  every sha1 verified at download (a mismatch deletes the bytes and
  refuses the whole provision). The plan is filed at
  `nomos-gym/real-minecraft-spike/client/launch-plan.json`, with the
  launch command arrays fully substituted and the data ledger embedded.
- **Verify (local only): 4,715 artifacts, all pins green.**
- **Launch (HOST): the real game stood up under its offline session.**
  The executor re-verified all pins locally, spawned Fabric's KnotClient
  under Xvfb with the proxy environment stripped (on this VM, no proxy =
  no egress: the launch is offline by construction, not by promise).
  Client log evidence, `nomos-gym/real-minecraft-spike/client/logs/`:
  LWJGL bootstrap · `Setting user: Nomos` · **61 mods loaded, Controlify
  among them** — SDL3 natives initialised, 398 gamepad mappings loaded,
  "No controllers found" (no pad on this VM; the mod is alive, which is
  the claim) · `Connecting to 127.0.0.1, 25565`.
- **The named frontier — the login handshake.** All three Fabric
  attempts and one **vanilla control client** (same plan, Fabric
  classpath entries removed) ended identically:
  `Connection closed during protocol change` 6–19 s after connecting,
  with zero trace in the server's log. A protocol bot (the spike lane,
  SPIKE-RECEIPT.md) joined the same server the same night and played.
  The discriminator exonerates the launcher, the plan, Fabric, and
  Controlify: what fails is a real client's login/configuration phase
  on this 1.5-vCPU VM while the server, the seat service, and the
  client contend for the same cores. On hardware that isn't starved —
  the phone-host graduation in the road's ledger — this is the first
  step to re-prove. Nothing here is phrased as a join, because it
  wasn't one.
- **Admission: Gaven admitted the citizen.** `minecraft-launcher` 0.1.0
  (kind tool; the executor as artifact, sha256 `a49dfa6407…`), after one
  consolidation hold (gr-0012, η 0.350 — my manifest's first filing
  used field shapes the court's verifier doesn't read: `cap` not `id`,
  counts on the evidence entries, seats inside provenance, a `tool`
  name in the build link; corrected to the court's forms and re-filed).
  Final verdict **gr-0013: ADMITTED, η 0.880** — provenance 1.0 (3 of 3
  links), capability 1.0, test 1.0, reproducibility 0.4 ("reproduced
  only by its own proposer, priced at 0.4 by law" — an independent
  reproduction is the citizen's one filed debt, the same honest shape
  as the omnascript-compiler citizen's 0.879).

## Reason

The vessel debate is closed by construction: the launcher is a program
in the family's own language, its executor performs only pinned effects,
and its citizen sits in the Archive under the same gate as everything
else. The 2017 jar's one virtue — any name, no account, the real game —
is preserved exactly, and everything it did by era-specific endpoints is
now done by hash-pinned official ones.

## Controller plan (steer 1 — founder, 05:57)

The assembled game is controller-ready out of the box; the founder plays
the same world on a pad while Nomos runs autonomously.

| Artifact | Pin | Pin source |
|---|---|---|
| Fabric Loader 0.20.1 (+ intermediary 1.21.11, loader libraries ×8, 4,721,875 B) | sha1 per artifact | Fabric maven `.sha1` checksums; loader is meta's stable for 1.21.11 |
| Controlify 3.0.1+lts (`controlify-3.0.1+lts+1.21.11-fabric.jar`) | sha1 `b33c16521138eca7f8cca2ef7672c7866ddd3433` | Modrinth version record hashes |
| Fabric API 0.141.6+1.21.11 (required dep) | sha1 `c98467cbbaf4d197377266795ae015f4130d65b6` | Modrinth |
| YACL 3.8.2+1.21.11-fabric (required dep) | sha1 `f99cda70903f16dd6927a276150b2762b4d5ab66` | Modrinth |

Rules kept: required dependencies resolve recursively and each must
carry a sha1 or provision refuses; the one optional dependency
(Mod Menu, project `mOgUt4GM`) was **skipped and the skip recorded in
the plan** — optional by its author's own declaration. MidnightControls
stands as the named alternative; it was not needed. Gate passed: every
mod artifact sha1-verified at provision and re-verified at every launch;
in-game, Controlify's own log lines (SDL3 init, 398 mappings) prove the
mod loaded, not merely landed.

## Resource-pack slot (steer 2 — founder, 05:57)

The plan carries a first-class slot: `resource-pack house` +
`resource-pack-state awaiting-pin`. The grammar holds the pin fields
(`resource-pack-sha1`, `resource-pack-source`) and refuses a `pinned`
state without them and an `awaiting-pin` state with them. The executor
writes the selection into the game dir's `options.txt` resourcePacks
line (today: `["vanilla","fabric"]`; the day the texture lane's first
pack build files its pin, the declaration flips to `pinned` and
`"file/<pack>"` joins the line with no executor change). Nothing
unpinned is ever fetched — the slot is a named, gated hole, not a
runtime download.

## OFFLINE LEDGER (founder ruling, 05:59)

**Provision time (once, all hash-pinned):** the version manifest +
version JSON (piston-meta) · client + 107 libraries + logging config
(piston-data / libraries.minecraft.net) · the full asset index, 4,593
objects (resources.download.minecraft.net) · Fabric meta + maven
artifacts · Modrinth file records + jars for Controlify and its
required dependencies. This is the only phase with network code.

**Launch / run time, our stack: NOTHING.** No auth call (the offline
session is constructed locally — offline UUID = Java
nameUUIDFromBytes semantics over `OfflinePlayer:Nomos`, access token
`0`), no manifest refresh, no update check. Launch re-verifies pins
from disk and spawns the game; the executor's child environment has
the proxy variables stripped, and this VM's only egress is that proxy.

**Honestly named:** Mojang's own binary makes its own background
attempts (yggdrasil key fetch, profile properties, Realms flags,
profile key pair) — visible failing in the client log, harmless, and
outside any launcher's control. The only runtime socket our plan
intends is the game protocol to 127.0.0.1:25565 — the founder's own
world-host on the same machine (online-mode=false, auth off). That is
gameplay, not a service call. The world-host (Paper) likewise attempts
one boot-time key fetch and runs on without it (spike receipt).

## DATA LEDGER (founder correction, 06:01 — no skimping)

One game directory, held once:
`~/workspace/nomos-gym/real-minecraft-spike/client/`

| Class | Count | Bytes |
|---|---|---|
| client jar | 1 | 31,152,600 |
| libraries (every artifact the version JSON names) | 107 | 77,744,472 |
| assets (full index, deduped by hash — the game's own store design) | 4,593 | 455,207,434 |
| asset index | 1 | 530,166 |
| version JSON | 1 | 42,184 |
| logging config | 1 | 1,073 |
| Fabric (loader profile + libraries) | 8 | 4,721,875 |
| mods (Controlify + 2 required deps) | 3 | 11,554,380 |
| **Total** | **4,715** | **580,954,184** |

**Against the manifest's own totals: gap ZERO.** Client bytes equal
the version JSON's declared size; the asset index's declared totalSize
(455,207,434) equals the bytes provisioned; named objects 4,593 =
unique objects 4,593 = files on disk 4,593.

Named non-gaps, so nobody has to re-derive them: (1) the version JSON
names **zero** native classifier downloads for 1.21.11 — in Mojang's
current packaging the natives ride inside the LWJGL jars and LWJGL
extracts them itself at runtime; the executor's natives step ran and
correctly had nothing separate to extract. (2) Of the 107 libraries,
70 sit on the launch classpath (the metadata's OS rules filter the
rest); all 107 are provisioned and verified regardless — full data,
launch assembly is a separate question. (3) Disk: the parent's brief
feared ~7 GB free; measured on the home volume before download:
51 GB free. No subsetting was needed or taken.

## Files

- `SPECIMEN-CENSUS.md` — the 2017 specimen, censused (this directory).
- `examples/launcher.omna` · `examples/launcher.compiled.cjs` — the
  program and its compiled form.
- `launcher-executor.cjs` — the executor (Archive artifact).
- `SPEC.md` (Amendment A2) · `START-HERE.md` — the language growth.
- Game dir: `nomos-gym/real-minecraft-spike/client/` — `launch-plan.json`
  (data ledger + resolved mod chain), `launch.log`, `logs/latest.log`,
  `executor-launch.log`.
- Archive: `tools/omnix-archive/citizens/minecraft-launcher.manifest.json`,
  evidence under `citizens/evidence/minecraft-launcher/`, gate receipts
  gr-0012 (consolidation) and **gr-0013 (admitted, η 0.880)**.
