CNPC-Geckolib-Addon
by Goodbird
CNPC-Geckolib-Addon lets CustomNPCs-Unofficial characters use Geckolib animated models, so an NPC can be built on a Geckolib model instead of the default body.
What it does
The addon connects CustomNPCs-Unofficial with Geckolib. A player who creates an NPC can pick a model type that draws the character from a Geckolib model, with its own animation set. Idle, walk, hurt and attack animations can each be chosen per NPC from the animations the model contains.
Animations can also be driven by scripts. A script can start or stop an animation, and it can read Geckolib keyframe instructions to trigger custom behavior at set points in an animation. Geckolib models can be used by scripted items and blocks as well, so the same animated assets appear outside NPCs too.
Installation needs CustomNPCs-Unofficial and Geckolib on Forge or NeoForge. The addon runs on client and server, so both the server and every player need it. Files are published for 1.20.1, with older release versions 1.12.2, 1.16.5 and 1.18.2 listed in the catalog, and the code is released under the MIT License, so it is open source.
Key features
Geckolib NPC models
A new NPC model type draws characters from Geckolib models instead of the default body.
Animation selection
Idle, walk, hurt and attack animations can each be selected for an NPC from the model's animations.
Script-controlled animations
Scripts can start and control Geckolib animations on an NPC while the game runs.
Items and blocks
Scripted items and blocks can use Geckolib models as well as NPCs.
Keyframe instructions
Custom instruction keyframes in an animation can be read by scripts to trigger behavior at set moments.
Gallery
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Requirements
Dependencies declared by the latest file for each loader.
Required 2
Use cases
Who it’s for: Server owners and map makers who already use the NPC mod with Geckolib and want animated models for their characters, items or blocks.
How it compares
Easy NPC: Config UI is a Fabric, Forge, NeoForge and Quilt mod for 1.18.2 – 26.3, open source under the MIT License, and it runs on client and server. CNPC-Additions is a Forge-only addon for 1.20.1 – 1.20.6 under All rights reserved, and it is not open source. StargazerLib is a Forge library for 1.18.2 under All rights reserved and it is not open source.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| CNPC-Geckolib-Addon | Forge and NeoForge | 1.12.2 – 1.20.1 | Client and server | 2026-03-02 |
| Easy NPC: Config UI | Fabric, Forge, NeoForge and Quilt | 1.18.2 – 26.3 | Client and server | 2026-10-13 |
| CNPC-Additions | Forge | 1.20.1 – 1.20.6 | Client and server | 2024-10-25 |
| StargazerLib | Forge | 1.18.2 | Client and server | 2026-07-26 |
Questions
Does CNPC-Geckolib-Addon need Geckolib installed?
Which loader should a server use with this addon?
Do players need the addon on their own computers?
In the catalog
CNPC-Geckolib-Addon is one of 3,514 Library mods on ModsFinder, and one of 1,576 Library mods for Forge. 34,764 mods support Minecraft 1.20.1.
More from Goodbird
Similar mods
Official listing
- Modrinth page
- modrinth.com/mod/cnpc-geckolib-addon
- Owner
- Goodbird
- Published
- 2024-01-30
- Updated on Modrinth
- 2026-03-02
- Facts verified
- 2026-10-15