Rainer LeitandClaude Fable 5.1
1945ef033b
Off the ladder at the user's request. Scripts/Authoring/generate_heightmap.py (numpy, installed locally by bootstrap-pylib.sh) writes a 16-bit height PNG and three 8-bit weight PNGs to Content/World/Heightmaps; create_world.py rebuilds /Game/Maps/L_World from them through ULandscapeAuthoringLibrary in the new SaltyEditor module, which wraps ALandscape::Import because the engine exposes no landscape creation to Python. Uses Elite_RockyMeadows' landscape material and layer infos (the pack itself is still uncommitted). 4033 vertices a side at 350 cm a quad; swap the PNGs and rerun to change the terrain. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Documentation
Two layers, kept apart on purpose.
For people. Short, and meant to be read end to end.
| Doc | Covers |
|---|---|
| Design.md | What this is, the three things it proves, the fixed decisions, what it is not yet, the glossary. Start here. |
| Steps.md | The ladder of work: fifteen rungs, each closed by a proof. The next few in full, the rest sketched. |
| Ideas.md | The ideas carried over from the two earlier projects as features a world could hold, with what each needs. None scheduled. |
| Decisions.md | One line per decision with a pointer, the open decisions that block steps, and what is deliberately deferred. |
| Worklog.md | One terse line per step closed or wall hit. The memory. |
For an implementer that lifts code, which today means Claude. Long, C++-shaped, and meant to be built from.
| Doc | Covers |
|---|---|
| Spec/README.md | Notation, status markers, the twelve cross-cutting rules every spec obeys. Read before any spec. |
| Spec/Architecture.md | Modules, lifetimes, authority, content, tags, the C++/Blueprint line, testing, conventions, gotchas. |
| Spec/Stats.md | The one stat block every body carries, effects and where they come from, stacking, counters. |
| Spec/Movement.md | The character, the movement component, input, the look model, camera modes, the gym, the feel checklist. |
| Spec/Interaction.md | The one interaction system, carrying, throwing, highlighting. |
| Spec/Combat.md | Attributes, the damage funnel, the swing, enemies, downed and revive, abilities and kits, projectiles. |
| Spec/Crafting.md | Families, parts, pieces, traits, substances, the pure rules, stations, activities, enchanting, the weapon seam. |
| Spec/Networking.md | The authority table, the responsiveness tiers, the posture, sessions, identity, persistence. |
| Spec/Telemetry.md | The sink, the envelope, the catalogue. |
| Spec/UI.md | The HUD, the prompt, the theme, world-space text, localisation, the menu. |
Reading order
New here: Design.md, then Steps.md, then Spec/README.md and Spec/Architecture.md. About to build a step:
the step's entry in Steps.md, then the spec sections it links. About to decide something: Decisions.md first,
to see whether it was already decided or deliberately deferred.
Conventions
- Version and status live in a document's header where it has one, never in its filename.
- Links are relative so the folder survives being moved.
- A spec that turns out wrong in the building is corrected in the same change as the code, under a What was built, and where it differs heading at its end.
- A decision goes in
Decisions.mdthe moment it is made. Newest first; never delete, supersede. - The two earlier projects are referred to by name (Adventurer Guild, Project Malleable) when an idea's origin matters, and not otherwise. Their docs are not copied here; they are in their own repositories.