Transformed

A programming/automation game about preparing a hostile planet for humanity by launching autonomous androids into it.

Players do not directly control units. They design android bodies and write or generate sandboxed programs that operate under fog of war, limited sensors, CPU budgets, battery constraints, and range-based communication. Androids explore, build, terraform, fail, transmit telemetry, and teach the next generation.

Design docs

• Game design
• Game rules draft
• Game rules implementation progress
• Architecture
• Code approach
• Current implementation
• Player and agent tooling
• Replay and fog of war
• Replay viewer architecture
• Version one plan
• Event log data model

Current usage

Run a sample scenario:

pnpm transformed scenario run first-beacon-dev \
  --android examples/androids/colony-builder.js \
  --ticks 20 \
  --seed demo \
  --out replays/demo.json \
  --auto-launch \
  --players 1

Run a two-player local dev scenario with a per-player android override:

pnpm transformed scenario run first-beacon-dev \
  --android examples/androids/colony-builder.js \
  --android-player-2 examples/androids/cautious-scout.js \
  --ticks 20 \
  --seed demo \
  --out replays/two-player-demo.json \
  --players 2

Inspect one event:

pnpm transformed replay inspect replays/demo.json --event 20

Open the browser replay viewer:

pnpm transformed replay serve replays/demo.json --open

The replay viewer defaults to android perspective/fog of war to avoid spoiling hidden map information. Use --omniscient only for debugging.