Table of Contents

Introduction

Ghost.Entities is an archetype-based ECS runtime designed for high throughput and predictable memory access.

At a high level:

  • World owns all ECS state for an isolated simulation context.
  • EntityManager performs structural/entity/component operations.
  • ComponentManager owns archetypes and cached queries.
  • EntityQuery provides data access and iteration over matching archetypes/chunks.
  • SystemManager and SystemGroup drive update order and lifecycle.

The runtime favors:

  • contiguous data layouts,
  • low-level spans/pointers in hot paths,
  • explicit structural changes,
  • deferred writes through EntityCommandBuffer for safe mutation points.

Use this section for conceptual docs, and doc/api/ for generated API reference.