mirror of
https://github.com/Ukendio/jecs.git
synced 2025-10-24 22:19:18 +00:00
A fast, portable Entity Component System for Luau.
https://ukendio.github.io/jecs/
data-orienteddata-oriented-designecsentity-component-systemgame-developmentgamedevjecslualuauno-dependencies
| .github | ||
| benches | ||
| demo | ||
| docs | ||
| examples | ||
| mirror | ||
| src | ||
| test | ||
| thesis | ||
| .gitignore | ||
| .luaurc | ||
| bench.project.json | ||
| CHANGELOG.md | ||
| default.project.json | ||
| demo.rbxl | ||
| image-1.png | ||
| image-2.png | ||
| image-3.png | ||
| image-4.png | ||
| jecs_darkmode.svg | ||
| jecs_lightmode.svg | ||
| LICENSE | ||
| logo_old.png | ||
| mkdocs.yml | ||
| package-lock.json | ||
| package.json | ||
| README.md | ||
| rgb.luau | ||
| rokit.toml | ||
| selene.toml | ||
| stylua.toml | ||
| test.project.json | ||
| testez-companion.toml | ||
| testez.d.luau | ||
| testkit.luau | ||
| tsconfig.json | ||
| wally.toml | ||
jecs is 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
- Unit tested for stability
Example
local world = jecs.World.new()
local pair = jecs.pair
local ChildOf = world:component()
local Name = world:component()
local function parent(entity)
return world:target(entity, ChildOf)
end
local function getName(entity)
return world:get(entity, Name)
end
local alice = world:entity()
world:set(alice, Name, "alice")
local bob = world:entity()
world:add(bob, pair(ChildOf, alice))
world:set(bob, Name, "bob")
local sara = world:entity()
world:add(sara, pair(ChildOf, alice))
world:set(sara, Name, "sara")
print(getName(parent(sara)))
for e in world:query(pair(ChildOf, alice)) do
print(getName(e), "is the child of alice")
end
-- Output
-- "alice"
-- bob is the child of alice
-- sara is the child of alice
21,000 entities 125 archetypes 4 random components queried.
Can be found under /benches/visual/query.luau
Inserting 8 components to an entity and updating them over 50 times.
Can be found under /benches/visual/insertions.luau