cthangover
a0207d500b
docs/concepts: one concept per engine system (how it works, invariants and traps, tests, what the review fixed), with an index. docs/analysis/ rewrite-proposals.md: the structural causes behind the review's defects and how to replace them, with reasons, costs and an order; analysis only. AGENTS.md points to both and lists the mods with unit tests.
1.9 KiB
1.9 KiB
System concepts
One file per engine system: what it is for, how it works, the invariants and traps, its tests, and
what the 2026-10-20/21 review fixed in it. Read the concept before changing a system. The proposals
for larger rewrites are in ../analysis/rewrite-proposals.md.
| System | File |
|---|---|
| Mod pipeline: discovery, filtering, compilation, registration, reload, unload | mod-pipeline.md |
| Event bus and its GDScript bridge | event-bus.md |
| Data resolvers: entities, patches, files, textures, shaders, scenarios | data-resolvers.md |
| Collections, games and in-process switching | collections-and-games.md |
Scenes, scenario composition, conditions, node lookups, .tscn |
scenes-and-conditions.md |
| Dialog queue, DSL and event chains | dialog-queue.md |
| Scenario actions and GDScript mods | scenario-actions-and-gdscript.md |
| Saves and game state | saves.md |
| Characters | characters.md |
| Items, inventory, crafting | items-and-crafting.md |
| Quests and the data factories | quests.md |
| Skills | skills.md |
| Battles and recruiting | battles.md |
| Time and lighting | time-and-lighting.md |
| Audio | audio.md |
| World map | world-map.md |
| Interactives | interactives.md |
| Effects and Live2D | effects-and-live2d.md |
| UI, shell and menus | ui-and-shell.md |
| Localization | localization.md |
| Tools: editors, studio, validator, atlases, mod manager, catalog | tools.md |
| Testing infrastructure | testing.md |