自定义NPC — BRP

自定义NPC — BRP（BY RAYMAN PATCH）

针对 Minecraft 1.16.5（Forge）的自定义NPC修复构建。 这是一款你所熟知的模组，但修复了错误，重建了编辑器，加入了深色主题，更强大的任务系统以及完整的乌克兰语翻译。

为 gummercraft.fun 服务器 构建并维护。

版本	1.16.5-BRP-0.0.19
Minecraft	1.16.5
Forge	36.2+
语言	乌克兰语、英语（完整）+ 15种部分翻译

---

关于本模组

自定义NPC允许你创建自己的角色，并围绕他们构建一个完整的世界：包含分支对话、任务、有声望的派系、商店、银行、同伴、传送员、邮差。每个NPC都可以详细配置——模型、动画、战斗战术、脚本。

原版模组由 Noppes 制作 — kodevelopment.nl。模组本身的所有功劳归他所有。此构建仅是在其 1.16.5 版本之上的补丁。

---

此构建修复与新增的内容

数据不再丢失

• 木工配方得以保留。 在原版 1.16.5 构建中，整个子系统已经失效：启动时从未读取配方文件，保存无效，删除未移除任何内容，管理器始终收到一个空列表。现已完全恢复。
• 损坏的存档不再阻止写入 — 文件流以前在截断文件上保持打开状态。
• 银行不再无故收费 — 插槽费用在数量检查之前就被收取了。
• 通过脚本完成任务不再导致服务器崩溃。
• 发现并修复了三处无限递归（服务器启动崩溃）。

服务器安全

• 编辑器权限仅限于管理员（OP）。 以前有 30 个权限节点中有 29 个会注册为对每个玩家可用。
• 任何玩家读取世界中任意方块NBT的功能已被关闭。
• 购买操作由服务器验证：索引、价格、库存、声望——以前的价格取决于客户端插槽中碰巧持有的物品。
• 逐元素网络数据包。 大型商店或长任务线不再被打包进单个数据包中——之前这会在约 1 MB 的数据包限制下导致断连。

任务

• 屏幕追踪器：活动任务及其目标显示在角落，已完成任务显示为绿色。击杀进度会在快捷栏上方闪烁显示“僵尸 3/5”。所有功能均可关闭：全局可在配置中关闭，每个任务可在编辑器中单独关闭。
• 混合任务类型 — 一个任务中可同时包含物品 + 对话 + 击杀 + 地点 + 手动计数器。
• 分支任务链 — 可列出多个满足条件后接续的任务候选项；其间第一个满足条件的任务会启动。旧的单一“后续任务”保留为无条件后备选项。
• 任务架构图 — 将整个任务链以图表形式展示：包含类型、重复、带IF/OR标签的分支、END、GOTO等。节点可拖动，点击节点会打开任务编辑器。
• 区域目标 — 可直接在编辑器中设置 X/Y/Z/半径，无需在世界中放置航点方块。
• 奖励选择 — 新增一种任务奖励模式，允许“玩家自选其一”。
• 无目标数量限制 — 击杀、对话、计数器均无限制；击杀目标可从实体注册表中搜索选择，而无需手动输入。
• 任务日志 已重建：包含任务列表 + 可滚动故事详情 + 根据状态着色的每个目标。

对话

• 日志风格的对话界面：显示对话历史，含说话者名称（NPC用特殊颜色，玩家用绿色）、编号回复（数字1–9可作为快捷键）、交易按钮独立显示。
• 每个NPC的对话架构图：节点代表对话，连线代表回复，带有IF/OR/END/GOTO标签。
• 可用条件 变为无限列表（原为4+4+2+2个固定槽位），并带有“所有条件/任一条件”的组合器，同时现在也可以用来限制单个回复选项的可用性。
• NPC对话及回复选项数量无限，可以列表或平铺视图显示。

商店

• 交易项目是数据而非是插槽。 不再有18个交易项目的限制；支持库存管理、基于派系声望的价格、最多四种物品价格、分类、搜索、平铺/列表视图模式。
• 开设商店不再消耗物品 — 编辑器槽位会复制你手持的物品，而不是直接拿走。
• 购买立即可见：交易发生的瞬间库存就会同步，并伴有拾取音效和“已购买 ×N”的确认信息；Shift/Ctrl键可批量购买。
• 从对话中打开商店 — 对话选项可以打开一个已保存的市场，无需商人职业。

编辑器

• 深灰色主题，使用调色板绘制而非纹理。配置切换：dark / light / legacy。
• 重建的界面：采用自适应测量布局（语言文本不再重叠其所属控件）、带标题的分区、使用下拉菜单替换循环按钮、用滚动代替翻页、图标按钮悬停提示、Ctrl+S未保存更改指示器。主编辑器的经典布局仍可选用。
• 文本编辑器（用于任务文本、对话、脚本）：可立即显示换行、视图跟随光标、支持Home/End键、Shift+点击、Ctrl+退格键、Ctrl+Z/Y。

本地化

完整的乌克兰语翻译 — 760 行，100% 覆盖。在该构建之前，此模组完全没有乌克兰语文件。

---

安装

与其他任何 Forge 模组一样：将 .jar 文件放入你的 mods 文件夹即可。

从原版构建升级时的重要提示

首次启动前请备份你的世界。 商店和可用条件会自动从旧格式转换，但仅以新格式保存 —— 由此构建保存的世界将无法在原版模组上打开。

权限。 如果你的服务器上有非管理员玩家编辑NPC，他们现在需要管理员权限或被明确授予 customnpcs.* 权限节点。这是刻意的更改。

配方。 如果世界曾经运行过原版 1.16.5，配方文件可能一直为空 — 这些配方需要重新创建一次。之后便会永久保留。

外观。 主题默认是深色。若需恢复原版纹理，请在 config/CustomNpcs.cfg 中设置 GuiThemeName=legacy。

---

---

待办事项

• 物品栏标签页保留经典布局：其几何形状由与服务器共享的容器中的槽位位置决定。
• 支持从物品注册表中选择商店商品（这样物品就无需在你的物品栏中）。
• 面向玩家的邮件、派系和传送界面仍使用旧纹理。
• 从对话中打开的市场库存目前无法在多次打开之间保持。
• 17 种语言中有 15 种为部分翻译（乌克兰语和英语为完全翻译）。

许可与鸣谢

原版 自定义NPC 模组 © Noppes，遵循 CC BY-NC 许可 — 允许非商业使用并需署名。此构建在相同条款下分发。

此补丁为 gummercraft.fun 社区制作。