oasis7 docs

Game + Engine Docs Hub

oasis7 Documentation Hub

One entry point for game design, gameplay engineering, viewer operations, and testing workflows. Current stage is technical preview (not playable yet); start with the homepage preview path before deciding to enter the full docs/build route.

See Preview Verification Path Then Open Catalog
Priority: preview experience first, full build/docs second Current posture: technical preview (not playable yet)

Public note: formal announcement is still being prepared; this docs hub supports technical-preview collaboration and verification, not a public release notice.

Choose by Goal

If you are not here to read the full tree, start from the path that matches your current task.

Preview

First check what is public right now

Best for first-time readers who need the current preview boundary, validation path, and public-facing posture.

Suggested order: site homepage → docs hub

Back to Homepage

Validation

I need to verify Viewer / Web / API locally

Best for smoke, regression, and release execution. Pick the test tier first, then open the focused manuals.

Suggested order: `testing-manual` → Viewer/Web manuals

Open Testing Manual

Development

I need to contribute code or continue governance

Best for contributors who need module PRD/project entry points before touching docs or code.

Suggested order: repo README → `doc/README.md`

Open Engineering Entry

Document Catalog

This catalog supports technical-preview transparency and development collaboration, not a playable user release.

Gameplay

Gameplay Top-level Design

Defines player motivations, three-layer loops, and design constraints for war/governance gameplay.

Status: primary design doc (continuously maintained)

Open Doc

Engine

Gameplay Engineering Architecture

Defines WASM gameplay layering, kernel API, module lifecycle, and safety boundaries.

Status: primary engineering doc (continuously maintained)

Open Doc

Viewer

Viewer User Manual

Covers active LLM access, the observer/debug-only `--no-llm` path, the Web step loop, and troubleshooting (Viewer is a pure observer service).

Status: static mirror rolls with the canonical manual

Open Manual

Testing

Closed-loop Testing Manual

Defines test tiers, system-level procedures, Web loop conventions, and suite matrix baselines.

Status: authoritative process doc (maintained in main repo)

Open Doc

Maintenance Workflow

  1. Maintain game/engine primary docs in `doc/game/*` and `README.md`.
  2. Maintain viewer/testing baselines in `doc/world-simulator/viewer/viewer-manual.manual.md`, `doc/testing/manual/web-ui-agent-browser-closure-manual.manual.md`, and `testing-manual.md`.
  3. Sync release-ready summaries into `site/doc/cn|en` static pages and publish via Pages workflow.

Current posture: technical preview (Not playable yet), manuals maintained in gameplay, engine, and observability layers.