Back to mods
CNPCExtended project artwork

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

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which CNPCExtended release should I use?

Updated 29 days ago
Latest stable file CNPCExtended-3.0.1-fabric-1.21.1.jar
Game version 1.21.1
Loader Fabric

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.

Client Source doesn’t say
Dedicated server Source doesn’t say
Loader for this release Fabric
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

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.

All 1 required mods have matching files

Install CustomNPCs-Unofficial first. We found matching files for this game-version and loader setup.

CustomNPCs-Unofficial Needed by CNPCExtended-3.0.1-fabric-1.21.1.jar
required
Matching file found Matched file: CustomNPCs-Unofficial-Fabric-1.21.1.20260521.jar

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.

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

  2. 02

    Bring the mods it needs

    Install CustomNPCs-Unofficial first. We found matching files for this game-version and loader setup.

  3. 03

    Put it on the correct side

    The project page does not say whether this file belongs on the client, dedicated server, or both.

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

2 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

CNPCExtended versions and loaders

20 of 20 releases match

Looking for an older file? The official CurseForge project page is in Resources.