CNPC-Geckolib-Addon

CNPC-Geckolib-Addon

An addon for Custom NPC and Geckolib3 that allows the use of geckolib models for your NPC

by
60.1K Downloads
forgeneoforgelibrarymanagementutility
Rent Server with this Mod

Screenshots

Model Entity
Model Selection
Animation Selection
Scripted Control

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

Mod Wiki

Partners:

Available Versions

CNPC-Geckolib-Addon 1.20.1-1.0.6release
MC 1.20.1forge
March 2, 2026
CNPC-Geckolib-Addon 1.20.1-1.0.0release
MC 1.20.1forge, neoforge
July 25, 2024
CNPC-Gecko-Addon-1.18.2-0803-1.1.1release
MC 1.18.2forge
June 2, 2024
CNPC-Gecko-Addon-1.16.5-0728-1.1.1release
MC 1.16.5forge
June 2, 2024
CNPC-Gecko-Addon-1.16.5-0515-1.1.1release
MC 1.16.5forge
June 2, 2024

How to Install CNPC-Geckolib-Addon on Your Server

1

Order Server

Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).

2

Set forge Loader

In the panel under "Egg", select the forge loader and matching Minecraft version (1.20.1).

3

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

forgeneoforge

Minecraft Versions

1.20.1, 1.18.2, 1.16.5 (+1 more)

Server-side

Required

Recommended 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.

Recommended RAM
4 GBab €8/mo
Min. 3 GB | +1 GB pro 8 Spieler
Create Server Now
1-Click Mod Install
NVMe SSD Storage
DDoS Protection included

Details

License
MIT License
Server-side
Required

Supported Versions

1.20.11.18.21.16.51.12.2