Skip to content

Plantangenet Simulation

Welcome to the internal documentation for Plantangenet, the core simulation platform.

Here you will find accurate, reference-grade documentation on our native Rust runtime, simulation services, schema definitions, and world architecture.

Getting Started

Rather than a "getting started" tutorial, this site focuses on the architectural components you need to understand to work on the Plantangenet simulation.

  • Runtime & Frame Lifecycle — Understanding how FrameManager cycles simulation ticks (the FramePhase), what ForgeService trait implementations exist, and how changes propagate per frame.
  • Brand Plugins — Building, loading, and running brand plugins via the WebAssembly Component Model. Includes a hello world tutorial, the WIT contract reference, and guides for both server and browser hosts.
  • SDK — Client SDKs for driving hobs and interacting with world-runner from JavaScript and Python.
  • Registries & Core Schemas — (Coming Soon) The storage layer for Hob, Inventory, Achievements, Roads, and Deformation.

Architecture Overview

Plantangenet uses an active simulation host (the FrameManager) that drives a collection of passive data stores (the WorldContext) through a set of mapped lifecycle hooks. This formalizes a clock-driven runtime out of what is typically an event-driven storage paradigm.