NPC Plugin - NPC插件 - 自定义NPC管理

NpcPlugin 允许你在服务器中创建、自定义和管理类玩家 NPC。它提供了一个直观的游戏内编辑器 GUI、可配置的点击动作以及内置的路径系统，让你轻松打造交互式 NPC。

💡支持版本

• Spigot: 1.17.1 - 26.1
• Paper: 1.21 - 1.21.11

🎮核心特性

• 游戏内 NPC 编辑器：切换编辑模式后，可直接与 NPC 交互来配置其各项属性。
• 点击动作：可为左键、右键或双键点击配置一系列连锁动作。
• 路径系统：创建、可视化并测试路径，并让 NPC 沿路径行走。
• 本地化与 PlaceholderAPI：内置语言文件（默认英语），并软依赖支持 PlaceholderAPI。
• 开发者 API：提供详细的开发文档。

- Spigot API: https://github.com/Eisi05/NpcApi-Spigot/wiki

- Paper API: https://github.com/Eisi05/NpcApi-Paper/wiki

编辑器可配置项

在编辑模式中，你可以调整 NPC 的

• 名称
• 皮肤（玩家名、UUID 或本地 .png 文件）
• 玩家专属皮肤
• 装备栏物品
• 可见性与启用状态
• 玩家列表可见性
• 名称标签隐藏
• 姿势
• 皮肤层显示
• 发光效果及颜色
• 注视玩家的半径与间隔
• 大小缩放
• 传送功能
• 删除 NPC

点击动作类型

在 NPC 编辑器的“点击动作”页面，你可以配置以下内置动作：

• Command：执行命令。无需输入开头的 /，可使用 @s 指代点击的玩家。
• Server：将玩家传送至指定的 BungeeCord 服务器。
• Wait：在执行下一个动作前等待一段时间。
• Animation：播放一个动画。
• Path：让 NPC 以指定速度沿一个已保存的路径行走。

动作编辑技巧

• 移除动作：中键点击已有的动作。
• 快速添加：Shift+点击动作类型可将其追加到列表末尾。
• 重新排序/插入：将动作类型拿在手上（光标上），然后点击目标槽位。

🔧权限

• npc.admin

- 默认授予：OP 玩家

- 效果：授予所有 NPC 命令和游戏内编辑器的访问权限。

✨入门指南

安装

• 下载插件 jar 文件，放入服务器的 plugins/ 文件夹。
• 启动服务器一次以生成配置文件。
• （可选）根据需要编辑配置文件：

- `plugins/NpcPlugin/config.yml`

- `plugins/NpcPlugin/lang/<language>/*.yml`

• 重启服务器或执行 /npc reload 以应用配置更改。

快速开始

• 创建 NPC

- 执行 `/npc create`

• 启用编辑模式

- 执行 `/npc edit`

- 启用后，与 NPC 互动即可打开其编辑器 GUI。

- 如果 NPC 不可编辑，你会看到提示：`This NPC is not editable!`

• 在 GUI 中配置 NPC

- 使用上述编辑器选项来自定义你的 NPC。

🔧路径系统指南

路径是共享的，存储在 plugins/NpcPlugin/paths.yml 中。

通过添加点创建路径

• 添加路径点：在你当前位置添加一个点。

    /npc path point add

• 在指定索引处添加点：

    /npc path point add <索引>

• 列出所有点：

    /npc path point list [页码]

• 可视化/切换可视化当前点集：

    /npc path visualize points

• 创建路径：

    /npc path create <路径名称> [最大迭代次数] [允许对角线移动]

• 创建后可视化路径：

    /npc path visualize <路径名称>

通过行走录制路径

• 开始录制：

    /npc path record start

• 行走你想要 NPC 跟随的路线。
• 停止录制：

    /npc path record stop

• 创建路径：

    /npc path create <路径名称>

编辑现有路径

/npc path edit <路径名称>

此命令会将已保存路径的路径点加载到点列表中，以便你移除、添加点并重新创建它。

其他路径命令

• 列出路径：/npc path list [页码]
• 删除路径：/npc path delete <路径名称>
• 测试路径：/npc path test <路径名称> [速度]

🎮命令列表

核心命令

• /npc create – 创建一个 NPC。
• /npc copy <uuid> – 复制一个指定 UUID 的 NPC。
• /npc edit – 切换 NPC 编辑模式。
• /npc list – 列出所有 NPC。
• /npc tp <uuid> – 传送到指定 UUID 的 NPC。
• /npc tphere <uuid> – 将指定 UUID 的 NPC 传送到你身边。
• /npc reload – 重载插件配置和语言文件。
• /npc version – 显示插件版本。
• /npc update – 检查更新。

配置命令

• /npc config reload – 重载配置文件。
• /npc config debug [true|false] – 启用或禁用调试日志。
• /npc config avoid-command-check [true|false] – 是否跳过对 NPC 动作中命令的严格验证。
• /npc config look-at-update-interval [ticks] – 设置“注视玩家”的更新间隔（刻）。
• /npc config input-time [seconds] – 设置对话输入超时时间（秒，若 < 0 则无超时）。
• /npc config auto-update [true|false] – 是否在选项更改后自动更新 NPC。
• /npc config placeholder-timer [ticks] – 设置占位符刷新间隔（刻）。
• /npc config list – 列出当前配置。

异常命令（启动加载失败）

• /npc exceptions [页码] – 列出启动时加载失败的 NPC。
• /npc exceptions show <名称> – 显示指定 NPC 的加载失败详情。
• /npc exceptions delete <名称> – 删除指定 NPC 的加载失败记录。

路径命令

所有路径命令均以 /npc path 开头，主要子命令包括：

• point add [index] [location] [rotation]
• point remove [index|location]
• point list [page]
• point clear
• create [name] [maxIterations] [allowDiagonalMovement]
• delete <name>
• list [page]
• visualize [name]
• visualize points
• record start|stop
• test <name> [speed]
• edit <name>

🔧配置文件

主配置文件位于 plugins/NpcPlugin/config.yml。主要选项包括：

• look-at-update-interval：NPC“注视玩家”的更新间隔时间（刻）。
• avoid-command-check：若为 true，则不会严格验证添加到 NPC 动作中的命令。
• debug：启用额外的调试日志记录。
• input-time：对话输入超时时间（秒）。
• auto-update：NPC 选项更改后是否自动更新 NPC 外观。
• placeholderTimer：占位符刷新间隔时间（刻）。

❓故障排除

• 提示“This plugin does not support Paper servers!”

- 原因：你在 Paper 服务器上安装了 Spigot 版本的插件。

- 解决：请下载并安装对应的 Paper 版本插件。

• Server 动作无效

- 原因：BungeeCord 未正确设置，或服务器名称与代理配置不匹配。

- 解决：确保 BungeeCord 网络已正确配置，且动作中填写的服务器名称与代理配置一致。

• 无法打开编辑器 GUI

- 请检查你是否：

1.  拥有 `npc.admin` 权限。

2.  已通过 `/npc edit` 启用了编辑模式。

3.  该 NPC 被标记为可编辑。

⭐支持与贡献

• 如有任何建议或遇到问题，可通过讨论页或 Discord @Eisi05 联系。
• 欢迎制作关于本插件的教程视频。