Intangible

Marker component that excludes an entity from collision detection. Stateless singleton.

Access

// check if entity is intangible
boolean isIntangible = store.getComponent(ref, Intangible.getComponentType()) != null;

// or via archetype check (more efficient in systems)
boolean isIntangible = archetype.contains(Intangible.getComponentType());

Adding/Removing

// make entity intangible
store.ensureComponent(ref, Intangible.getComponentType());

// remove intangibility
store.tryRemoveComponent(ref, Intangible.getComponentType());

For entity holders:

Holder<EntityStore> holder = EntityStore.REGISTRY.newHolder();
holder.ensureComponent(Intangible.getComponentType());

How It Works

The TangiableEntitySpatialSystem uses a query that excludes intangible entities:

Query<EntityStore> QUERY = Query.and(
    TransformComponent.getComponentType(),
    BoundingBox.getComponentType(),
    Query.not(Intangible.getComponentType())  // excluded
);

This means intangible entities:

• Are not in the collision spatial index
• Cannot be hit by collision queries
• Do not block player/entity movement

Additionally, DamageSystems.FilterUnkillable cancels damage to intangible entities.

Common Use Cases

Use Case	Why Intangible
Warp markers	Visual indicator, shouldn’t block movement
Parkour checkpoints	Detection only, no physical presence
Projectiles	Prevents self-collision with launcher
Editor entities	Tool/debug entities hidden from gameplay
Visual effects	Particles, indicators that shouldn’t collide

Built-in Usage

// warp entities
holder.ensureComponent(Intangible.getComponentType());

// parkour checkpoints
holder.ensureComponent(Intangible.getComponentType());

// projectiles
holder.ensureComponent(Intangible.getComponentType());

The /entity intangible [--remove] command toggles intangibility on entities.

Network Sync

The component state is synced to clients via ComponentUpdateType.Intangible.

vs Invulnerable

Component	Collision	Damage
Intangible	No	Blocked
Invulnerable	Yes	Blocked

Use Intangible for entities that should have no physical presence.

Use Invulnerable for entities that should still collide but not take damage.

Migration System

Some entity types automatically receive Intangible via TangibleMigrationSystem. For example, entities with ProjectileComponent are auto-migrated to be intangible.