world

Working repository for a simulation-first RPG world.

The goal is a headless, turn-based 2D grid world simulation that can support multiple clients: terminal, web, native UI, automated tests, and AI agents. The frontend is not the source of truth. The simulation core is.

Direction

• 2D grid-based, turn-based RPG world.
• Simulation depth matters more than graphics.
• Human players and AI agents should use the same action interface.
• Entities perceive only what their senses, knowledge, memory, and position allow them to perceive.
• World changes should flow through explicit actions, validation, events, and state updates.
• Content should be system-driven: materials, body parts, factions, knowledge, environment, tools, rituals, mutations, and social relationships should combine into emergent behavior.

Docs

• Vision
• Architecture
  • Architecture README
  • Architecture Roadmap
  • Architecture Decisions
  • Engine Architecture
  • Runtime Pipeline Architecture
  • Crate Boundary Architecture
  • Project Conventions
  • Implementation Plan
• Design
  • Simulation Core
  • Engine Core And Game System Boundary
  • Pack Authoring And Semantic Declarations
  • Simulation Transition Compiler
  • Truth, Authority, And Layer Boundaries
  • World Model
  • Physical Simulation Grammar
  • Typed Effect Primitives
  • Standard World Library And Primitive Semantics
  • Causal Runtime
  • Action And Event Model terminology sketch
  • Time Model
  • Capability, Affordance, And Actor Interface
  • Perception And Observation
  • Epistemic State
  • Social Institutional Model
  • Semantic Appraisal And Motivation
  • Intent Templates And Planning
  • Multi-Resolution Simulation
• Research
  • Engine Architecture Research Entry
  • Implementation Architecture And Library Survey
  • Causal Runtime / Action-Effect-Event
  • World Representation / Query Model
  • Time Model / Turn Scheduling
  • Epistemic State / Agent Memory
  • Semantic Appraisal, Intent, Activity, And Planning
  • Reference Research Questions
• References
  • Caves of Qud
  • RimWorld
  • Cataclysm: Dark Days Ahead
• Ideas
  • Design Ideas
  • Capability-Derived Actions
  • Knowledge, History, And Belief
  • Kernel Primitives
  • Typed Action Effects
  • Actor Intent And Activity
  • Actor Pressure And Interpretation
  • Layered Truth And AI Co-Authority
  • Multi-Resolution Simulation
  • Semantic Kernel And PL Boundary
• Brainstorming
  • Content Systems
  • Agent Interface
  • World Simulation