技能状态栏

技能状态栏用于在玩家施法模式中展示技能槽、触发器、强制延迟和当前状态。它适合把常用技能提示放在屏幕底部，减少玩家频繁打开 GUI 查看绑定关系。

配置位置

状态栏位于 config.yml 的 actionbar 节点：

actionbar:
  enabled: true
  refresh_interval_ticks: 10
  template_cast_mode: "<gold>施法模式</gold> %slot_1% %slot_2% %slot_3% <gray>延迟:</gray> %forced_delay%"
  template_idle: ""

字段说明

字段	类型	说明
enabled	boolean	是否启用 Action Bar 刷新。关闭后不再启动刷新任务。
refresh_interval_ticks	integer	刷新间隔，单位 tick。20 tick 约为 1 秒。小于 1 时按 1 处理。
template_cast_mode	string	施法模式开启时显示的模板。留空时回退为内置默认模板。
template_idle	string	非施法模式模板。留空时回退为内置默认值。

当前实现只在玩家处于施法模式时推送 Action Bar：退出施法模式后不再刷新，template_idle 不会被发送给玩家。

模板变量

变量	说明
%slot_display%	所有槽位合并后的展示文本。
%slot_1% ~ %slot_n%	指定槽位展示文本，数量取决于 slots.default_count。
%forced_delay%	全局强制施法延迟剩余时间。

槽位展示会结合技能绑定、触发器显示名、冷却状态和空槽状态生成。触发器显示名来自 triggers.<id>.display_name。

与施法模式的关系

cast_mode:
  entry_key: "f"
  restore_last_state_on_join: true

• entry_key: "f" 表示使用主副手交换键进入或退出施法模式。
• restore_last_state_on_join: true 表示玩家重登后恢复上次施法模式状态。
• 施法模式开启后，主动触发器会开始监听左键、右键、Q 键、数字键等服务端可见操作。

推荐模板

简洁模板

actionbar:
  template_cast_mode: "<gold>施法</gold> %slot_display%"
  template_idle: ""

适合技能槽较少的服务器。

带延迟提示

actionbar:
  template_cast_mode: "<gold>施法模式</gold> %slot_1% %slot_2% %slot_3% <gray>延迟:</gray> %forced_delay%"

适合启用 cast_timing.forced_global_cast_delay_ticks 的服务器。

使用建议

• 如果服务器已有战斗提示、区域提示、任务提示等 Action Bar 输出，应统一规划显示优先级。
• 技能槽数量较多时，推荐使用 %slot_display% 或拆成多组显示，避免一行过长。

排查建议

• 状态栏不显示：检查 enabled 是否为 true，以及玩家是否已进入施法模式。
• 槽位显示为空：检查玩家是否拥有技能、是否已绑定槽位、技能来源是否已同步。
• 延迟一直不变：检查 cast_timing.forced_global_cast_delay_ticks 是否配置异常，技能释放是否成功写入延迟。
• 与其他 Action Bar 插件冲突：调整 refresh_interval_ticks。