GameCult/Delvehold
Watch
9
0
Fork
You've already forked Delvehold
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Merge readme-front-door: README front door

Browse source 
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Meta Vens 2026-10-22 20:15:40 +02:00
commit 95fc74dd15
1 changed files with 13 additions and 2 deletions
Download patch file Download diff file Expand all files Collapse all files

15
README.md
View file

@ -10,6 +10,14 @@ One shared world is projected through two modes:
One Godot C# client contains both modes. One central C# world host owns the
canonical simulation, and the two processes communicate through CultMesh.
**Valuable here:** the design of one persistent world with two projections (`Delvehold/Game Design/index.md`), and a working example of the CultMesh client/host split: a Godot C# client (`client/`) that can only send typed intents, and a single world host (`src/Delvehold.WorldHost`) that is the sole writer of canonical state, persisted as CultCache documents, with the shared operation payloads in `src/Delvehold.Protocol`.
**Problem it solves:** it is a proving ground. It forces CultMesh and the Aetheria architecture (typed commands and receipts, host-owned state, client prediction that cannot commit truth) to carry a whole game instead of a demo.
**Entry points:** `Delvehold/Documentation/Implementation Map.md` (what exists in source) and `Delvehold/Documentation/Authority Map.md`; the design authority is `Delvehold/Game Design/index.md`; `scripts/verify-runtime.ps1` builds and runs the client-to-host smoke path.
**Live versus planned:** live is the first runtime path only: the client discovers the host and sends `delvehold.world/enter`, and the host returns and persists an idempotent receipt for a seeded world (one workshop, one commons, one dungeon core, one contract, one material). The DELVE and HOLD gameplay in the design documents (expeditions, dungeon generation, workshop factory, Greathold) is planned, not implemented.
The published project notes live in `Delvehold/`. The site is a thin consumer of the shared [`GameCult-Quartz`](https://github.com/GameCult/GameCult-Quartz) engine and deploys to [delvehold.gamecult.org](https://delvehold.gamecult.org).
## Local documentation build
@ -24,8 +32,11 @@ Generated output is written to `quartz-site/public/`.
## Local runtime
The first runtime foundation expects the admitted CultLib worktree at
`F:\Projects\CultLib-aetheria-authority` and Godot 4.7.2 Mono at
The runtime needs a CultLib checkout at the revision pinned in
`Directory.Build.props` (`CultLibRevision`; builds reject another revision or a
dirty worktree) and Godot 4.7.2 Mono. `verify-runtime.ps1` takes them as
`-CultLibRoot` and `-GodotRoot`; its defaults are this workstation's
`F:\Projects\CultLib-aetheria-authority` and
`F:\Applications\Godot_v4.7.2-stable_mono_win64`. Build and exercise the
Godot-to-host CultMesh path, including a host restart, with: