CustomNPCs 1.7.6
on 2025 Oct 08- 此更新添加了对 1.21.9 的支持
- 更新了部分依赖库
CustomNPCs 1.7.5
on 2025 Aug 08新功能:
- 1.21.5 - 1.21.8 支持
- NPC 姿势
- 有 6 种可能的姿势:站立、坐下、蹲下、游泳、死亡和睡觉。
- NPC 推动
- 推动是一种一次移动 NPC 一点以精确定位它们的方式。滚动时蹲下会将移动增量从每个槽位 0.05 块增加到每个滚动槽位 0.25 块。
- 原生多行全息图
- 您现有的名称将自动转换为新系统
- 能够将 NPC 上下颠倒
- 此选项在额外设置菜单(右上角比较器)中访问
- 能够为动作添加冷却时间
- 它们的配置与配置延迟非常相似。动作处于冷却时间时没有消息。
错误修复
- 修复了在无团队方法下可见的 UUID,这对其他插件更加宽容
- 修复了能够一次向多个动作提供文本输入的问题
- 修复了服务器启动后更改睡眠百分比但未被尊重的问题
- 修复了在胸甲槽中无法装备鞘翅的问题
- 修复了在装备菜单中点击物品的问题
- 将默认 NPC 名称更改为“未命名 NPC”
- NPC 名称标签的跟随更加平滑
- 在旁观者模式下,NPC 不再有可见的盔甲架骑在它们身上
- NPC 现在忽略旁观者并且不看他们
- 修复了从 URL 导入皮肤的问题
- 修复了命令库的一些问题
- 修复了最新纸版本上的菜单错误
- 修复了运行时依赖项下载的一些问题(感谢纸!)
开发者更改
- NPC#moveTo(Location) 已重命名为 NPC#teleport(Location),因为 moveTo 被保留用于稍后的其他移动相关功能 :)
- Settings 类现在有一个方法可以直接从玩家对象导入玩家的皮肤
- NPC 不再有“名称”,而是有一个“行”数组。get/set 名称方法现在已弃用,仅影响顶行。
- 可以在设置对象中更改姿势
- 添加了“面向”系统,以更一致地处理 NPC 的偏航和俯仰。
- 自定义动作应在其
perform方法中调用Action#activateCooldown(UUID)。
CustomNPCs 1.7.5-pre8
on 2025 Aug 08修复了上下颠倒按钮无法工作的问题(哎呀!)
CustomNPCs 1.7.5-pre7
on 2025 Aug 08此版本添加了将 NPC 翻转倒置的功能。此功能可在额外设置菜单中访问。

