Engineering & AI

Inkline Town: testing a simulation game without a browser

Inkline Town is an open-source town-building game that shows developers how to replay player commands to reproduce simulation bugs without a browser.

Summary

  • Inkline Town gives developers an example of how to test game rules outside the browser.
  • Keep the seed, the player commands and the step at which each was applied to reproduce a simulation bug.
  • Use browser tests for building placement, 3D camera controls and the phone layout.
Inkline Town: testing a simulation game without a browser

A player reports that a timber cart got stuck, but the cart moves normally when you reload the map. Inkline Town shows how to capture the seed and the player’s commands so you can reproduce the failure and test the transport rules outside the browser.

What does Inkline Town help you do?

Ritmo ECS runs the simulation in fixed steps. The UI, bots, and tests share a command queue, while PixiJS 3D reads state to draw the scene. To reproduce a bug, keep the seed, initial settings, and the step at which each command was applied. Developer documentation

When is it worth using?

Study this design when rules such as production, inventory, and transport interact. For a demo focused on camera controls or line art, extra layers can cost more effort than the experiment warrants. The repository uses Apache-2.0. Inkline Town license

How to try it and check the result

Give your coding agent a seed, a road connecting a logging camp to a sawmill and one case to test, such as removing the road before the cart picks up its load. Specify the expected inventory change after a fixed number of steps.

  1. Run the delivery case twice with the same settings and commands. Compare inventory and cart state at the same simulation step.
  2. Remove the connecting road and rerun. The test should detect a change in deliveries.
  3. Check real browser interactions for building placement, 3D camera controls, or the phone layout. Start the dev server and run pnpm check:browser. Browser test instructions

Source review of commit aa7dbe0 on 20 November 2026. HubCom has yet to use this architecture on a client project.

Terms in this article (5)
Inkline Town
A browser-based 3D town builder with publicly viewable source code.
Ritmo ECS
A library that represents game objects as entities with data components. Systems read or update that data according to game rules.
PixiJS 3D
The scene-rendering library Inkline Town uses to draw the town in 3D.
Headless
Running the simulation from code for testing without opening the user interface.
Seed
An input value that reproduces the same map when the map-generation settings stay the same.

Frequently asked questions

Can I play Inkline Town on the web?

Yes. The author hosts the game at inkline.typeonce.games. Saves stay on your device.

Do I need PixiJS 3D to test game rules?

The simulation runs headless. Use a browser to test interactions and rendering.

Is a seed enough to replay a game?

To reproduce the sequence, also keep the initial settings, the player commands and the step at which each command was applied.

Sources

Talk with HubCom ↗