CustomNPCs-Unofficial

CustomNPCs-Unofficial

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

by
1.5M Downloads
fabricforgeneoforgemanagementsocialutility
Rent Server with this Mod

Screenshots

New models
Permission

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

CustomNPCs-Unofficial 1.20.1.20260227release
MC 1.20.1forge
March 1, 2026
CustomNPCs-Unofficial 1.21.1.20260124release
MC 1.21.1fabric
January 28, 2026
CustomNPCs-Unofficial-Fabric-1.20.1.20251214release
MC 1.20.1fabric
December 14, 2025
CustomNPCs-Unofficial-Fabric-1.21.1.20251129release
MC 1.21.1fabric
December 3, 2025
CustomNPCs-Unofficial-Fabric-1.21.1.20251103release
MC 1.21.1fabric
November 3, 2025

How to Install CustomNPCs-Unofficial on Your Server

1

Order Server

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

2

Set fabric Loader

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

3

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

fabricforgeneoforge

Minecraft Versions

1.21.1, 1.21, 1.20.4 (+3 more)

Server-side

Required

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

Rent Modded Server

Install CustomNPCs-Unofficial with just one click on your server.

Recommended RAM
4 GBfrom €5.2/mo
Minimum 3 GB | per 8 players
Create Server Now
1-Click Mod Install
NVMe SSD Storage
DDoS Protection included

Details

License
LicenseRef-CC-BY-NC-3.0
Server-side
Required

Supported Versions

1.21.11.211.20.41.20.21.20.11.19.2