Skip to content

kutuluk/js13k-ecs

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
src
 
 
 
 
 
 
 
 
 
 
 
 

js13k-ecs

A 1kb entity component system, designed for js13k.

NPM versionBuild Status

  • Tiny: weighs about one kilobyte gzipped

Install

This project uses node and npm. Go check them out if you don't have them locally installed.

$ npm install js13k-ecs

Then with a module bundler like rollup or webpack, use as you would anything else:

// using ES6 modules
import ecs from 'js13k-ecs';

// using CommonJS modules
var ecs = require('js13k-ecs');

The UMD build is also available on unpkg:

<script src="https://unpkg.com/js13k-ecs/dist/ecs.umd.js"></script>

You can find the library on window.ecs.

Usage

See example folder. Live example

API

ecs

register(...Components)

Registers components for use by the library. Components must be classes or constructor functions. No other requirements are imposed on the components. Note that there is currently a limit of 32 registered components.

process(...systems)

Adds systems for use by the library. Systems must be instances of classes or objects. Systems must implement the update method.

create(id)

Creates the entity with the specified id. If id is not specified, serial numbers starting with 1 are generated and encoded in base36. Returns the created entity.

get(id)

Returns the entity with the specified id or undefined if it is not present.

select(...Components)

Returns a selection of entities that have the specified set of components. The sample is updated real-time and always relevant.

The selector has the length property, which stores the number of entities in the sample and the iterate(fn) method, with which you can loop through all entities.

update(delta)

Successively calls update methods on all systems, passing them the delta parameter. Returns the object that contains the duration of the execution of the systems.

Entity

add(...components)

Adds the components to the entity.

remove(...Components)

Removes components of the Components class from the entity. Calls the destructor method of each component if it is present.

has(Component)

Returns true if the entity has a component of the Component class and false otherwise.

get(Component)

Returns a component of the Component class or undefined if it is not present.

eject()

Removes the entity from all selectors and sets its id to zero. Calls the destructor method of each component if it is present.

About

A 1kb entity component system, designed for Js13kGames

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published