docs: single-threaded simulation study (#54) + ModernUO as reference #55

Merged

marco merged 1 commit from docs/command-queue-study into main

2026-07-19 01:13:06 +02:00

marco commented

2026-07-19 01:05:41 +02:00

Owner

Closes the study part of #54. docs/command-queue-study.md: the two world models (lock-shared vs single-threaded sim), validated against ModernUO (single game thread + timer wheel, no world lock, packets processed on the game thread → immediate feedback, B2 flavor). Decision: adopt B, migrated via a single-threaded executor, phased green. Combat model: pipeline in a system + per-type OnHit reaction hooks on the entity (the middle way). Also records ModernUO as our architectural reference in CLAUDE.md. No code — implementation is the phased plan in the doc (Phase 1 next).

Closes the study part of #54. `docs/command-queue-study.md`: the two world models (lock-shared vs single-threaded sim), validated against **ModernUO** (single game thread + timer wheel, no world lock, packets processed on the game thread → immediate feedback, B2 flavor). Decision: **adopt B**, migrated via a single-threaded executor, phased green. Combat model: pipeline in a system + per-type `OnHit` reaction hooks on the entity (the middle way). Also records **ModernUO as our architectural reference** in CLAUDE.md. No code — implementation is the phased plan in the doc (Phase 1 next).

marco added 1 commit

2026-07-19 01:05:41 +02:00

docs: single-threaded simulation study (#54 ) + ModernUO as architectural reference

ci / Lint & Test (pull_request) Successful in 1m49s

Details

271a5c529a

Decision from #54: adopt the ModernUO-style single-threaded simulation (option B) — thin
World, no world lock, IO threads marshal messages to one sim thread. Validated against
ModernUO (single game thread, timer wheel, packets processed on the game thread, no world
lock). Combat model: keep resolution in a system, per-type OnHit reaction hooks on the
entity (the middle way). Records ModernUO-as-reference as a working-agreement principle.

marco merged commit 0ab18a4d32 into main

2026-07-19 01:13:06 +02:00

marco deleted branch docs/command-queue-study

2026-07-19 01:13:07 +02:00

marco referenced this pull request from a commit

2026-07-19 01:13:07 +02:00

docs: single-threaded simulation study (#54) + ModernUO as reference (#55)