The Wandering NPC - 漫游NPC插件

本插件旨在扩展 Citizens 插件的“漫游”路径点提供器，为 NPC 的随机移动行为提供更多控制。通过设定漫游中心、距离限制和可行走表面，你可以防止 NPC 无限制地游荡或攀爬，使其行为更符合场景需求。

💡功能特性

• 设定漫游中心与范围：为 NPC 设定一个中心参考点，并限制其最大漫游距离。
• 控制路径寻找距离：定义 NPC 每次寻找下一个目的地的最大距离。
• 限制垂直移动：设定 NPC 在每次路径决策中可向上/下移动的最大高度，防止攀爬建筑或异常传送。
• 定义可行走表面：指定 NPC 可以行走的方块类型。
• 玩家接近时暂停：当玩家进入指定半径内时，NPC 可暂停移动（适用于任务发放者等场景）。
• 防止绕圈：启用可配置的路径历史记录功能，避免 NPC 重复走回头路。
• 无需配置文件：所有设置即时生效，无需编辑 config 文件。

🎮使用方法

• 生成一个 NPC。
• 输入指令 /waypoint provider wanderingnpc。插件会自动为该 NPC 添加 wanderingnpc 特性，并将其当前位置设为漫游中心。

精细调整指令

以下指令可用于进一步调整 NPC 的漫游行为

• /wanderingnpc info – 显示当前选中 NPC 的 wanderingnpc 特性设置。
• /wanderingnpc setcenter – 设置 NPC 的漫游中心点。
• /wanderingnpc tpcenter – 将你传送到 NPC 的漫游中心位置。
• /wanderingnpc maxdistance <距离> – 设置 NPC 可漫游的离中心最大距离。
• /wanderingnpc pathdistance <距离> – 设置寻找下一个目的地的最大距离。
• /wanderingnpc climbingdistance <距离> – 设置单次路径寻找中可向上/下移动的最大高度（非相对于中心的总高度）。
• /wanderingnpc pathhistory {#} – 启用或禁用路径历史记录。可附加数字设置记录的位置数量。
• /wanderingnpc pauseplayer {#} – 设置当玩家进入多少格范围内时 NPC 暂停移动。设为 0 或留空则禁用此功能。
• /wanderingnpc addblock – 将手中选中的方块类型添加到 NPC 的可行走表面列表中。
• /wanderingnpc removeblock – 从可行走表面列表中移除手中选中的方块类型。

🔧权限节点

• wanderingnpc.settings – 允许用户更改 NPC 的漫游设置。
• wanderingnpc.tpcenter – 允许使用 /wanderingnpc tpcenter 传送至 NPC 的漫游中心。
• wanderingnpc.info – 允许使用 /wanderingnpc info 查看设置信息。

⭐重要说明

• 本插件的路径寻找基于随机算法，是对原 Citizens 漫游逻辑的扩展和配置化封装。
• 若在设置 NPC 使用本插件后，想再使用 /npc path 指令，需先通过 /waypoint provider linear 将路径点提供器重置为线性模式，并重新设置路径点。
• 关于灵魂沙：NPC 的跳跃高度对某些方块至关重要。例如，在灵魂沙边缘，NPC 可能被卡住，除非将其跳跃高度设置为至少 2，因为灵魂沙略低于普通方块。
• 本插件使用了 PluginMetrics 统计系统。如需禁用，请在 /PluginMetrics/Config.yml 中将 opt-out 设为 true。

❓项目状态

本插件目前仅进行错误修复和维护，以确保其正常工作，不会添加新功能。如需更多新特性，请关注 NPCDestinations 插件。

源码地址：My GitHub