worldtree

A small, lightweight ECS framework for Nim.

Pure Nim score 15/100 · tests present · no docs generated

Summary

Latest Version Unknown
License MIT
CI Status Failing
Downloads 0
Last Indexed 2026-07-21 05:23

Tags

entity-component-system ecs dod

Installation

nimble install worldtree
choosenim install worldtree
git clone https://github.com/keithaustin/worldtree

OS Compatibility

Platform Linux macOS Windows FreeBSD OpenBSD NetBSD Android iOS WASM Embedded
worldtree ✓ ✓ ✓ - - - - - - -

Source

Repository https://github.com/keithaustin/worldtree
Homepage https://github.com/keithaustin/worldtree
Registry Source nimble_official

README

WorldTree - An ECS framework for Nim

A small, lightweight ECS framework written in Nim.

This project is in early development, so expect bugs and breaking changes! Please test, break things, give suggestions or ask questions!

What is an ECS?

ECS ("Entity Component System") refers to a "Data-Oriented" design approach that promotes code reusability by separating data from behaviour while also promoting data locality to improve performance by being cache-friendly. More info : https://github.com/SanderMertens/ecs-faq

Usage

First, make sure you're on the latest stable release of Nim(2.0.0 or later). Then, install with either

nimble install worldtree

or

nimble install https://github.com/keithaustin/worldtree

A basic example

import worldtree

# Declare components and systems
type
  Position = ref object of Component
    x: int
    y: int

  Velocity = ref object of Component
    x: int
    y: int

  Movement = ref object of System

proc onTick(self: Movement, tree: var WorldTree) =
  for entity in self.entities:
    let xVelocity = tree.getComponent[:Velocity](entity).x
    let yVelocity = tree.getComponent[:Velocity](entity).y

    tree.getComponent[:Position](entity).x += xVelocity
    tree.getComponent[:Position](entity).y += yVelocity

# Instanstiate a WorldTree
var tree = WorldTree()

# Register Component types
tree.registerComponentType[:Position]()
tree.registerComponentType[:Velocity]()

# Register Systems
let moveSystem = tree.registerSystem[:Movement]()

# Set system signatures
var signature: set[ComponentType]
signature.incl(tree.getComponentType[:Position]())
signature.incl(tree.getComponentType[:Velocity]())
tree.setSystemSignature[:Movement](signature)

# Create an entity
var mover = tree.newEntity()

# Give it some components
tree.addComponent[:Position](mover, Position(x: 32, y: 64))
tree.addComponent[:Velocity](mover, Velocity(x: 3, y: 1))

# Run the main loop
while true:
  moveSystem.onTick(tree)