addBodies
addBodies(physicsApi : Object, type : string, bodiesConfig : Array<Object>) : Promise<Array<Object>>Add multiple physics bodies in a single batch operation. Use this for maximum performance when adding many bodies at once.
Parameters
physicsApiObjectThe physics worker API (physics.api).
typestringBody type: 'static', 'dynamic', 'kinematic', 'zone'.
bodiesConfigArray<Object>Array of body configurations.
meshTHREE.Mesh | THREE.GroupSee nested options below.
meshTHREE.Mesh|THREE.GroupThe mesh to create physics for.propertiesoptionalObjectPhysics properties (friction, mass, etc.).bodyPropsoptionalObjectBody properties (capsuleRadius, etc.).optionsoptionalObjectOptional settings (hitbox, side, etc.).
Returns
Promise<Array<Object>> — Array of body API objects.Example
// Add many different meshes in one batch
const configs = meshes.map(mesh => ({
mesh,
properties: { friction: 0.5 },
}));
const apis = await addBodies(physics.api, BodyType.STATIC, configs);