CustomNPCs 1.7.5-pre6
on 2025 Aug 08- 修复了插件在 1.21.8 版本上无法启用的问题。
- 为动作添加了冷却时间,默认值为 0。
CustomNPCs 1.7.5-pre5
on 2025 Jul 25Bug 修复:
- 修复了最新 paper 版本中菜单的错误
- 其他杂项仓库修复
此版本没有明显变化。
CustomNPCs 1.7.5-pre4
on 2025 Jul 11修复导致插件无法加载的库加载问题
CustomNPCs 1.7.5-pre3
on 2025 Jul 05新功能:
- 支持 1.21.6-7
错误修复:
- 更新了命令
- 修复了从 URL 导入皮肤的问题
- 修复了观众实际上未被忽略的问题
开发者更改:
- 添加了一个“朝向”系统,以更符合处理 NPC 偏航和俯仰的方式。
CustomNPCs 1.7.5-pre2
on 2025 Jun 16新特性:
- NPC姿势
- 现在NPC可以摆姿势了!有6种可能的姿势:站立、坐下、蹲下、游泳、濒死和睡觉。
- NPC轻推
- 轻推是一种每次稍微移动NPC以精确放置它们的方法。在滚动时蹲下会将移动增量从每次滚动一格0.05个方块增加到0.25个方块。
- 原生多行全息影像
- 现在您无需使用
<newline>迷你消息标签,就可以创建单独的行。您现有的数据将自动转换。
- 现在您无需使用
漏洞修复:
- 修复了一个导致鞘翅无法装备在胸甲栏位的漏洞。
- 修复了装备菜单的一些问题。
- NPC的默认名称从
未设置更改为一个未命名的NPC。 - NPC的名称标签现在应该能更好地跟随它们了。
- 在旁观者模式下,NPC身上不再有可见的盔甲架骑着它们了。
- 一系列我没记录下来的微小修复。
- NPC现在会忽略旁观者,并且不会看他们。
开发者改动:
NPC#moveTo(Location)被重命名为NPC#teleport(Location),因为moveTo将被保留用于稍后的其他与移动相关的特性哦 :wink:- 设置类现在有一个导入玩家皮肤的方法。
- NPC不再有“名字”,而是有一个“行”的数组。获取/设置名称的方法现在已过时,并且仅影响第一行。
- 姿势可以在设置对象中更改。
- 此次更新可以通过
1.7.5-pre2API版本使用。
这次更新花费的时间比应该花费的时间长得多,但现在它已经来了 :) ~ Foxikle <3
CustomNPCs 1.7.5-pre1
on 2025 Jun 15新特性:
- 支持1.21.5版本
漏洞修复:
- 通过使用一种不同的(无队伍的)方法修复了NPC的通用唯一识别码(UUID)可见的问题。
- 修复了能够同时为多个操作提供文本输入的问题。
- 修复了在服务器启动后更改睡眠百分比但未生效的问题。
已知问题:
- 在物品栏中拖动物品会抛出错误。这是由于PaperMC开发者不支持对Paper插件进行字节码重写所导致的。对此我无能为力,请向他们反馈。
- 创建NPC时会出现一种罕见的踢出情况。我不确定是什么原因导致的,但我正在努力查明。
路线图:
在1.8版本以及新的数据序列化和存储功能之前,我希望实现以下特性:
- 合适的多行NPC全息影像。
- 姿势(坐着、游泳等)
关于睡眠百分比的说明:该插件会将睡眠百分比修改为与您所设置的百分比相等,并根据NPC的数量进行校正。所以,如果您的服务器睡眠百分比设置为100,而您的世界中有1个NPC,那么运行命令/gamerule playersSleepingPercentage得到的百分比将是50。
CustomNPCs 1.7.4
on 2025 Apr 25这是一个相当小的版本,但它修复了:
- 维度变更和加入时的注入问题
- 错误设置睡眠百分比的问题
- 现在它会通过游戏规则尊重用户定义的睡眠百分比
CustomNPCs 1.7.3
on 2025 Apr 04本次发布主要包含了过去一个月的漏洞修复内容
- 修复了传送自定义菜单中的显示按钮始终显示X坐标的问题
- 修复了播放声音时音量和音调颠倒的问题
- 修复了依赖的加载顺序
- 创建了一个新的
/npc debug命令来帮助你协助我进而帮助你。(在寻求支持时,它会为我提供有用信息) - 对不同维度周围的注入逻辑做了一些小的改进
- 添加了一个在传送时对NPC名称标签进行插值的配置选项
CustomNPCs 1.7.2
on 2025 Jan 17重要说明:此版本删除了在 spigot 服务器上使用此插件的功能。作为此更改的额外好处,插件现在将在运行时加载所需的依赖项。这使得最终的 jar 文件小得多(大约小 10 倍!)。不利的一面是,下载所需的依赖项可能需要“一段时间”(在我的情况下约为 2 分钟)。这是有利的,因为它存储了下载的依赖项,只需要下载一次!
好了,继续补丁说明:
错误修复
- 修复在 1.21.3+服务器上使用服务器上的任何内容时的错误
- 在某些情况下修复全息图注入问题
- SetSound 动作现在使用键控声音(
minecraft:ui.button.click),而不是ui_button_click。这可能是有害的,因为它不会从旧声音转换。(动作仍然运行,会在控制台打印警告并且不播放声音)。但是,这现在允许你播放资源包声音!只需使用命名空间和声音 ID。namspace:id。
这主要是一个错误修复类型的更新,因为我已经开始致力于 1.8 系列的更新,从优化数据存储开始。所以你可以期待它;) Foxikle <3
CustomNPCs 1.7.1 -- HOTFIX
on 2024 Dec 25CustomNPCs v1.7.1
- 修复了条件解析的严重错误,防止 NPC 加载
- 修复了每次服务器启动时都会备份配置的问题
CustomNPCs 1.7
on 2024 Dec 25自定义 NPC 1.7
我发现 Bukkit 配置 API 在位置无效时决定吃掉它们。我无法恢复它们。对此给您带来的不便我表示歉意
新功能
- 1.20.5 - 1.21.4 支持。
- 本地化!CustomNPCs 现在支持以下语言:
- 俄语(部分支持)
- 德语(部分支持)
- 阿拉伯语(部分支持)
- 简体中文(完全支持)
- 越南语(完全支持)
- 英语(完全支持)
- 动作系统重写
- 可以通过 API 注册自定义动作
- 运行命令动作现在可以以控制台身份运行命令请注意
- 运行命令动作现在将在原始命令文本中解析占位符
- 显示标题动作现在可以有副标题
- 各种性能增强
- 一个新命令
/npc fixconfig:- 需要
customnpcs.commands.fix_config权限 - 以下是一些示例用法,并附有解释:
/npc fixconfig world <有效世界> <策略> <目标> - 有效世界必须是 Bukkit 加载的世界(Multiverse 也应该可以)
- 策略可以是
NONE,不关心验证 NPC 的位置。SAFE_LOCATION策略将验证 NPC 不会卡在任何固体块中。如果是,插件将选择具有相同 x 和 z 坐标的最高块。如果无法找到位置,则忽略 NPC。 - 目标可以是
all,适用于所有 NPC 或特定 NPC 的名称或 UUID
- 需要
- 一个新的命令框架
- NPC 配置在第一次解析时进行验证,而不是在加载时
- 现在对于 wiki 命令有一个特殊权限;
customnpcs.commands.wiki
错误修复:
- 修复了导致 NPC 显示不正常的一系列注入问题
- 修复了 NPC 影响睡眠百分比的问题
- 修复了重生后 NPC 消失的问题
- 修复了 NPC 被注入到错误维度的问题
- 修复了 NPC 名称标签可见(数字和字母)的问题
- 修复了与 API 的事件部分相关的一系列错误
- 修复了
/reload的一个错误 - 修复了一个问题,即如果淡入选项为 1,则无法降低显示标题的淡出选项
- 修复了 NPC 朝向加载不正确的问题
开发者更改
- 移除了 Bukkit 服务 API(似乎没有人使用它)
- Settings#direction 现在已弃用。您应该使用 SpawnLocation 的偏航角
- 您可以编写自己的动作。阅读文档以了解如何 :)


