Quick Start

This short walkthrough shows how to create a world, add an entity and query the voxel grid from Python. It assumes that the installation steps have been completed and that aetherion is importable.

import aetherion

# Create a world with 100x100x10 voxels
world = aetherion.World(100, 100, 10)
world.initialize_voxel_grid()

# Create a basic entity using the helper interface
entity = aetherion.EntityInterface(
    aetherion.Position(1, 2, 0),
    aetherion.Velocity(0.0, 0.0, 0.0),
)
entity_id = world.create_entity(entity)

# Store entity id in the voxel grid
data = aetherion.GridData(terrainID=0, entityID=int(entity_id), eventID=0, lightingLevel=0.0)
world.set_voxel(1, 2, 0, data)

# Retrieve the voxel contents
result = world.get_voxel(1, 2, 0)
print(result.entityID)

The C++ World object can be passed to other modules (such as a renderer) using World.get_ptr which returns a capsule pointer.