mirror of
https://github.com/Ukendio/jecs.git
synced 2025-04-24 17:10:03 +00:00
65 lines
1.7 KiB
Markdown
65 lines
1.7 KiB
Markdown
|
|
<p align="center">
|
|
<img src="jecs_darkmode.svg#gh-dark-mode-only" width=50%/>
|
|
<img src="jecs_lightmode.svg#gh-light-mode-only" width=50%/>
|
|
</p>
|
|
|
|
[](LICENSE-APACHE)
|
|
[](https://wally.run/package/ukendio/jecs)
|
|
|
|
Just an ECS
|
|
|
|
jecs is a stupidly fast Entity Component System (ECS).
|
|
|
|
- Entity Relationships as first class citizens
|
|
- Process tens of thousands of entities with ease every frame
|
|
- Type-safe [Luau](https://luau-lang.org/) API
|
|
- Zero-dependency package
|
|
- Optimized for column-major operations
|
|
- Cache friendly archetype/SoA storage
|
|
- Unit tested for stability
|
|
|
|
### Example
|
|
|
|
```lua
|
|
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 name()
|
|
|
|
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
|
|
```
|
|
|
|
125 archetypes, 4 random components queried.
|
|
|
|
Can be found under /benches/query.lua
|
|
|
|
Inserting 8 components to an entity and updating them over 50 times.
|
|
|
|
Can be found under /benches/insertions.lua
|