该插件扩展了 Citizens 的漫游寻路功能。它允许你定义 NPC 漫游的中心点和最大距离，控制其可行走的表面，并在玩家靠近时暂停。无需编辑配置文件，即可实时调整 NPC 的漫游设置。

🚶WanderingNPC

✨特性

• 定义 NPC 漫游的中心点和最大距离。
• 设置寻找下一个目的地的距离。较小的数值适用于拥挤区域。
• 限制 NPC 在每次寻路时可以攀爬的高度，防止其爬上建筑物。
• 定义 NPC 可以行走的表面类型。
• 当玩家进入指定半径时，NPC 可以暂停。
• 通过启用路径历史记录（可配置数量）来防止 NPC 绕圈行走。
• 无需编辑配置文件，即可立即生效。

🛠️使用方法

生成一个 NPC，输入 /waypoint provider wanderingnpc。插件会自动为 NPC 分配 trait，并将中心点设置为 NPC 的当前位置。

命令

• /wanderingnpc info - 显示当前选中 NPC 的 wanderingnpc trait 设置。
• /wanderingnpc setcenter - 设置 NPC 的漫游中心点。
• /wanderingnpc tpcenter - 将你传送到 NPC 的中心位置。
• /wanderingnpc maxdistance {距离} - 设置 NPC 可以漫游的最大距离。
• /wanderingnpc pathdistance {距离} - 设置寻找下一个目的地的最大距离。
• /wanderingnpc climbingdistance {高度} - 设置 NPC 在单次寻路事件中可以攀爬的最大高度。
• /wanderingnpc pathhistory {#} - 启用或禁用路径历史记录。添加数字可定义要跟踪的位置数量。
• /wanderingnpc pauseplayer {#} - 当玩家距离 NPC # 个方块时，NPC 暂停。0 或留空禁用此功能。
• /wanderingnpc addblock - 将你手中选定的方块类型添加到 NPC 允许行走的表面。
• /wanderingnpc removeblock - 将你手中选定的方块类型从 NPC 允许行走的表面中移除。

权限

• wanderingnpc.settings - 允许用户更改 NPC 的漫游设置。
• wanderingnpc.tpcenter - 允许传送到 NPC 的中心位置。
• wanderingnpc.info - 允许查看设置。

📝注意

• 寻路是随机的，基于 Citizens 的原有机制进行扩展。
• 该插件允许实时更改 NPC 设置，而无需编辑 saves.yml 文件。
• 如果在设置 NPC 使用此插件后想使用 /npc path 命令，需要将寻路提供者重置为 linear。使用 /waypoint provider linear 重置，并重新设置寻路点。
• 如果NPC卡在灵魂沙边缘，请将NPC的跳跃高度设置为至少2。
• 本插件使用 Metrics 系统。要禁用它，请打开 /PluginMetrics/Config.yml 并将 opt-out 设置为 true。

⚙️配置示例

# 你可以在这里添加配置示例