Physics Components

import { addComponent, RigidBody, Collider } from '@web-engine/core';
 
// Create dynamic physics object (ball)
const ball = world.addEntity();
addComponent(world, Transform, ball);
addComponent(world, RigidBody, ball);
addComponent(world, Collider, ball);
 
RigidBody.type[ball] = 0; // Dynamic
RigidBody.mass[ball] = 1.0; // 1 kg
RigidBody.friction[ball] = 0.3;
RigidBody.restitution[ball] = 0.8; // Bouncy
 
Collider.type[ball] = 1; // Sphere
Collider.size[ball][0] = 0.5; // radius
 
// Create static floor
const floor = world.addEntity();
addComponent(world, Transform, floor);
addComponent(world, RigidBody, floor);
addComponent(world, Collider, floor);
 
RigidBody.type[floor] = 1; // Fixed/Static
Collider.type[floor] = 0; // Box
Collider.size[floor][0] = 50; // half-width
Collider.size[floor][1] = 0.5; // half-height
Collider.size[floor][2] = 50; // half-depth

import { addComponent, Collider } from '@web-engine/core';
 
// Box collider
const box = world.addEntity();
addComponent(world, Collider, box);
Collider.type[box] = 0; // Box
Collider.size[box][0] = 1.0; // half-width (total width = 2.0)
Collider.size[box][1] = 1.0; // half-height
Collider.size[box][2] = 1.0; // half-depth
 
// Sphere collider
const sphere = world.addEntity();
addComponent(world, Collider, sphere);
Collider.type[sphere] = 1; // Sphere
Collider.size[sphere][0] = 0.5; // radius
 
// Capsule collider (character)
const character = world.addEntity();
addComponent(world, Collider, character);
Collider.type[character] = 2; // Capsule
Collider.size[character][0] = 0.3; // radius
Collider.size[character][1] = 1.8; // height
Collider.offset[character][1] = 0.9; // Center at half height
 
// Sensor (trigger) collider
const trigger = world.addEntity();
addComponent(world, Collider, trigger);
Collider.type[trigger] = 0; // Box
Collider.size[trigger] = [2, 2, 2];
Collider.isSensor[trigger] = 1; // Trigger, no collision

// Define groups (bitmasks)
const GROUP_PLAYER = 1 << 0;   // Bit 0
const GROUP_ENEMY = 1 << 1;    // Bit 1
const GROUP_PROJECTILE = 1 << 2; // Bit 2
const GROUP_GROUND = 1 << 3;   // Bit 3
 
// Player collides with enemies, projectiles, and ground
Collider.collisionGroup[player] = GROUP_PLAYER;
Collider.collisionMask[player] = GROUP_ENEMY | GROUP_PROJECTILE | GROUP_GROUND;
 
// Enemy collides with player, projectiles, and ground
Collider.collisionGroup[enemy] = GROUP_ENEMY;
Collider.collisionMask[enemy] = GROUP_PLAYER | GROUP_PROJECTILE | GROUP_GROUND;
 
// Projectile collides with player, enemy, and ground (but not other projectiles)
Collider.collisionGroup[projectile] = GROUP_PROJECTILE;
Collider.collisionMask[projectile] = GROUP_PLAYER | GROUP_ENEMY | GROUP_GROUND;
 
// Ground collides with everything
Collider.collisionGroup[ground] = GROUP_GROUND;
Collider.collisionMask[ground] = 0xFFFF; // All groups

import { addComponent, CharacterController } from '@web-engine/core';
 
// Create character controller
const player = world.addEntity();
addComponent(world, Transform, player);
addComponent(world, CharacterController, player);
 
// Configure movement
CharacterController.speed[player] = 6.0; // 6 m/s
CharacterController.jumpHeight[player] = 2.5;
CharacterController.height[player] = 1.8; // 1.8m tall
CharacterController.radius[player] = 0.4;
CharacterController.stepHeight[player] = 0.4; // Can climb 40cm stairs
CharacterController.maxSlope[player] = 50.0; // 50 degree slopes
 
// Apply movement (in update loop)
CharacterController.movement[player][0] = inputX; // horizontal
CharacterController.movement[player][2] = inputZ; // forward/back
 
// Jump
if (CharacterController.grounded[player] && jumpPressed) {
  CharacterController.verticalVelocity[player] =
    Math.sqrt(2 * 9.81 * CharacterController.jumpHeight[player]);
}

import { addComponent, Joint } from '@web-engine/core';
 
// Create hinge (door)
const door = world.addEntity();
const doorFrame = world.addEntity();
 
addComponent(world, RigidBody, door);
addComponent(world, Collider, door);
addComponent(world, Joint, door);
 
// Revolute joint at edge of door
Joint.type[door] = 2; // Revolute/Hinge
Joint.connectedEntity[door] = doorFrame;
Joint.anchor1[door][0] = -0.5; // Left edge of door
Joint.axis1[door][1] = 1; // Rotate around Y axis
Joint.min[door] = 0; // 0 degrees
Joint.max[door] = Math.PI / 2; // 90 degrees
 
// Create ragdoll arm joint (spherical)
const upperArm = world.addEntity();
const shoulder = world.addEntity();
 
addComponent(world, RigidBody, upperArm);
addComponent(world, Joint, upperArm);
 
Joint.type[upperArm] = 1; // Spherical
Joint.connectedEntity[upperArm] = shoulder;
Joint.anchor1[upperArm][1] = 0.3; // Top of upper arm
Joint.anchor2[upperArm][1] = -0.1; // Bottom of shoulder
 
// Create slider (piston)
const piston = world.addEntity();
const cylinder = world.addEntity();
 
addComponent(world, RigidBody, piston);
addComponent(world, Joint, piston);
 
Joint.type[piston] = 3; // Prismatic
Joint.connectedEntity[piston] = cylinder;
Joint.axis1[piston][2] = 1; // Slide along Z axis
Joint.min[piston] = 0;
Joint.max[piston] = 2; // 2 meters travel

import { addComponent, TriggerVolume, TriggerStateMap } from '@web-engine/core';
 
// Create trigger zone
const trigger = world.addEntity();
addComponent(world, Transform, trigger);
addComponent(world, TriggerVolume, trigger);
 
TriggerVolume.shape[trigger] = 0; // Box
TriggerVolume.size[trigger] = [5, 2, 5]; // 10x4x10 meter box
TriggerVolume.isActive[trigger] = 1;
 
// Check which entities are inside trigger
const entitiesInside = TriggerStateMap.get(trigger) ?? new Set();
for (const eid of entitiesInside) {
  console.log(`Entity ${eid} is in trigger`);
}