Skip to content

Config Intro

We define custom mobs, items, or blocks in config files, which get loaded as prefabs. Prefabs hold a list of components that will be added to an entity when it gets created.

When we spawn an entity, it is an instance of a prefab. It may use data directly on the prefab, or copy it onto itself (ex. for persistent data that may change per entity.)

Directory structure

Place Geary config files in plugins/Geary/<namespace>, where <namespace> is unique to your project (ex. mineinabyss). Files will be loaded by name, regardless of folder structure. Feel free to organize things yourself. Multiple file formats are supported, but this guide will exclusively use .yml files for configs.


/geary prefab reload <namespace>:<name> will re-read a prefab from disk. It will be updated live, but instances will not be updated until a chunk reload or restart.

/geary prefab load <namespace> path/to/file.yml will load a file that was not previously loaded by geary.