Suite

联动

EventPacket 跨模块联动与 Capability

依赖关系

类型依赖作用缺少时表现
必需ArcartXSuite 本体核心 API、存储管理、Capability 注册、PacketBridge、脚本条件引擎模块无法运行
可选PlaceholderAPIPAPI 触发器（papi-increase/decrease/threshold）和 PAPI 条件这部分触发器和条件不生效，启动时输出警告
可选ChemdahChemdah 任务事件触发器（quest-/objective-/chemdah-level-change）这部分触发器不生效，启动时输出警告

SignalDispatchable Capability

EventPacket 模块注册了 SignalDispatchable Capability，供其他模块跨模块调用发送命令信号。信号发送后，所有 trigger: command-signal 且 signal 匹配的规则将被触发。

接口方法

public interface SignalDispatchable {
    // 发送命令信号，触发匹配的 command-signal 规则
    void dispatchSignal(String signal, Player subject, Map<String, String> variables);
}

调用示例

SignalDispatchable signalDispatcher = getCapability(SignalDispatchable.class);
if (signalDispatcher == null) return; // EventPacket 模块未启用
 
Map<String, String> variables = new LinkedHashMap<>();
variables.put("boss_id", "dragon");
variables.put("damage", "1500");
signalDispatcher.dispatchSignal("boss_settlement", player, variables);

信号发送后，规则中可通过 {boss_id}、{damage} 等上下文变量引用传入的变量。

消费的 Capability

EventPacket 模块在动作执行时通过 Capability Supplier 延迟获取其他模块的能力。缺失能力时对应动作直接跳过，不报错。

Capability消费动作提供模块缺失时表现
QuestGpsNavigablequestgps.offer、questgps.accept、questgps.open、questgps.trackQuestGPS任务相关动作跳过
SubtitlePlayablesubtitle.play、announcer.playSubtitle / Announcer字幕播放动作跳过
ChatCardSendablechat.cardChat聊天卡片动作跳过
TitleGrantabletitle.giveTitle称号发放动作跳过
MailDispatchablemail.sendMail邮件发送动作跳过
QQBotBroadcastableqq-broadcastQQBotQQ 广播动作跳过
PacketBridgeAPIui-packet、combateffect.play本体 PacketBridgeUI 包和战斗特效动作跳过

所有跨模块调用通过 Capability Supplier 完成，模块间无编译期依赖，缺失能力时优雅降级。

Chemdah 事件联动

安装 Chemdah 插件且配置了 Chemdah 触发器规则时，Chemdah 任务事件自动接入事件包分发系统。

可对接的 Chemdah 事件

Chemdah 事件触发器注入变量
QuestEvents$Accept$Postquest-accept{quest_id}
QuestEvents$Complete$Postquest-complete{quest_id}
QuestEvents$Fail$Postquest-fail{quest_id}
ObjectiveEvents$Complete$Postobjective-complete{quest_id}、{task_id}、{objective_type}、{objective_name}
ObjectiveEvents$Continue$Postobjective-continue{quest_id}、{task_id}、{objective_type}、{objective_name}
ObjectiveEvents$Restart$Postobjective-restart{quest_id}、{task_id}、{objective_type}、{objective_name}
PlayerEvents$LevelChangechemdah-level-change{level_option}、{old_level}、{new_level}、{old_experience}、{new_experience}、{level_delta}

signal 过滤说明

触发器signal 过滤规则
quest-accept / quest-complete / quest-failsignal 留空匹配所有任务；填任务 ID 仅匹配该任务
objective-complete / objective-continue / objective-restartsignal 可填 quest_id 或 objective_name 过滤
chemdah-level-changesignal 填等级选项 ID 过滤（如 adventure）

脚本触发器

EventPacket 支持 JavaScript 和 Aria 两种脚本触发器，按轮询周期评估脚本表达式。脚本返回 true 时触发规则（仅在从 false 变为 true 的上升沿触发）。

script-js

js_low_health_alert:
  enabled: true
  trigger: script-js
  repeatable: true
  cooldown: "30s"
  script: |
    player.getHealth() / player.getMaxHealth() < 0.25
  actions:
    - type: subtitle.play
      group-id: "low_health_warning"

JavaScript 表达式中 player 变量直接注入 Bukkit Player 对象。

script-aria

aria_high_altitude:
  enabled: true
  trigger: script-aria
  repeatable: true
  cooldown: "1m"
  script: |
    playerY = global.player.getLocation().getY()
    playerY > 200
  actions:
    - type: subtitle.play
      group-id: "high_altitude"

Aria 表达式中 player 门面注入到 global. 命名空间，需用 global.player 访问。

数据存储

EventPacket 模块将击杀计数规则的累计进度与非 repeatable 规则的触发记录存储在数据库中（SQLite 或 MySQL，支持共享存储与自建存储模式）。

  • /axs migrate 支持跨源数据迁移
  • /axs purge 支持按 UUID 或全量清理玩家数据

模块集成示例

与 QuestGPS 联动

# 玩家首次加入时推送主线任务
first_join_offer_mainline:
  enabled: true
  trigger: first-join
  repeatable: false
  actions:
    - type: questgps.offer
      quest-id: "main/example_quest"
      open-menu: true

与 Mail 联动

# Boss 结算时发送奖励邮件
boss_settlement_celebration:
  enabled: true
  trigger: command-signal
  signal: "boss_settlement"
  repeatable: true
  cooldown: "3s"
  actions:
    - type: mail.send
      preset-id: "boss_reward_{boss_id}"

与 Title 联动

# 任务完成后发放称号
quest_completed_title_reward:
  enabled: true
  trigger: command-signal
  signal: "questgps_quest_completed"
  repeatable: false
  actions:
    - type: title.give
      title-id: "newcomer"
      duration: "permanent"

与 Subtitle 联动

# 签到成功时播放庆祝字幕
signin_streak_milestone:
  enabled: true
  trigger: command-signal
  signal: "signin_success"
  repeatable: true
  cooldown: "1d"
  actions:
    - type: subtitle.play
      group-id: "signin_celebrate"

与 Chat 联动

# LittleSkin 玩家首次注册后发送聊天卡片
welcome_littleskin_after_register:
  enabled: true
  trigger: command-signal
  signal: "first_register"
  conditions:
    - "%axsloginview_account_type% == littleskin"
  repeatable: false
  actions:
    - type: chat.card
      card-id: "quest_offer"
      data:
        title: "LittleSkin 登录奖励"
        source: "{account_type_display}"

与 QQBot 联动

# 重要事件通知 QQ 群
notify_qq_group:
  enabled: true
  trigger: command-signal
  signal: "server_milestone"
  repeatable: true
  actions:
    - type: qq-broadcast
      message: "玩家 {player_name} 达成了里程碑！"
      group-id: 123456789

与 CombatEffect 联动

# CDK 兑换成功时播放战斗特效
cdk_redeemed_effect:
  enabled: true
  trigger: command-signal
  signal: "cdk_redeemed"
  repeatable: true
  cooldown: "5s"
  actions:
    - type: combateffect.play
      pack: "{player_name};CDK;{preset_name}"

与 Chemdah 联动

# 玩家完成特定任务时发放奖励
chemdah_quest_completed_reward:
  enabled: true
  trigger: quest-complete
  signal: "main/tutorial"
  repeatable: false
  actions:
    - type: title.give
      title-id: "quest_master"
      duration: "permanent"
    - type: mail.send
      preset-id: "quest_complete_reward"
    - type: subtitle.play
      group-id: "quest_completed"

本页目录