向导模块

向导模块（Wizard）让 NPC 能够引导玩家从一个地点走到另一个地点。需要安装 Adyeshach 插件。

配置文件放在 Chemdah/module/wizard/ 目录下，每个文件可以包含多个向导配置。

工作原理

向导模块通过 nodes（路径节点）列表，利用 Minecraft 原生寻路算法自动计算 NPC 的行走路径。路径会缓存到本地，重启时直接读取，无需重新计算。

当玩家距离 NPC 超过 waiting-distance 时，NPC 会原地等待；玩家跟上来后继续前进。NPC 到达终点（最后一个节点 finish-distance 范围内）后，触发完成脚本。

配置示例

Chemdah/module/wizard/guide_to_village.yml

guide_to_village:
  # 所在世界
  in: world
  # 路径节点（NPC 经过的坐标）
  nodes:
    - "100 64 200"
    - "120 64 210"
    - "150 65 230"
    - "180 64 250"
  # 到达终点的判定距离
  finish-distance: 2.0
  # 玩家超过此距离时 NPC 停下等待
  waiting-distance: 10.0
  # 是否在引导期间禁止触发对话
  disable-conversation: true
  # 各阶段触发的 Kether 脚本
  event:
    # 玩家跟上来，NPC 继续移动时
    continue: "tell &player '跟上来！'"
    # 玩家落后，NPC 暂停等待时
    waiting: "tell &player '等你呢，快点！'"
    # NPC 到达终点时
    finish: "tell &player '到了，这就是村子。'"
  # 事件触发冷却（避免频繁触发）
  event-cooldown: 5s
  # 寻路初始化最大重试次数（世界未加载时自动重试）
  init-retry: 3
  init-retry-delay: 20

在脚本中启动向导

在任务脚本或对话脚本中，通过 wizard 动作启动引导：

对话脚本中启动向导

# 启动向导，参数为：向导 id、NPC id
wizard start "guide_to_village" entity "npc_guide_001"

# 等待引导完成后继续执行
wizard await "guide_to_village"

提示

路径节点之间的距离建议不超过 30 格，相邻节点间距过大可能导致寻路失败。如果路径不连续（相邻坐标距离超过 2 格），会在控制台输出警告并跳过该向导。