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: 34. Current canonical component field count: 613. Canonical fields without an authored Description: 274.

Component catalog contract hash: sha256:0af9015f319b9b377b819ed0edd0d597ae82bb45191f9694c7d372fd8673e68c. Component field contract version: ecs.component-field-contract.v1. Component field contract hash: sha256:356e4bf0cdad3dfd562a861224c5c4b676e89c1f32444edc46ad88fccbfb1423.

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,
  "rolloff": "inverse",
  "refDistance": 1,
  "maxDistance": 32,
  "playOnStart": false,
  "enabled": false
}

AvatarSlotComponent

Declares how a player's own avatar is applied to a Character rig: the height it is scaled to, the camera attach point, and the animation set it is expected to provide. At spawn the server resolves the player's avatar and records what it applied here. Colliders, movement, and the camera always stay on the rig, so an avatar never changes physics.

Canonical Field Contract:

Defaults:

{
  "type": "AvatarSlotComponent",
  "rigHeight": 1.8,
  "cameraSocket": {
    "x": 0,
    "y": 1.6,
    "z": 0
  },
  "animationSet": "humanoid.basic"
}

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"
}

CharacterMovementComponent

Authored config for the shared kinematic character controller: horizontal speed cap plus deterministic gravity and jumping over authored collision. 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": {}
}

HighlightComponent

Persistent selection or interest treatment drawn around an entity's oriented render bounds at the overlay stage.

Canonical Field Contract:

Defaults:

{
  "type": "HighlightComponent",
  "enabled": true,
  "color": "#ffd54a",
  "fillOpacity": 0,
  "depthMode": "occluded"
}

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
        }
      ]
    }
  ]
}

InstanceSetComponent

Thin placement/binding component for an aggregate of N packed instances (voxel chunk, foliage field, crowd, or destructible lot) backed by one canonical InstanceSet resource.

Canonical Field Contract:

Defaults:

{
  "type": "InstanceSetComponent",
  "enabled": true,
  "layout": {
    "kind": "grid"
  }
}

JointComponent

Physical constraint linking this rigid body to another: fixed weld, revolute hinge, prismatic slider, spherical ball socket, spring, or rope. Anchors and axis are in each body's LOCAL space; motors and limits exist only on revolute and prismatic joints. Author intent only - the runtime never writes joint state back.

Canonical Field Contract: