NPCDestinations - Create Living NPC's - NPCDestinations - 智能NPC角色扮演

💡NPC Destinations

本插件为服务器中的 NPC 提供了更生动的生活机制。告别让 NPC 在寒冷黑夜中呆立不动的时代，现在你可以让它们“回家”，坐在像素壁炉旁取暖。想象一下它们会有多兴奋！

🎮核心特性

• 智能寻路系统：自适应环境变化的自动化寻路。
• 配置存储：所有配置直接存储在 NPC 实体上，无需编辑配置文件。
• 多目的地支持：可为 NPC 设置多个前往地点，触发条件包括时间、命令或环境因素。
• 数据备份：内置 Citizens saves.yml 备份系统及存储设置。
• 路径表面控制：可设置为在任何表面行走，或自定义允许的路径表面。
• 自定义路径：基于地表下方（向下 # 格或第 0 层）的方块构建路径。
• 随机移动：基于预设地点进行随机移动。
• 外观与装备：

- 可为每个地点设置不同的 NPC 皮肤。

- 可为每个地点更换 NPC 的装备。

• 位置随机行走：可为每个地点单独定义随机行走配置。
• 命令控制：使用命令设置 NPC 的当前位置（可设定持续时间）。
• 权限管理：详细的权限控制每个命令的访问，可允许用户编辑任何或仅限其拥有的 NPC。
• 调试工具：内置调试和可视化路径系统，可快速排查任何路径问题。
• 聊天管理：强大的 Jason 聊天管理系统，通过点击聊天项节省时间。
• 多语言支持：可自定义的语言文件和语言标志。
• 区块管理：自定义 WorldGuard 标志用于区块管理 (ndest-forcechunk)。

- 服务器启动时预加载区块并保持其活跃。

- 基于区域防止区块卸载。

• API：提供与插件本身交互的 API。

🔧前置与依赖插件

必需插件

• Citizens2 (NPC 基础机制)

可选支持插件

• Quests (可与 Quests 插件交互)
• JobsReborn (可根据用户职业状态切换 NPC 位置)
• LightAPI (为 NPC 装备火把（普通或红石），使其在夜晚照亮周围区域)
• PlotSquared (允许用户在他们的地皮中赋予 NPC 更多活力)
• BetonQuest (提供从 BetonQuest 控制 NPC 的条件和事件) 示例包

扩展插件

• Destinations Farmer Add-on - 收割作物并重新种植。
• Destinations Animations Add-on - 在不同地点启用动画。
• Destinations Rancher Add-on - 允许你的 NPC 饲养和管理动物。

✨快速入门教程

• 下载插件最新版本，放入服务器的 plugins 文件夹。
• 启动服务器。
• 创建一个 NPC。
• 输入命令 /nd autoset。
• 前往你希望 NPC 站立的第一位置。
• 输入命令 /npcdest addlocation {时间/日落/日出}。
• 前往你希望 NPC 前往的第二位置。
• 再次输入命令 /npcdest addlocation {时间/日落/日出}。
• 改变游戏内时间，NPC 应会切换位置。

⭐权限列表

npcdestinations.info

显示 NPC 信息、调试状态。

• 包含权限：

- `npcdestinations.debug.set`

- `npcdestinations.debug.own`

- `npcdestinations.debug.all`

- `npcdestinations.enginestatus`

- `npcdestinations.allstatus`

- `npcdestinations.info`

- `npcdestinations.backup`

npcdestinations.settings

更改 NPC 配置的能力。

• 包含权限：

- `npcdestinations.editall.info`

- `npcdestinations.editall.autoset`

- `npcdestinations.editall.goloc`

- `npcdestinations.editall.blockstick`

- `npcdestinations.editall.addlocation`

- `npcdestinations.editall.removelocation`

- `npcdestinations.editall.addblock`

- `npcdestinations.editall.removeblock`

- `npcdestinations.editall.removeallblocks`

- `npcdestinations.editall.pauseplayer`

- `npcdestinations.editall.oneblockdown`

- `npcdestinations.editall.opengates`

- `npcdestinations.editall.openwooddoors`

- `npcdestinations.editall.openmetaldoors`

- `npcdestinations.editall.locmax`

- `npcdestinations.editall.locprob`

- `npcdestinations.editall.locwand`

- `npcdestinations.editall.loctime`

- `npcdestinations.editall.locloc`

- `npcdestinations.editall.localias`

- `npcdestinations.editall.locskin`

- `npcdestinations.editall.locjobs`

- `npcdestinations.editall.locsentinel`

- `npcdestinations.editall.locweather`

npcdestinations.debug.*

授予所有调试级别访问权限。

• 包含权限：

- `npcdestinations.debug.set`

- `npcdestinations.debug.npc`

- `npcdestinations.debug.all`

npcdestinations.editall.*

更改任何 NPC 配置的能力。

• 包含权限：与 npcdestinations.settings 下列出的所有 editall 权限相同。

npcdestinations.editown.*

仅更改已拥有 NPC 配置的能力。

• 包含权限：与 npcdestinations.settings 下列出的所有 editall 权限对应，但前缀改为 editown（例如 npcdestinations.editown.info）。

❓教程视频与资源

英文教程视频

• NPC Destinations V 1.0 - 教程 [允许的方块 / 演示视频]
• NPC Destinations V 1.0 - 教程 [地表下允许的方块]
• NPC Destinations V 1.0 - 教程 [无方块限制 - 即“散养鸡”模式]
• NPC Destinations V 1.15 - 教程 [调试 NPC 拒绝寻路的原因]
• NPC Destinations V 1.16+ - 教程 [盔甲 / 装备]
• NPC Destinations V 1.20 - 教程 [别名使用示例]
• NPC Destinations V 1.29 - 教程 [天气]
• NPC Destinations V 1.33 - 教程 [皮肤]

外部插件集成教程

• NPC Destinations V 1.31 - 教程 [JobsReborn]
• NPC Destinations V 1.39 - 教程 [Sentinel]

运行示例服务器

• Medieval-Craft (medieval-craft.my-serv.com)

- 示例 GIF: http://www.livecar.net/random/mecraft.gif

🔧未来计划

• NPC 分组：继续完善 NPCGroups 相关功能。
• 路径缓存：如果从 # 到 # 的路径已计算过，则缓存它，仅在搜索新路径前检查变化。
• 支持带数据的方块：当前仅支持材料类型。计划使其能使用该方块的所有类型或单一类型（例如不同朝向的楼梯）。
• 更好的门控制：当前方案较为简单，计划改为基于 NPC 的视角进行控制。
• 更多 BetonQuest 集成：堆叠地点。为 NPC 设置一系列按顺序访问的地点（例如：访问 #1，等待5秒，访问 #3，等待30秒，返回 #2）。如果你有关于 BetonQuest 集成的想法，请告知。

🎮技术信息

• 源代码：GitHub
• 寻路算法：使用的 A 寻路算法修改自 Adamki11 的 a Lib，原始代码可在此处找到。
• 统计：本插件使用 Metrics 统计系统。如需禁用，请参考此链接并查看右下角说明。此功能主要用于作者的好奇心。

特别感谢

感谢 Spigot 社区中给予巨大帮助的各位（排名不分先后）：

• @Co0sh：创造了 BetonQuest，间接激励我编写了更多插件。
• @bbayu：始终提供插件反馈，并帮助他人解决问题、理解本插件。
• @Superola：在早期问题上给予支持，并推动我持续改进。
• @Bundabrg：在各方面提供帮助，是社区中的热心伙伴。