Geary is an Entity Component System (ECS) written in Kotlin. The engine design is inspired by flecs. Core parts of the engine like system iteration and entity creation are quite optimized, the main exception being our observer system. We use Geary internally for our Minecraft plugins, see geary-papermc for more info.
- Archetype based engine optimized for many entities with similar components
- Type safe systems, queries, and event listeners
- Null safe component access
- Flecs-style entity relationships
alice.addRelation<FriendsWith>(bob) - Observers for listening to component changes and custom events
- Prefabs that reuse components across entities
- Persistent components and loading prefabs from files thanks to kotlinx.serialization
- Addon system to use only what you need
Read our Quickstart guide to see Geary in action, here's an excerpt, a simple velocity system:
data class Position(var x: Double, var y: Double)
data class Velocity(var x: Double, var y: Double)
fun GearyModule.updatePositionSystem() = system(query<Position, Velocity>())
.every(interval = 20.milliseconds)
.exec { (position, velocity) ->
// We can access our components like regular variables!
position.x += velocity.x
position.y += velocity.y
}
fun main() {
// Set up geary
geary(ArchetypeEngineModule) {
// example engine configuration
install(Prefabs)
}
val posSystem = geary.updatePositionSystem()
// Create an entity the system can run on
entity {
setAll(Position(0.0, 0.0), Velocity(1.0, 0.0))
}
posSystem.tick() // exec just this system
geary.engine.tick() // exec all registered repeating systems, interval used to calculate every n ticks to run
val positions: List<Position> = posSystem.map { (pos) -> pos }
}
repositories {
maven("https://repo.mineinabyss.com/releases")
}
dependencies {
val gearyVersion = "x.y.z"
implementation("com.mineinabyss:geary-core:$gearyVersion")
implementation("com.mineinabyss:geary-<addon-name>:$gearyVersion")
}As the project matures, our primary goal is to make it useful to more people. Here are a handful of features we hope to achieve:
- Multiplatform support, with js, jvm, and native targets
- Publish numbers for benchmarks and cover more parts of the engine with them
- Relation queries, ex. entities with a parent that has X component.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent