<!-- GENERATED FILE: do not edit by hand. --> <!-- Regenerate with npm run gen-docs. -->

Sources: packages/ecs/src/index.ts:COMPONENT_TYPE_DEFINITIONS, packages/ecs/src/index.ts:ComponentSchema, server/src/modules/runtime/capabilities/packs.ts:runtimeCapabilityPacks, web_client/spa/src/views/build/component-palette/taxonomy.ts:PALETTE_TAXONOMY.

Component Type Definitions

This is the canonical generated inventory for the v1 built-in ECS component set. Current engine capability sections may name these component types as shipped ECS components. Other component names must be explicitly marked roadmap-only, stripped-pattern history, or project-defined data.

Current built-in component count: 26. Current canonical component field count: 513.

Component catalog contract hash: sha256:aef9bd36d45d01f2845f09d64173f2ad1e690d79b1fb81194e0e3c22e178ae57. Component field contract version: ecs.component-field-contract.v1. Component field contract hash: sha256:a47f935d314b7b69edb176fa305be51b048f3ff076a5ba1765017e2f7e20e897.

All current built-in components are atomic engine components under ADR 0020. Gameplay patterns such as health, damage, spawn pools, collectors, and motion helpers are script patterns, not ECS atomics.

Inventory

Removed Component Contracts

Recently Stripped Pattern Components

ActionSourceComponent, BoundsComponent, CameraTargetComponent, CollectibleComponent, CollectorComponent, CollisionConsumeComponent, DamageEventComponent, DamageModifierComponent, DamageOnContactComponent, GravityComponent, GridAlignmentComponent, HealthComponent, HitscanWeaponComponent, InputAccessibilityProfileComponent, InputFeedbackComponent, InteractableComponent, JointComponent, MotionComponent, PlayerControllerComponent, ProjectileComponent, RespawnTimerComponent, SpawnPoolComponent, SplitActionComponent, StatsComponent, WeaponSlotComponent

Roadmap Components

These names are not current ECS components and may appear only in explicit roadmap sections.

AudioListenerComponent, BillboardComponent, NetworkVisibilityComponent, UIPanelLifecycleComponent

AnimationStateComponent

Declarative animation clip state scripts can mutate; renderers may map it onto clip playback and blending.

Canonical Field Contract:

Defaults:

{
  "type": "AnimationStateComponent",
  "clipKey": "idle",
  "playMode": "loop",
  "startTime": 0,
  "speed": 1
}

AudioEmitterComponent

Presentation primitive for positional and non-positional audio playback from an audio asset key.

Canonical Field Contract:

Defaults:

{
  "type": "AudioEmitterComponent",
  "volume": 1,
  "pitch": 1,
  "loop": false,
  "spatial": true,
  "maxDistance": 32,
  "playOnStart": false,
  "enabled": false
}

CameraComponent

Attach to an entity with Transform to make it a viewpoint players see through. The highest-priority active camera is used in Play mode. Follow target drives position; Look at target drives rotation while set.

Canonical Field Contract:

Defaults:

{
  "type": "CameraComponent",
  "fov": 60,
  "near": 0.1,
  "far": 2000,
  "projection": "perspective",
  "orthoSize": 10,
  "active": true,
  "priority": 10,
  "followOffset": {
    "x": 0,
    "y": 6,
    "z": 10
  },
  "followSmoothing": 0.15,
  "lookAtOffset": {
    "x": 0,
    "y": 0,
    "z": 0
  },
  "clearMode": "skybox",
  "clearColor": "#0b1020",
  "preserveEnvironmentLighting": false
}

CharacterMovementComponent

Authored config for the shared kinematic character controller: horizontal speed cap plus the deterministic vertical motor (gravity/jump/ground). The explicit KCC-governance flag opts an entity into predicted kinematic movement.

Canonical Field Contract:

Defaults:

{
  "type": "CharacterMovementComponent",
  "enableKcc": false
}

ColliderComponent

Passive server-owned shape for blocking active movers, physics contacts, triggers, placement diagnostics, and physics queries.

Canonical Field Contract:

Defaults:

{
  "type": "ColliderComponent",
  "shape": "sphere",
  "size": {
    "x": 1,
    "y": 1,
    "z": 1
  },
  "collision": "solid",
  "layers": [
    "default"
  ],
  "friction": 0.5,
  "restitution": 0
}

DecalComponent

Surface-layer projection primitive for markings, scuffs, and signs.

Canonical Field Contract:

Defaults:

{
  "type": "DecalComponent",
  "enabled": true,
  "projectionBox": {
    "x": 1,
    "y": 1,
    "z": 0.1
  },
  "color": "#ffffff",
  "opacity": 1,
  "projectionDepth": 0.1,
  "blendMode": "blend",
  "atlasSlot": {
    "u": 0,
    "v": 0,
    "width": 1,
    "height": 1
  }
}

ForceComponent

Private per-tick physics mutation queue consumed and cleared by the physics system.

Canonical Field Contract:

Defaults:

{
  "type": "ForceComponent",
  "pending": []
}

HairComponent

Places a canonical hair groom asset on an entity with bounded render, simulation, LOD, binding, and budget overrides.

Canonical Field Contract:

Defaults:

{
  "type": "HairComponent",
  "enabled": false,
  "materialOverrides": {},
  "render": {
    "representation": "auto",
    "shadowMode": "auto",
    "density": 1,
    "widthScale": 1,
    "lodBias": 0,
    "length": 0.95,
    "taper": 0.28,
    "hairlineGapDeg": 0
  },
  "simulation": {
    "mode": "none",
    "stiffness": 0.65,
    "damping": 0.35,
    "gravity": -9.8,
    "windInfluence": 0.15,
    "collision": "none"
  },
  "budget": {}
}

