Game Design and Rulesets

Game Design and Rulesets

The canonical rulesets remain in the source repository under docs/rulesets/. This page is an index and reading guide, not a duplicate source of truth.

Core Rule

The rulesets define the game. Existing temporary validation worlds, reduced starter registries, and old temporary block/item names are migration inputs only.

Ruleset Index

Ruleset	Purpose
Voxel Survival and Crafting Ruleset	Survival stats, terrain/block catalog, resources, mining, tools, crafting, inventory, farming, lights, and progression.
Voxel Creative Ruleset	Creative overrides, inventory, placement, mining, world editing, pick block, containers, permissions, menus, and saves.
Voxel Survival/Crafting Game Menu Specification	VR UI principles, menu list, flows, screen specifications, actions, state models, and implementation notes.
Voxel Unified Save and Versioning Schema	Version taxonomy, save layout, stable IDs, registry migrations, chunks, blocks, inventory, players, environment, structures, autosave, repair, and compatibility.
Voxel World Environment Effects Ruleset	Time, day/night, lighting, temperature, clouds, weather, fog, snow, ice, gameplay hooks, rendering notes, and save data.
Voxel Biome Vegetation Ruleset	Vegetation IDs, tree models, biome profiles, templates, placement, growth, regrowth, leaf decay, harvest, and persistence.
Voxel Structure Generation Ruleset	Structure categories, definitions, placement, terrain fit, templates, palettes, loot, roads, degradation, and persistence.
Voxel Multiplayer and Networking Ruleset	Networking stack, session flow, authority, handshake, sync, block mutation, prediction/reconciliation, survival commands, avatars, persistence, voice, security, roles, and testing.
Voxel Audio and VFX Ruleset	Feedback events, audio buses, cue catalogs, haptics, VFX, environment feedback, multiplayer feedback, accessibility, performance, and acceptance criteria.
Voxel Known-Good Git Tagging Policy	Annotated kg/... checkpoint tags, creation rules, verification, recovery, and tag immutability.
Voxel Implementation Alignment Matrix	Migration/refactor aid for mapping old temporary vocabulary into canonical ruleset vocabulary.

How to Use This Page

Use this page to find the right source document. When changing gameplay, save schema, menus, multiplayer, art/audio feedback, environment, structures, vegetation, or validation policy, update the relevant source file in docs/rulesets/ and mention the wiki only as the reader-facing index.