add-interactivity

Use pointerEventsSystem.onPointerDown with a hoverText and maxDistance option. The entity needs a collider on the CL_POINTER layer, such as MeshCollider.setBox(entity) or visibleMeshesCollisionMask on a GltfContainer.

Create an entity with TriggerArea.setBox or setSphere and size it via Transform.scale, then use triggerAreaEventsSystem.onTriggerEnter. Filter to the local player by checking result.trigger?.entity against engine.PlayerEntity.

Pointer events require aiming the cursor at the entity, while proximity events fire when the player is nearby and roughly facing the entity without aiming. Pointer interactions always take priority, and proximity range is effectively limited to about 3 meters by the explorer's broad phase.

GltfContainer visible meshes are not clickable by default because visibleMeshesCollisionMask defaults to 0. Set it to ColliderLayer.CL_POINTER, or for skinned rigged models add an invisible child box collider parented to the entity.

A thin slab trigger volume never overlaps the avatar capsule while standing on it. Keep the thin plate as the visual and add a separate invisible trigger box about 2 meters tall centered above it.

maxDistance measures from the avatar position, not the camera, with a default of 10 meters. Use maxCameraDistance only for camera-origin checks, and note it is ignored entirely on proximity events.