InputProfileComponent

One canonical input contract: action declarations, policy, prediction, and physical bindings nested under each action.

Canonical Field Contract:

Defaults:

{
  "type": "InputProfileComponent",
  "version": 1,
  "actions": [
    {
      "key": "player.move",
      "label": "Move",
      "valueType": "vector2d",
      "contexts": [
        "gameplay"
      ],
      "triggers": [],
      "processors": [],
      "policy": {
        "possessionRequired": true,
        "requiresBinding": true,
        "allowedActorKinds": [],
        "valueBounds": {
          "maxMagnitude": 1,
          "integer": false,
          "enumValues": [],
          "requiredFields": []
        },
        "lagCompensationMode": "live",
        "effectSystem": "movement"
      },
      "prediction": {
        "mode": "client_predicted"
      },
      "bindings": [
        {
          "id": "binding.move.wasd",
          "sources": [
            {
              "device": "keyboard",
              "control": "KeyW",
              "event": "down",
              "modifiers": []
            },
            {
              "device": "keyboard",
              "control": "KeyA",
              "event": "down",
              "modifiers": []
            },
            {
              "device": "keyboard",
              "control": "KeyS",
              "event": "down",
              "modifiers": []
            },
            {
              "device": "keyboard",
              "control": "KeyD",
              "event": "down",
              "modifiers": []
            }
          ],
          "triggerOverrides": [],
          "processors": [],
          "priority": 0
        }
      ]
    }
  ]
}

LightComponent

Real-time light source. Directional for sun-style, point for omni, spot for cones, area for windows or panels, ambient for global fill.

Canonical Field Contract:

Defaults:

{
  "type": "LightComponent",
  "mode": "directional",
  "color": "#ffffff",
  "intensity": 1,
  "distance": 0,
  "decay": 2,
  "angleDeg": 30,
  "penumbra": 0.2,
  "width": 2,
  "height": 2,
  "radius": 1,
  "enabled": true,
  "castShadow": false
}

LocalEnvironmentVolumeComponent

Bounded region that sparse-overrides the global environment (fog, ambient, aerial haze, exposure-compensation bias) with strict-priority blending toward the world default at its boundary.

Canonical Field Contract:

Defaults:

{
  "type": "LocalEnvironmentVolumeComponent",
  "enabled": true,
  "shape": "sphere",
  "radius": 8,
  "size": {
    "x": 8,
    "y": 8,
    "z": 8
  },
  "priority": 0,
  "blendDistance": 4,
  "overrideFog": false,
  "fogDensity": 0.02,
  "overrideAmbient": false,
  "ambientIntensity": 1,
  "overrideExposureCompensation": false,
  "exposureCompensationBias": 0
}

MaterialInstanceOverrideComponent

Optional per-entity material parameters layered over the referenced material asset at runtime.

Canonical Field Contract:

Defaults:

{
  "type": "MaterialInstanceOverrideComponent",
  "opacityMultiplier": 1,
  "emissiveIntensityMultiplier": 1
}

NavAgentComponent

Path-following navigation agent: steers an entity to a destination (or a followed target) across the world navmesh via the existing mover.

Canonical Field Contract:

Defaults:

{
  "type": "NavAgentComponent",
  "enabled": true,
  "destination": {
    "x": 0,
    "y": 0,
    "z": 0
  },
  "speed": 4,
  "arrivalRadius": 0.5
}

NetworkProfileComponent

How remote clients present this entity's replicated motion. Responsive hugs the newest server sample and never bridges gaps (teleporting projectiles, snappy pickups); Smooth doubles the interpolation buffer for perfectly fluid slow movers (platforms, doors); Default is the tick-derived baseline.

Canonical Field Contract:

Defaults:

{
  "type": "NetworkProfileComponent"
}

ParticleEmitterComponent

Budgeted billboard VFX emitter: emission rate, particle size and color ramps, lifetime, velocity, gravity, drag, spawn shape, blend/sort policy, texture, and plane collision.

Canonical Field Contract:

Defaults:

{
  "type": "ParticleEmitterComponent",
  "schemaVersion": 1,
  "enabled": true,
  "maxParticles": 64,
  "particleSize": 0.08,
  "color": "#ffffff",
  "opacity": 1,
  "lifetimeSeconds": 1,
  "emissionRate": 16,
  "seed": 1,
  "bounds": {
    "x": 1,
    "y": 1,
    "z": 1
  },
  "velocity": {
    "min": {
      "x": -0.1,
      "y": 0.3,
      "z": -0.1
    },
    "max": {
      "x": 0.1,
      "y": 1.2,
      "z": 0.1
    }
  },
  "gravity": {
    "x": 0,
    "y": -0.4,
    "z": 0
  },
  "drag": 0,
  "sortMode": "none",
  "blendMode": "alpha",
  "simulationPath": "auto",
  "depthWrite": false,
  "shape": {
    "type": "box",
    "spawnMode": "volume",
    "size": {
      "x": 1,
      "y": 1,
      "z": 1
    },
    "radius": 0.5,
    "angleDeg": 30,
    "arcDeg": 360,
    "edgeStart": {
      "x": -0.5,
      "y": 0,
      "z": 0
    },
    "edgeEnd": {
      "x": 0.5,
      "y": 0,
      "z": 0
    }
  },
  "collision": {
    "enabled": false,
    "planeNormal": {
      "x": 0,
      "y": 1,
      "z": 0
    },
    "planeOffset": 0
  }
}

ReflectionProbeComponent

Local reflection probe used by the renderer to select nearby environment lighting for PBR objects.