CurseForge · Minecraft mod
CNPCExtended
Cnpc and Mcef integration that lets you display HTML browsers to players, this mod also adds client side queries like getting the players sound,graphics,video settings,. this mod also adds global scripts and npc datas that preloads into new worlds
Quick answer
Which CNPCExtended release should I use?
CNPCExtended-3.0.1-fabric-1.21.1.jar targets 1.21.1 with Fabric. The project page does not say whether this file belongs on the client, dedicated server, or both. All 1 required mods have matching files.
Where it goes
Is CNPCExtended required on the client, server, or both?
The project page does not say whether this file belongs on the client, dedicated server, or both.
The source does not explicitly classify this release as client-only or server-only.
What else does CNPCExtended-3.0.1-fabric-1.21.1.jar need?
CNPCExtended-3.0.1-fabric-1.21.1.jar. Change the file and its required mods may change too.
Install CustomNPCs-Unofficial first. We found matching files for this game-version and loader setup.
We only count dependency files that match this setup. A file for another loader does not fill the gap.
Before you install it
Add CNPCExtended without breaking your instance.
Built for CNPCExtended-3.0.1-fabric-1.21.1.jar. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use CNPCExtended-3.0.1-fabric-1.21.1.jar. It targets 1.21.1 with Fabric; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
Install CustomNPCs-Unofficial first. We found matching files for this game-version and loader setup.
- 03
Put it on the correct side
The project page does not say whether this file belongs on the client, dedicated server, or both.
- 04
Pick the file you checked
Use the “Get this file” button beside CNPCExtended-3.0.1-fabric-1.21.1.jar. It opens that exact file at the source.
About this project
What does CNPCExtended add?
CNPCExtended — Supercharge Your CustomNPCs
The missing toolkit for CustomNPCs. HTML browser GUIs, client-side queries, global script management, NPC data preloading, and a full server-to-client bridge -- all in one mod.
Minecraft 1.20.1 - Forge 47+ - Requires CustomNPCs Unofficial + MCEF
What Is This?
CNPCExtended adds everything CustomNPCs doesn't have out of the box. Query player settings from the server, open full HTML interfaces powered by an embedded Chromium browser, auto-deploy scripts and NPC data across all your worlds, and bridge your CNPC scripts with the client side -- no separate client mod needed.
This isn't just a GUI mod. It's a complete extension framework for CNPC.
See It In Action
Features
HTML GUI System
- Open HTML GUIs from any CNPC script -- NPC, Player, Block, or Item scripts
- Bidirectional events -- HTML sends events to the server, server pushes data back in real-time
- Real Minecraft item overlays -- render actual ItemStacks with enchant glint, durability bars, and hover tooltips on top of your HTML
- Full CSS/JS support -- animations, flexbox, grid, Canvas, SVG -- it's a real browser
- Target any player -- open GUIs on other players, not just the one who triggered the script
Client Bridge Queries
Read player client settings from the server -- no client mods needed beyond MCEF:
- Video settings -- FOV, render distance, graphics mode, GUI scale, framerate limit
- Sound settings -- master volume, music, weather, ambient, hostile, player volumes
- Keybinds -- all vanilla key mappings
- Resource packs -- list of active packs
- Screen info -- resolution, scaled width/height
Global Scripts and NPC Data (NEW in v1.1)
Pre-configure every new world automatically:
- Global player scripts -- place .js and .html files in a config folder, they auto-copy into every new world and register as CNPC player scripts
- Global NPC data -- pre-load clones, dialogs, quests, and linked NPCs from a template into every new world
- /cnpcext commands -- sync, force-sync, and check preload status in-game
- Forge config -- all features toggleable via cnpcextended-common.toml
Quick Example
NPC Script (server-side):
function interact(e) {
var cnpcext = e.API.getIWorld(0).getTempdata().get("cnpcext")
cnpcext.openHtmlGui(e, "shop.html", 0, 0, {
shopName: "Adventurer's Shop",
items: [{name: "Sword", price: 100}, {name: "Shield", price: 50}]
})
}
function htmlGuiEvent(e) {
if (e.eventName === "buy") {
e.player.giveItem(e.data.get("itemId"), 1)
e.bridge.sendToBrowser(e.player.getMCEntity(), "purchased", {success: true})
}
}
Documentation
Full Documentation and API Reference
Covers installation, quick start guide, complete API reference, item overlays, client queries, event flow diagrams, and copy-paste examples.
Requirements
| Mod | Side | Purpose |
|---|---|---|
| CustomNPCs Unofficial | Server | Script engine + NPC system |
| MCEF | Client | Embedded Chromium browser |
| CNPCExtended | Both | This mod -- bridges scripts with HTML |
Security
- HTML files loaded from server's world folder only -- no external URLs
- Path traversal blocked -- scripts can't escape the scripts folder
- Event names validated with strict regex
- Client queries are read-only -- server cannot change client settings
Built for modpack creators, RPG server owners, and anyone who wants their NPCs to do more.
Project description from CurseForge.
Pick your setup
CNPCExtended by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
1.21.1
1 loader build1.20.1
1 loader buildCheck the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
CNPCExtended versions and loaders
CNPCExtended-3.0.1-fabric-1.21.1.jar
16 Oct 2026
CNPCExtended-3.0.1-forge-1.20.1.jar
16 Oct 2026
CNPCExtendedPerBoost-2026-05-17-forge-1.20.1-v3.jar
17 May 2026
CNPCExtendedPerfBoost-2026-05-17-fabric-1.21.1-v3.jar
CNPCExtendedPerBoost-2026-05-17-fabric-1.21.1-v3.jar
17 May 2026
cnpcextended-2026-04-19-PerfBoost-1.1.jar
21 Apr 2026
cnpcextended-fabric-2026-04-19-perfboost-1.1.jar
21 Apr 2026
cnpcextended-2026-03-30-PerfBoost.jar
1 Apr 2026
cnpcextended-fabric-2026-03-30-PerfBoost.jar
1 Apr 2026
cnpcextended-2026-03-25-1.5.28.jar
24 Mar 2026
cnpcextended-fabric-2026-03-25-1.5.28.jar
24 Mar 2026
cnpcextended-2026-03-19-1.5.13.jar
19 Mar 2026
cnpcextended-fabric-2026-03-19-1.5.13.jar
19 Mar 2026
Looking for an older file? The official CurseForge project page is in Resources.