Lightweight 💾

3.80kb minified

Simple API ⚡

OOP & Procedural methods

No Dependencies 🥤

0 external libraries used

TypeScript Support 🤝

Type defintions provided

Documentation 📄

Documentation for every method

Gravity

Collision

Jitter

Checkout the source

Components

You first write your data structures (in ECS terms called components)

 const PositionComponent = { name: "position", state: { x: 0, y: 0 } } ECS.addComponent(PositionComponent) const MassComponent = { name: "mass", state: { mass: 1.5, velocityX: 0, velocityY: 0 } } ECS.addComponent(MassComponent)

Processors

You then write your processors that will handle the logic

 const GravityProcessor = { name: "gravity_processor", required: ["position", "mass"], update(entity, components, processor) { const [position, mass] = components const gravity = 2 const result = mass.state.mass * gravity mass.state.velocityY += result position.state.y += mass.state.velocityY } } ECS.addProcessor(GravityProcessor)

Entities

With the added components and processors we can now compose entities

 const Player = ECS.createEntity("Player", ["position", "mass"], ["gravity_processor"]) ECS.addEntity(player)

One method to rule them all

You now call the libraries update method and watch you entities do fancy things

 const gameloop = () => { // this is your game loop // input ... ECS.update() // render ... requestAnimationFrame() } gameloop()

© 2023 Kaan "Stuhl" Aksu