战令系统

战令（Battle Pass）是 EMC 签到联合的核心玩法之一，以赛季为周期，通过签到积累经验提升等级，解锁免费和高级双轨道奖励。

基本概念

概念	说明
赛季	战令以赛季为运营周期，每赛季可自定义名称
等级	默认 30 级，每级需要 100 经验
经验来源	每次签到获得 50 经验（可配置）
免费轨道	所有玩家均可领取的奖励通道
高级轨道	需激活高级战令后才可领取的额外奖励通道

升级机制

战令经验来源：
  签到 → 每次 +50 经验（配置项 battlepass.signin-exp）
  管理员手动 → /bp addexp <玩家> <数量>

升级公式：
  每级所需经验 = 100（固定值，配置项 battlepass.exp-per-level）
  
示例：
  签到第 1 天 → 50 exp → 等级 0
  签到第 2 天 → 100 exp → 升级！等级 1
  签到第 3 天 → 50 exp → 等级 1 (50/100)
  ...
  签到第 60 天 → 等级 30（满级）

双轨道奖励

免费轨道

所有玩家在等级达到后均可领取，不需要任何额外条件。

等级	默认奖励
1	32 个石头
5	16 个铁锭
10	5 颗钻石
15	3 个金苹果
20	3 个钻石块
25	5 个钻石块
30	1 个下界之星 + 10 个钻石块

高级轨道

需要管理员通过 /bp grant <玩家> 命令激活高级战令后才可领取。通常作为服务器付费增值内容。

等级	默认奖励
1	32 个铁锭
5	16 个金锭
10	10 颗钻石
15	高级奖励包
20	高级奖励包
25	10 个钻石块
30	3 个下界之星 + 16 个钻石块

提示

免费轨道和高级轨道的奖励是独立领取的。激活高级战令的玩家可以同时领取两个轨道的奖励。

自定义奖励

奖励通过配置文件中的 commands 字段执行，支持任意服务端命令，因此可以发放任何内容：

battlepass:
  free-rewards:
    10:
      commands:
        - "give %player% diamond 5"
        - "eco give %player% 1000"          # 发金币
        - "lp user %player% permission set vip.fly" # 给权限
      display-name: "&b豪华奖励包"
      display-material: DIAMOND

• commands — 领取时执行的命令列表，%player% 替换为玩家名
• display-name — 在战令 GUI 中显示的物品名称
• display-material — 在战令 GUI 中显示的物品图标（Material 名）

管理操作

激活高级战令

/bp grant <玩家>

为在线玩家激活高级战令。激活后该玩家可领取高级轨道所有已解锁等级的奖励。激活状态永久有效（当前赛季内）。

手动增加经验

/bp addexp <玩家> <数量>

为在线玩家增加指定数量的战令经验。可用于活动奖励、补偿等场景。如果经验足够会自动升级。

赛季运营建议

1. 赛季切换 — 更新 config.yml 中的 season-name，清空玩家数据文件中的战令相关数据
2. 奖励设计 — 免费轨道提供基础资源，高级轨道提供稀有物品或特权
3. 经验调控 — 通过调整 signin-exp 和 exp-per-level 控制升级速度，确保赛季周期内满级需要合理天数
4. 搭配签到 — 战令经验仅通过签到获取，形成"签到→升级→领奖"的正向循环