
CustomNPCs-Unofficial
Unofficial version of CustomNPCs mod ported to the newer versions of Minecraft
Screenshots


About this Mod
This is an unofficial port of Noppes's CustomNPCs mod to the newer versions of Minecraft like 1.19.2 and 1.20.1.
This version might contain some bugs, which you can report to me in the discord (.goodbird) and I'll try to fix them.
These versions are being published by the permission of the original CustomNPCs creator (see images).
Custom NPCs is a mod used to liven up words or to create your own adventure.
It features tools to create NPCs and change their health/strenght/weapons/skin and AI.
Some useful information on CustomNPCs mod in general can be found on this website.
Scripting API didn't change since 1.18.2, so you can find it here
CustomNPCs-Unofficial Partners:
Available Versions
How to Install CustomNPCs-Unofficial 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.1).
Install Mod
Open the mod browser in the dashboard and search for "CustomNPCs-Unofficial". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.21.1, 1.21, 1.20.4 (+3 more)
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
CustomNPCs-Unofficial 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.1). You can switch loaders with one click in the panel.
Is CustomNPCs-Unofficial compatible with fabric and forge and neoforge?
CustomNPCs-Unofficial officially supports fabric, forge, neoforge for Minecraft 1.21.1, 1.21, 1.20.4. Note: Forge and Fabric mods are NOT cross-compatible – pick one loader and stick with it. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with CustomNPCs-Unofficial – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if CustomNPCs-Unofficial 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.
Similar Mods
Rent Modded Server
Install CustomNPCs-Unofficial with just one click on your server.