Compare commits
2 commits
f143efc956
...
20467b301b
Author | SHA1 | Date | |
---|---|---|---|
20467b301b | |||
|
372845d96e |
4 changed files with 453 additions and 451 deletions
4
.luaurc
4
.luaurc
|
@ -2,7 +2,7 @@
|
||||||
"aliases": {
|
"aliases": {
|
||||||
"jecs": "src",
|
"jecs": "src",
|
||||||
"testkit": "testkit",
|
"testkit": "testkit",
|
||||||
"mirror": "mirror",
|
"mirror": "mirror"
|
||||||
},
|
},
|
||||||
"languageMode": "strict"
|
"languageMode": "strict"
|
||||||
}
|
}
|
132
README.md
132
README.md
|
@ -1,68 +1,68 @@
|
||||||
An unofficial pesde package for [jecs](https://github.com/ukendio/jecs).
|
An automatically synced minimal copy of the [jecs](https://github.com/Ukendio/jecs) repo published to pesde.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
<p align="center">
|
<p align="center">
|
||||||
<img src="jecs_darkmode.svg#gh-dark-mode-only" width=50%/>
|
<img src="image-5.png" width=35%/>
|
||||||
<img src="jecs_lightmode.svg#gh-light-mode-only" width=50%/>
|
</p>
|
||||||
</p>
|
|
||||||
|
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge)](LICENSE) [![Wally](https://img.shields.io/github/v/tag/ukendio/jecs?&style=for-the-badge)](https://wally.run/package/ukendio/jecs)
|
||||||
[![License: Apache 2.0](https://img.shields.io/badge/License-Apache-blue.svg?style=for-the-badge)](LICENSE-APACHE)
|
|
||||||
[![Wally](https://img.shields.io/github/v/tag/ukendio/jecs?&style=for-the-badge)](https://wally.run/package/ukendio/jecs)
|
Just a stupidly fast Entity Component System
|
||||||
|
|
||||||
jecs is Just a stupidly fast Entity Component System
|
* [Entity Relationships](https://ajmmertens.medium.com/building-games-in-ecs-with-entity-relationships-657275ba2c6c) as first class citizens
|
||||||
|
* Iterate 800,000 entities at 60 frames per second
|
||||||
- Entity Relationships as first class citizens
|
* Type-safe [Luau](https://luau-lang.org/) API
|
||||||
- Iterate 800,000 entities at 60 frames per second
|
* Zero-dependency package
|
||||||
- Type-safe [Luau](https://luau-lang.org/) API
|
* Optimized for column-major operations
|
||||||
- Zero-dependency package
|
* Cache friendly [archetype/SoA](https://ajmmertens.medium.com/building-an-ecs-2-archetypes-and-vectorization-fe21690805f9) storage
|
||||||
- Optimized for column-major operations
|
* Rigorously [unit tested](https://github.com/Ukendio/jecs/actions/workflows/ci.yaml) for stability
|
||||||
- Cache friendly archetype/SoA storage
|
|
||||||
- Unit tested for stability
|
### Example
|
||||||
|
|
||||||
### Example
|
```lua
|
||||||
|
local world = jecs.World.new()
|
||||||
```lua
|
local pair = jecs.pair
|
||||||
local world = jecs.World.new()
|
|
||||||
local pair = jecs.pair
|
-- These components and functions are actually already builtin
|
||||||
|
-- but have been illustrated for demonstration purposes
|
||||||
local ChildOf = world:component()
|
local ChildOf = world:component()
|
||||||
local Name = world:component()
|
local Name = world:component()
|
||||||
|
|
||||||
local function parent(entity)
|
local function parent(entity)
|
||||||
return world:target(entity, ChildOf)
|
return world:target(entity, ChildOf)
|
||||||
end
|
end
|
||||||
local function getName(entity)
|
local function getName(entity)
|
||||||
return world:get(entity, Name)
|
return world:get(entity, Name)
|
||||||
end
|
end
|
||||||
|
|
||||||
local alice = world:entity()
|
local alice = world:entity()
|
||||||
world:set(alice, Name, "alice")
|
world:set(alice, Name, "alice")
|
||||||
|
|
||||||
local bob = world:entity()
|
local bob = world:entity()
|
||||||
world:add(bob, pair(ChildOf, alice))
|
world:add(bob, pair(ChildOf, alice))
|
||||||
world:set(bob, Name, "bob")
|
world:set(bob, Name, "bob")
|
||||||
|
|
||||||
local sara = world:entity()
|
local sara = world:entity()
|
||||||
world:add(sara, pair(ChildOf, alice))
|
world:add(sara, pair(ChildOf, alice))
|
||||||
world:set(sara, Name, "sara")
|
world:set(sara, Name, "sara")
|
||||||
|
|
||||||
print(getName(parent(sara)))
|
print(getName(parent(sara)))
|
||||||
|
|
||||||
for e in world:query(pair(ChildOf, alice)) do
|
for e in world:query(pair(ChildOf, alice)) do
|
||||||
print(getName(e), "is the child of alice")
|
print(getName(e), "is the child of alice")
|
||||||
end
|
end
|
||||||
|
|
||||||
-- Output
|
-- Output
|
||||||
-- "alice"
|
-- "alice"
|
||||||
-- bob is the child of alice
|
-- bob is the child of alice
|
||||||
-- sara is the child of alice
|
-- sara is the child of alice
|
||||||
```
|
```
|
||||||
|
|
||||||
21,000 entities 125 archetypes 4 random components queried.
|
21,000 entities 125 archetypes 4 random components queried.
|
||||||
![Queries](image-3.png)
|
![Queries](image-3.png)
|
||||||
Can be found under /benches/visual/query.luau
|
Can be found under /benches/visual/query.luau
|
||||||
|
|
||||||
Inserting 8 components to an entity and updating them over 50 times.
|
Inserting 8 components to an entity and updating them over 50 times.
|
||||||
![Insertions](image-4.png)
|
![Insertions](image-4.png)
|
||||||
Can be found under /benches/visual/insertions.luau
|
Can be found under /benches/visual/insertions.luau
|
||||||
|
|
|
@ -10,7 +10,7 @@ includes = [
|
||||||
license = "MIT"
|
license = "MIT"
|
||||||
name = "mark_marks/jecs_pesde"
|
name = "mark_marks/jecs_pesde"
|
||||||
repository = "https://git.devmarked.win/marked/jecs-pesde"
|
repository = "https://git.devmarked.win/marked/jecs-pesde"
|
||||||
version = "0.3.2"
|
version = "0.4.0-rc.0"
|
||||||
|
|
||||||
[indices]
|
[indices]
|
||||||
default = "https://github.com/daimond113/pesde-index"
|
default = "https://github.com/daimond113/pesde-index"
|
||||||
|
|
Loading…
Reference in a new issue