管理命令与奖励编辑器
命令权限、玩家签到类型、奖励内容与邮件模板
管理命令与奖励编辑器
命令与权限
| 命令 | 权限 | 说明 |
|---|---|---|
/advent open | advent.use | 打开当前新人或回归签到界面 |
/advent gui | advent.admin.edit | 打开签到类型选择与奖励编辑器 |
/advent edit <newcomer|returning> | advent.admin.edit | 直接编辑指定类型的签到奖励 |
/advent set <玩家> <newcomer|returning> | advent.admin.set | 将玩家设置为新人或回归玩家 |
/advent retry <奖励记录ID> | advent.admin.retry | 重新发送已暂停的奖励 |
/advent reload | advent.admin.reload | 重载奖励、语言文件与UI |
/adv 是 /advent 的别名。advent.use 默认向所有玩家开放，四个管理权限默认只向 OP 开放。
设置玩家签到类型
管理员或控制台可以为已加入过服务器、已有 Advent 记录的玩家设置签到类型：
newcomer 表示新人，returning 表示回归玩家，也可以填写 new、return、新人、回归。玩家参数支持在线或离线玩家的名称，也支持 UUID；离线同名记录不唯一时，需要改用 UUID。
- 切换会结束原来未完成的活动，原活动不能继续签到或领取额外奖励。已经领取的记录和待发送奖励保留，已送达的邮件不撤回。
首次安装的默认奖励
首次安装会创建新人和回归两套物品奖励，每套包含七份日奖励和一份连续七日额外奖励。
默认每份奖励有一个物品附件，邮件领取期限为 30 天，没有默认货币或命令奖励。奖励内容保存在数据库中。
| 奖励 | 新人签到 | 回归签到 |
|---|---|---|
| 第 1 天 | 面包 × 8 | 牛排 × 12 |
| 第 2 天 | 铁锭 × 4 | 铁锭 × 8 |
| 第 3 天 | 附魔之瓶 × 8 | 附魔之瓶 × 16 |
| 第 4 天 | 绿宝石 × 2 | 绿宝石 × 4 |
| 第 5 天 | 钻石 × 2 | 钻石 × 3 |
| 第 6 天 | 金苹果 × 2 | 下界合金碎片 × 1 |
| 第 7 天 | 钻石 × 4 | 钻石 × 5 |
| 连续七日 | 不死图腾 × 1 | 附魔金苹果 × 1 |
编辑流程
- 执行
/advent gui，选择“新人七日签到”或“回归七日签到”； - 选择第 1 至 7 天，或“连续七日额外奖励”；
- 编辑奖励名称、介绍、启用状态与邮件内容；
- 添加物品、货币或命令附件；
- 回到对应签到类型的奖励总览页，点击“保存全部修改”。
编辑完成后，点击总览页的“保存全部修改”正式生效，否则丢失。
邮件设置与占位符
邮件标题、正文、发件人名称和命令支持以下占位符：
| 占位符 | 内容 |
|---|---|
{player} | 玩家名称 |
{type} | 新人七日签到或回归七日签到 |
{date} | 本次奖励对应的领取日期 |
{day} | 第几天或连续七日 |
SystemMail 在发送前校验奖励内容。请核对其 mail.yml 中的 limits 和 commands.allowed-prefixes：邮件标题、正文及附件数量不能超过相应上限；命令必须符合允许的前缀，校验不通过时会暂停投递。
重新发送暂停奖励
无法自动恢复的邮件请求将暂停，其他错误达到最大尝试次数后也将暂停。管理员排除导致暂停的问题后，可以从服务端日志取得管理用奖励记录 ID，再执行：
重试沿用玩家领取时保存的奖励内容。后来在编辑器中修改奖励，不会改变这条记录；如果原记录的内容无效，单独修改奖励方案无法修复它。