插件联动

PlaceholderAPI、MythicMobs 和 Symphony 位于 integrations.yml。SystemMail 的等级礼包发送位于 delivery.yml。PlaceholderAPI 默认开启，其他联动默认关闭；没有安装对应插件时，Echelon 的基础等级功能仍可使用。

PlaceholderAPI

placeholder-api:
  enabled: true

占位符	内容
`%echelon_level%`	当前等级
`%echelon_title%`、`%echelon_stage_title%`	当前阶段称号
`%echelon_experience%`、`%echelon_exp%`	当前等级内已有经验
`%echelon_required_experience%`	升到下一级需要的经验，满级为 `0`
`%echelon_stage_experience%`、`%echelon_max_experience%`	升级所需经验的别名
`%echelon_total_experience%`	玩家已经计入的总经验
`%echelon_progress_percent%`	当前级进度百分比，保留两位小数

玩家数据尚未读取完成时，占位符会暂时返回 0。这些占位符用于在线玩家。

MythicMobs

mythicmobs:
  enabled: true
  experience-path: "Echelon.Experience"

在 MythicMobs 怪物配置中写入经验：

TrainingDummy:
  Type: ZOMBIE
  Display: '&c训练假人'
  Echelon:
    Experience: 50

玩家亲自击杀该怪物后会获得 50 点经验。经验必须是正整数；没有填写经验或最后击杀者不是玩家时不会发放。

修改 experience-path 后，怪物配置中的路径也要一起修改。

Symphony

symphony:
  enabled: true
  provider-priority: 100
  display-name: "玩家等级"

启用后，Symphony 可以读取 Echelon 的等级、当前经验、升级所需经验和阶段称号。

等级来源 ID 固定为 echelon:level；
display-name 是 Symphony 中显示的名称；
provider-priority 用于多个等级来源同时存在时决定优先级。

SystemMail

先安装与 Echelon 配套的 SystemMail，再启用：

enabled: true
poll-seconds: 5
batch-size: 32
processing-timeout-seconds: 30
max-attempts: 100
base-retry-seconds: 2

以上内容填写在 delivery.yml。

通常只需要修改 enabled。其余设置控制自动发送：

配置项	用途与范围
`poll-seconds`	检查间隔，1–300 秒
`batch-size`	每次最多处理 1–256 个礼包
`processing-timeout-seconds`	一次发送最多等待 10–300 秒
`max-attempts`	自动尝试 1–10000 次
`base-retry-seconds`	首次等待 1–300 秒，后续间隔会逐渐增加

玩家升级跨过已启用礼包等级时，每个符合条件的等级都会发送一封邮件。同一玩家的同一级礼包只会发送一次。

SystemMail 暂时不可用时，礼包会保留并继续尝试发送。礼包创建与附件格式见管理与等级礼包。

修改联动开关或参数后可以执行 /eadmin reload。

插件联动

插件联动

PlaceholderAPI

MythicMobs

Symphony

SystemMail

On this page