Custom NPCs — BRP (BY RAYMAN PATCH)

A patched build of Custom NPCs for Minecraft 1.16.5 (Forge). The same mod you know, with the bugs fixed, a rebuilt editor, a dark theme, a much stronger quest system and a complete Ukrainian translation.

Built and maintained for the gummercraft.fun server.

About the mod

Custom NPCs lets you create your own characters and build a whole world out of them: branching dialogs, quests, factions with standings, shops, banks, companions, transporters, mailmen. Every NPC is configurable down to the details — model, animations, combat tactics, scripts.

The original mod was created by Noppes — kodevelopment.nl. All credit for the mod itself belongs to him. This build is only a patch on top of 1.16.5.

What this build fixes and adds

Data stops disappearing

• Carpentry recipes persist. In the original 1.16.5 build the whole subsystem was dead: the recipe file was never read on startup, saving did nothing, deleting removed nothing, and the manager always received an empty list. Fully restored.
• A corrupted save no longer blocks writing — file streams used to stay open on truncated files.
• The bank no longer charges for nothing — the slot fee was taken before the limit check.
• Finishing a quest from a script no longer crashes the server.
• Three infinite recursions (server-start crashes) found and fixed.

Server safety

• Editor permissions are OP-only. 29 of the 30 permission nodes used to register as available to every player.
• Reading the NBT of any block in the world by any player is closed off.
• Purchases are validated by the server: index, price, stock, reputation — the price used to be whatever the client's slot happened to hold.
• Per-element network packets. A big shop or a long quest line is no longer packed into a single packet — that used to threaten a disconnect at the ~1 MB packet limit.

Quests

• On-screen tracker: active quests with objectives in a corner, completed ones green. Kill progress flashes "Zombie 3/5" on the actionbar. Everything can be turned off: globally in the config and per quest in the editor.
• Mixed quest type — items + dialogs + kills + locations + manual counters in one quest.
• Branching chains — a list of next-quest candidates with conditions; the first one the player qualifies for starts. The old single "next quest" remains the unconditional fallback.
• Quest scheme — the whole chain as a graph: types, repeats, branches labelled IF/OR, END, GOTO. Nodes drag, clicking one opens the quest editor.
• Location zones — X/Y/Z/radius straight from the editor, no waypoint blocks in the world.
• Reward choice — a per-quest "player picks one" reward mode.
• No objective limits — kills, dialogs, counters are unlimited; kill targets are picked from the entity registry with search instead of being typed by hand.
• The quest log is rebuilt: quest list + scrollable story + every objective coloured by state.

Dialogs

• A conversation screen in journal style: the exchange history with speaker names (NPC in accent, player in green), numbered replies, digits 1–9 as hotkeys, trade as its own button.
• A dialog scheme per NPC: nodes are dialogs, edges are replies, labelled IF/OR/END/GOTO.
• Availability conditions are an unlimited list (used to be 4+4+2+2 fixed slots) with an "all conditions / any condition" combiner, and they can now gate individual reply options too.
• NPC dialogs and reply options are unlimited, shown as a list or tiles.

Shops

• Offers are data, not slots. No 18-offer limit; stock, faction-reputation prices, up to four item prices, categories, search, tile/list view modes.
• Setting up a shop costs no items — the editor slots copy what you hold instead of taking it.
• Purchases are visible instantly: the inventory syncs the moment the trade happens, with a pickup sound and a "Bought ×N" confirmation; Shift/Ctrl buys in bulk.
• Shop from a dialog — a dialog option can open a saved market with no trader role needed.

Editor

• A dark grey theme drawn from a palette instead of textures. Config switch: dark / light / legacy.
• Rebuilt screens: measured layout (no language overlaps its controls), sections with headers, dropdowns instead of cycle-buttons, scrolling instead of page-flipping, hover hints on icon buttons, an unsaved-changes indicator with Ctrl+S. The classic layout of the main editor remains available as a choice.
• The text editor (quest texts, dialogs, scripts): line breaks show immediately, the view follows the cursor, Home/End, Shift+click, Ctrl+Backspace, Ctrl+Z/Y.

Localisation

A complete Ukrainian translation — 760 lines, 100% coverage. The mod had no Ukrainian file at all before this build.

Installation

Like any Forge mod: drop the .jar into your mods folder.

Important when upgrading from the original build

Back up your world before the first launch. Shops and availability conditions convert from the old format automatically, but are saved only in the new one — a world saved by this build will not open with the original mod.

Permissions. If non-operators edited NPCs on your server, they now need either operator rights or explicitly granted customnpcs.* nodes. This change is intentional.

Recipes. If the world ran on the original 1.16.5, the recipe file may have stayed empty — those recipes have to be recreated once. They persist from then on.

Looks. The theme defaults to dark. To get the original textures back, set GuiThemeName=legacy in config/CustomNpcs.cfg.

Still on the list

• The Inventory tab keeps the classic layout: its geometry is defined by slot positions in a container shared with the server.
• Picking shop goods from the item registry (so items would not need to be in your inventory).
• The player-facing mail, faction and transport screens are still on the old textures.
• Stock of a market opened from a dialog does not persist between openings yet.
• 15 of the 17 languages are partial (Ukrainian and English are complete).

License and credit

The original Custom NPCs mod © Noppes, licensed CC BY-NC — non-commercial use with attribution. This build is distributed under the same terms.

The patch was prepared for the gummercraft.fun community