COGWORKS

COGWORKS is a tile-based routing puzzle game about guiding mechanical thought tokens through a clockwork board.

Core fantasy: Route the thoughts. Build understanding.

Milestone 0.5 is a playable Godot 4 prototype with five Resource-authored levels, Pause/Resume, 1x/2x simulation speed, route-length token ordering, distinct failure feedback, and automated timing/reset tests.

Run

1. Open cogworks-src/project.godot in Godot 4.6.1 or another compatible Godot 4.x release.
2. Press F6/F5 or run the configured main scene.

From PowerShell at the repository root:

.\Godot_v4.6.1-stable_win64.exe --path .\cogworks-src

Controls

• Select Straight, Turn, Arrow Router, or Erase from the bottom toolbar.
• Hover over a grid cell to preview the selected tile and rotation.
• Left-click a grid cell to place the selected tile or erase with the Erase tool.
• Right-click a placed tile to rotate it.
• Use Rotate to rotate the tile before placement.
• Use Undo to revert the last placement, erase, or rotation.
• Use Sound: On/Off to enable or disable placeholder sounds.
• Use Speed: 1x/2x to change token movement and spawner timing.
• Use Pause/Resume during a running simulation.
• Use Select Level on the left panel to open the five-level selector card.
• Play starts or restarts the simulation.
• Reset Simulation clears tokens and output progress while preserving placed tiles.
• Reset Board restores the original layout for the current level.

Validation

.\Godot_v4.6.1-stable_win64_console.exe --headless --path .\cogworks-src --quit-after 5
.\Godot_v4.6.1-stable_win64_console.exe --headless --path .\cogworks-src --script res://tests/mvp_smoke_test.gd
.\Godot_v4.6.1-stable_win64_console.exe --headless --path .\cogworks-src --script res://tests/tile_behavior_test.gd
.\Godot_v4.6.1-stable_win64_console.exe --headless --path .\cogworks-src --script res://tests/level_system_test.gd
.\Godot_v4.6.1-stable_win64_console.exe --headless --path .\cogworks-src --script res://tests/simulation_control_test.gd

See docs/LEVEL_SOLUTIONS.md for reference solutions, docs/ for design and architecture notes, and agents/ for ownership guidance.