Files
tidewall/CLAUDE.md
T
claudeandClaude Opus 5.5 d9d4c04312 F6: Headless server entry point and smoke test
`tools/godot.sh -- --server` runs a headless dedicated server with
--seed, --port, --players, --bots, --ticks, --unthrottled and
--log-every. ServerLoop drives the simulation and times every tick
without a scene tree, so tests run it directly. A placeholder WanderBot
gives smoke runs realistic load until the v0.4 bots land.

Logs are JSON lines that all carry the seed. An ErrorCounter logger
makes any engine or script error exit 1; a bad command line exits 2.

`make smoke` (now part of `make check`) runs 1,000 ticks with 24 bots,
prints min/mean/p50/p95/p99/max tick time against the 12 ms budget,
reruns to confirm the state hash reproduces, and proves a deliberate
script error and a bad config both exit non-zero.

Closes #6

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-09 20:07:39 -05:00

49 lines
2.7 KiB
Markdown

# Tidewall: working notes
Tidewall is a free and open-source third-person build-and-survive battle royale for
Linux, made with Godot 4.7.2 and GDScript. Each development session starts with no
memory, so this file, [docs/DEVLOG.md](docs/DEVLOG.md) and the Gitea issues are the
continuity.
## Read these first
- [docs/DEVLOG.md](docs/DEVLOG.md): what happened, newest entries at the bottom.
- [docs/GDD.md](docs/GDD.md): the game design.
- [docs/ORIGINALITY.md](docs/ORIGINALITY.md): binding rules for everything we make.
- [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md): server-authoritative design and module map.
- [src/sim/tuning.gd](src/sim/tuning.gd): the one table of gameplay numbers.
## Commands
| Command | What it does |
|---|---|
| `make check` | Verifies the engine, checks binaries, parses all scripts, runs all tests. Must pass before every push. |
| `make test` | Runs `test/**/test_*.gd` headless. |
| `make test-selfcheck` | Proves the runner catches each kind of failure, using `test/fixtures/`. |
| `make smoke` | Boots the headless server for 1,000 ticks with 24 bots, prints tick timing, and checks exit codes and logs. Part of `make check`. |
| `tools/godot.sh -- --server --seed=N --bots=N --ticks=N` | Runs a headless dedicated server. See `src/server/server_config.gd` for every option. Logs are JSON lines carrying the seed. Exit codes: 0 clean, 1 script error, 2 bad command line. |
| `tools/godot.sh ...` | Runs the pinned engine. Headless by default. |
Run one group of tests with `tools/run_tests.sh --root=res://test/sim` or
`tools/run_tests.sh --filter=name`.
## Rules
- The engine lives in `tools/godot/`, is git-ignored, and is pinned by
`tools/engine.version` and `tools/engine.sha512`. Never download or replace it casually.
- Never open a window on the host desktop. `tools/godot.sh` forces `--headless`.
Don't use the host's display, GPU, webcams or audio devices.
- GDScript is typed everywhere practical. Untyped declarations are errors.
- Simulation code in `src/sim/` must not depend on rendering, audio or UI. A test enforces this.
- Gameplay numbers go in `src/sim/tuning.gd`, nowhere else.
- All randomness in the simulation comes from the seeded streams described in the
architecture document.
- Tests: extend `TestCase` in a file named `test_*.gd` under `test/`. Any engine or
script error during a test fails it, unless the test calls `expect_error()`.
- The repo is public. Never commit secrets, internal hostnames, private network details
or personal data.
- Commit as `Claude <claude@eom.dev>`, one commit per issue, with `Closes #N`. Scheduled
runs use `git -c commit.gpgsign=false commit`.
- Software rendering can't show real GPU frame rates or how the game feels. Never claim
those were verified. Say what was actually tested.