ErrorCode

An AnimatedSprite was constructed with an empty frames array — an animation with no frames has nothing to draw.

An AnimatedSprite was given a non-positive, non-finite, or NaN fps. Frame duration is 1000 / fps, so a zero/negative/NaN rate yields an animation that never advances or spins without bound. Context: { fps }.

An asset was stored under a (namespace, key) already holding a different asset.

An asset failed to load — the underlying loader (PIXI, fetch/decode) rejected. The original failure is attached as cause. Context: { path, key, namespace, cause }.

An asset was requested by a key that isn't loaded in the AssetLibrary.

An asset was retrieved via getAs with a type that doesn't match the stored asset, or a load couldn't resolve the asset's type.

An audio file failed to load — the fetch resolved with a non-OK HTTP status. Context: { path, status, statusText }.

Playback was requested on something with no audio source to play.

An audio operation was attempted while the AudioEngine is in headless mode (no AudioContext — e.g. a test or server environment).

A component was added under a key already in use, without replacement being permitted. Context: { key }.

A lookup by type matched more than one registered component, so the engine can't pick one unambiguously. Look it up by key instead, use getComponentsByType to retrieve them all, or register only one component of the type. Context: { type }.

A component lookup by key found nothing. Thrown by the strict getComponent accessors on a component host when the key is absent; the nullable accessors return null instead. Context: { key }.

Game.createWorld was called while the game already has an active world. Destroy the existing world first if you mean to replace it. Context: { game }.

A world operation (e.g. Game.destroyWorld) was attempted while the Game has no active world. Context: { game }.

A write was attempted to a Cell's x or y coordinate — directly (cell.x = …) or via an inherited Point mutator (add, scale, forward, …). A cell's coordinate is its identity within the Grid index and is immutable; mutating it would desynchronise lookups. Call Point.clone to obtain a detached, mutable point for vector math. Context: { cell, axis }.

A Grid was constructed with a width or height that isn't a positive integer. A grid's dimensions are its fixed cell counts, so a fractional, zero, or negative size has no meaning. Context: { width, height }.

defineLayers was given the same layer name twice. Layer names are the lookup key, so they must be unique within a set. Context: { name }.

A layer was looked up that the set doesn't contain: LayerSet.get with an unknown name, or Scene.containerForLayer / the AbstractGraphics.layer setter with a Layer token minted by a different LayerSet. Context: { name }.

A graphics component named a GraphicsOptions.layer, but its world's Scene has no LayerSet — most often a forgotten layers: on the Game.createWorld call. Context identifies the host.

defineLayers (or the LayerSet constructor) was called with no layer names — a layer set must declare at least one layer.

A graphics component was added to a world whose Scene has a LayerSet, but the component named no GraphicsOptions.layer. In a layered world every graphic must choose a layer — there is no implicit default. Context identifies the host.

A RigidBody operation needed the body to be attached to a PhysicsWorld, but it wasn't (yet, or any longer).

A collider was described with a shape the physics layer can't translate into a Rapier collider (e.g. a degenerate or unsupported shape).

A RigidBody was constructed with no colliders — a body needs at least one collider to participate in the simulation.

A physics operation was attempted before initPhysics completed — Rapier's WebAssembly module hasn't been initialised yet.

A prefab was registered under a name already taken in the registry. Context: { name }.

Prefab.buildObject was called without the internal build token — i.e. not via World.createFromPrefab/createFromPrefabName. The token gates the build path so objects are always registered with the world.

A prefab name failed validation (empty, or otherwise malformed) at registration time. Context: { name }.

A prefab was requested by a name the registry doesn't know. Context: { name }.

A prefab operation needed a PrefabRegistry but none was attached to the world.

A weighted/uniform random pick was asked to choose from an empty collection. Context: identifies the calling method.

A dependency lookup by type matched more than one candidate, so the resolver can't bind it unambiguously.

A component's resolveDependencies required a sibling or world-tier component that isn't registered. Context: identifies the requesting component and the missing dependency.

A component's resolveDependencies re-entered dependency resolution (e.g. by adding components mid-resolve), which would corrupt the resolving state.

WorldObject.setParent would have created a cycle — the prospective parent is the object itself or one of its descendants. Parenting must form a tree, so a node can never be nested beneath its own subtree. Context: { child, parent }.

An object was added to a World under an id already held by another object. Object ids must be unique within a world so World.findById resolves unambiguously. Context: { id }.

WorldObject.setParent was given a prospective parent that belongs to a different World. The transform hierarchy is scoped to a single world — a parent and child must share one. Context: { child, parent }.