npc-lib

Simple & Extendable NPC library for Minecraft Java Edition Servers

6.2K Downloads

fabricdecorationlibrary

Rent Server with this Mod

Screenshots

About this Mod

GitHub forks
GitHub Repo stars

Minecraft NPC-Lib

Simple & Extendable NPC library for Minecraft Java Edition Servers

Features

Bukkit & Forks (including Folia) supported via ProtocolLib or PacketEvents
Full Minestom & Fabric support (latest version only)
Skin (Static and Dynamic loading)
Attributes (Status, Pose, Skin Layers)
Equipment (Main & Off Hand, Armor)
Interaction (Interact & Attack)
Action Controller (Automatic Looking at Player, Player Imitation & Spawning etc.)
LabyMod Extension (Sending Emotes & Sprays)
...

Available Versions

[1.21.11] npc-lib 3.0.0-beta.16beta

MC 1.21.11fabric

December 9, 2025

[1.21.9-1.21.10] npc-lib 3.0.0-beta.15beta

MC 1.21.9, 1.21.10fabric

October 6, 2025

[1.21.9] npc-lib 3.0.0-beta.14beta

MC 1.21.9fabric

October 1, 2025

[1.21.6-1.21.8] npc-lib 3.0.0-beta13beta

MC 1.21.6, 1.21.7, 1.21.8fabric

June 19, 2025

[1.21.5] npc-lib 3.0.0-beta12beta

MC 1.21.5fabric

June 19, 2025

How to Install npc-lib on Your Server

Order Server

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

Set fabric Loader

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

Install Mod

Open the mod browser in the dashboard and search for "npc-lib". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.

Compatibility

Mod Loaders

fabric

Minecraft Versions

1.21.11, 1.21.10, 1.21.9 (+5 more)

Server-side

✓ Required

Recommended RAM

4 GB(min. 3 GB)

Frequently Asked Questions

npc-lib server crashes on startup – what to do?

Most common cause: wrong fabric 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.21.11). You can switch loaders with one click in the panel.

Is npc-lib compatible with fabric?

npc-lib officially supports fabric for Minecraft 1.21.11, 1.21.10, 1.21.9. The Mado dashboard automatically detects incompatible loader combinations.

Server lagging with npc-lib – how to optimize performance?

Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if npc-lib 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.