Model Files

Where to put your files

Models live in the server's (or singleplayer world's) config folder:

config/animationmodels/

Each model gets its own subfolder. The folder name becomes the model's ID.

File structure

File	Description
model.json	GeckoLib geometry file
animation.json	GeckoLib animation file
texture.png	Main texture
armor.png, burnt.png, ...	Additional textures (switchable in-game)
glowmask.png	Emissive/glow layer texture
roar.ogg, *.ogg	Sound files
standard.json	Saved default settings for this model

Folders

Models can be organized into subfolders. The folder structure is reflected in the model picker in-game.

config/animationmodels/
├── dragon/
│   ├── model.json
│   ├── animation.json
│   ├── texture.png
│   ├── burnt.png
│   ├── glowmask.png
│   ├── roar.ogg
│   └── standard.json
└── npcs/
    ├── blacksmith/
    │   ├── model.json
    │   ├── animation.json
    │   ├── texture.png
    │   ├── armor.png
    │   └── hammer.ogg
    └── guard/
        ├── model.json
        ├── animation.json
        └── texture.png

In the edit screen, you can navigate into folders just like a file browser.

Multiple textures

Any .png files in a model folder beyond texture.png are treated as additional textures. You can switch between them in the Model tab of the edit screen.

Glow mask

If a file named glowmask.png is present, it is rendered as an emissive layer on top of the model, useful for glowing eyes, lights, etc.

Reloading

The mod scans the folder automatically when you open the wand edit screen. No restart required after adding new files.