Tiny, data-driven, high performance ECS library written using JavaScript TypedArrays.
<3kb
gzipped- Zero dependencies
- Node or Browser
- Blazing fast
npm i bitecs
import World from 'bitecs'
// Create a world
const world = World()
// Register some components
const POSITION = world.registerComponent('POSITION', { x: 'float32', y: 'float32' })
const VELOCITY = world.registerComponent('VELOCITY', { vx: 'int8', vy: 'int8', speed: 'uint16' })
// Register a system
world.registerSystem({
name: 'MOVEMENT',
components: ['POSITION', 'VELOCITY'],
update: entities => {
for (let i = 0; i < entities.length; i++) {
const eid = entities[i]
POSITION.x[eid] += VELOCITY.vx[eid] * VELOCITY.speed[eid]
POSITION.y[eid] += VELOCITY.vy[eid] * VELOCITY.speed[eid]
}
}
})
// Create an entity
const eid = world.addEntity()
// Add components to entity
world.addComponent('POSITION', eid, { x: 100, y: 100 })
world.addComponent('VELOCITY', eid, { vx: 1, vy: -1, speed: 100 })
// Create an event loop and step world
setInterval(() => {
world.step()
}, 1000 / 30) // 30 tick on server
// For browser, use frame rate
const loop = () => {
world.step()
requestAnimationFrame(loop)
}
loop()
Full documentation and feature rich examples can be found here.