Sovereignty/jecs
1
0
Fork 0
mirror of https://github.com/Ukendio/jecs.git synced 2025-04-24 17:10:03 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

Update README.md example and remove trailing whitespace (#14)

Browse source
This commit is contained in:
Shane 2024-05-02 06:33:31 -07:00 committed by GitHub
parent 0a70e7887b
commit e5e1aec6b2
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 13 additions and 14 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

27
README.md
View file

@ -3,25 +3,24 @@
Just an ECS
jecs is a stupidly fast Entity Component System (ECS).
jecs is a stupidly fast Entity Component System (ECS).
- Process tens of thousands of entities with ease every frame
- Zero-dependency Luau package
- Optimized for column-major operations
- Cache friendly archetype/SoA storage
- Cache friendly archetype/SoA storage
### Example
```lua
local world = Jecs.World.new()
local player = world:entity()
local opponent = world:entity()
local Health = world:component()
local Damage = world:component()
local Position = world:component()
-- Notice how components are just entities
local Health = world:entity()
local Damage = world:entity()
local Position = world:entity()
local player = world:entity()
local opponent = world:entity()
world:set(player, Health, 100)
world:set(player, Damage, 8)
@ -31,25 +30,25 @@ world:set(opponent, Health, 100)
world:set(opponent, Damage, 21)
world:set(opponent, Position, Vector3.new(0, 5, 3))
for playerId, playerPosition, health in world:query(Position, Health) do
for playerId, playerPosition, health in world:query(Position, Health) do
local totalDamage = 0
for _, opponentPosition, damage in world:query(Position, Damage) do
if (playerPosition - opponentPosition).Magnitude < 5 then
for _, opponentPosition, damage in world:query(Position, Damage) do
if (playerPosition - opponentPosition).Magnitude < 5 then
totalDamage += damage
end
end
world:set(playerId, Health, health - totalDamage)
world:set(playerId, Health, health - totalDamage)
end
assert(world:get(playerId, Health) == 79)
assert(world:get(opponentId, Health) == 92)
```
125 archetypes, 4 random components queried.
![Queries](image-3.png)
Can be found under /benches/query.lua
Inserting 8 components to an entity and updating them over 50 times.
![Insertions](image-4.png)
Can be found under /benches/insertions.lua
Can be found under /benches/insertions.lua