e2c56f5420
* Implement world:targets * Proper indexing in ECS_PAIR_SECOND * Unit tests * pull idr.records index out of iterator * move tests below world:target * style * better test names * change nth to use idr.records and pull out variables from iter * local NOOP fn * pull NOOP out of fn * redeclare component_index as ct_idx * black magic (inlined most of the function calls in iterator - yes it still passes tests) * remove redundant fn call (shoutout to nnullcolumn for spotting this) * add test for rapid add/remove calls * run secondary mixing step for all entities and not just the alive ones * redundant check * be a bit more explicit for checking if an entity is alive |
||
|---|---|---|
| .github | ||
| examples | ||
| how_to | ||
| modules | ||
| scripts | ||
| src | ||
| test | ||
| .gitignore | ||
| .luaurc | ||
| CHANGELOG.md | ||
| default.project.json | ||
| LICENSE | ||
| package.json | ||
| README.md | ||
| rokit.toml | ||
| studio_docs.project.json | ||
| test.rbxl | ||
| tsconfig.json | ||
| wally.toml | ||
Just a stupidly fast Entity Component System
- Entity Relationships as first class citizens
- Iterate 800,000 entities at 60 frames per second
- Type-safe Luau API
- Zero-dependency package
- Optimized for column-major operations
- Cache friendly archetype/SoA storage
- Rigorously unit tested for stability
Get Started
It is recommended that you clone the repository and navigate the documentation in your favourite editor.
This repository includes a few subfolders that can help you get started with jecs:
-
how_to: This is a step-by-step introduction to how this ECS works and the reasoning behind its design.
-
modules: These are regularly used modules and should be mostly working, but some might not be. You can look in this folder to see some code that you might use to help you hit the ground running quickly.
-
examples: These are larger programs that showcase real use cases and can help you understand how everything fits together.
If you wish to view the documentation inside Roblox Studio, you can find an importable model file here.
Benchmarks
21,000 entities 125 archetypes 4 random components queried.
Can be found under /test/benches/visual/query.luau
Inserting 8 components to an entity and updating them over 50 times.
Can be found under /test/benches/visual/insertions.luau