
CNPC-Geckolib-Addon
An addon for Custom NPC and Geckolib3 that allows the use of geckolib models for your NPC
Screenshots




About this Mod
CNPC-Geckolib-Addon
An addon for Geckolib3 and Custom NPC that allows the use of geckolib models for your NPC
Installation
Requirements
CNPC-Gecko-Addon is an addon for CustomNPCs and Geckolib3. So in order to use it you need to have these two mod installed.
Addon also uses Mixins. It means that on 1.16.5 you need to install a special mod called MixinBootstrap.
You can also use any other mixin loading mod you know.
On 1.18.2 the mixin system is integrated into the minecraft itself, so you don't need to install mixin loader.
Selecting the version
The addon is version-dependent, so to choose the correct version of CNPC-Gecko-Addon, you need to look at the last four digits of your CNPC version.
For example, if you have CustomNPCs-1.16.5.20220728snapshot.jar, you should use CNPC-Gecko-Addon-1.16.5-0728-x.x.x.jar.
Usage
Features:
- New model type for NPCs - Geckolib Model
- The ability to select idle and walk animations for the NPC
- The ability to control the animations using scripts
Coming soon:
- The ability to select hurt and attack animations
- The ability to use geckolib models for scripted items and blocks
- The ability to handle custom instruction animation keyframes
- Even more useful features...
More Info
Partners:
Available Versions
How to Install CNPC-Geckolib-Addon on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set forge Loader
In the panel under "Egg", select the forge loader and matching Minecraft version (1.20.1).
Install Mod
Open the mod browser in the dashboard and search for "CNPC-Geckolib-Addon". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.20.1, 1.18.2, 1.16.5 (+1 more)
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
CNPC-Geckolib-Addon server crashes on startup – what to do?
Most common cause: wrong forge version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.20.1). You can switch loaders with one click in the panel.
Is CNPC-Geckolib-Addon compatible with forge and neoforge?
CNPC-Geckolib-Addon officially supports forge, neoforge for Minecraft 1.20.1, 1.18.2, 1.16.5. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with CNPC-Geckolib-Addon – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if CNPC-Geckolib-Addon consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Rent Modded Server
Install CNPC-Geckolib-Addon with just one click on your server.