codebase-state-structure

Community

Map and extend GameState model

AuthorEliasVahlberg
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Provides a clear, centralized reference for the game's persistent and runtime data layout so developers can quickly find where gameplay state is stored, how it is serialized, and what must be updated when extending the model.

Core Features & Use Cases

  • Overview of the primary GameState and its decomposed sub-structs: PlayerState, WorldState, and NarrativeEngine, including major fields and responsibilities.
  • Patterns and invariants to follow: spatial index lazy-rebuild, message capping, event emission pipeline, and which fields are skipped from serialization.
  • Practical guidance for tasks like adding new persistent or transient fields, marking fields with serde attributes, and bumping SAVE_VERSION to maintain save compatibility.

Quick Start

Ask the assistant to show where to add a new persistent field to PlayerState and what files and save version changes are required.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: codebase-state-structure
Download link: https://github.com/EliasVahlberg/saltglass-steppe/archive/main.zip#codebase-state-structure

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.