命令与权限
主命令
命令：/assiah
别名：/mailbox、/ash
权限模型：主命令不再使用统一的 assiah.command 总权限，具体指令按 assiah.command.xxx 拆分授权。
命令列表
| 命令 | 参数 | 说明 | 权限 |
|---|---|---|---|
/assiah | — | 打开邮箱主界面 | assiah.command.main |
/assiah help | — | 显示帮助列表 | assiah.command.help |
/assiah inbox | — | 打开收件箱 | assiah.command.inbox |
/assiah sent | — | 打开已发送 | assiah.command.sent |
/assiah draft | — | 打开草稿箱 | assiah.command.draft |
/assiah trash | — | 打开回收站 | assiah.command.trash |
/assiah archive | — | 打开归档 | assiah.command.archive |
/assiah read | <邮件ID> | 查看指定邮件详情 | assiah.command.read |
/assiah claim | <邮件ID> | 领取指定邮件的附件 | assiah.command.claim |
/assiah compose | [收件人] | 写新邮件（可选预设收件人） | assiah.command.compose |
/assiah reply | <邮件ID> | 回复指定邮件 | assiah.command.reply |
/assiah forward | <邮件ID> | 转发邮件 | assiah.command.forward |
/assiah preference | — | 打开偏好设置 | assiah.command.preference |
/assiah send item | <玩家> | 将主手物品作为附件快捷发送给目标玩家 | assiah.command.send + assiah.command.send.item |
/assiah send text | <玩家> <文本> | 快捷发送文本附件邮件 | assiah.command.send + assiah.command.send.text |
/assiah send kether | <玩家> <Kether语句> | 快捷发送 Kether 脚本附件邮件 | assiah.command.send + assiah.command.send.kether + assiah.admin |
/assiah send currency | <玩家> <货币Key> <数量> | 快捷发送货币附件邮件 | assiah.command.send + assiah.command.send.currency + assiah.admin |
/assiah send source-item | <玩家> <物品源ID> [数量] | 快捷发送物品库附件邮件，数量省略时默认为 1 | assiah.command.send + assiah.command.send.source-item + assiah.admin |
/assiah placeholder | — | 显示 Assiah 内置 PAPI 占位符帮助 | assiah.command.placeholder + assiah.admin |
/assiah reload | — | 重载配置 | assiah.command.reload + assiah.admin |
/assiah admin inspect | <玩家> | 审查目标玩家的邮箱 | assiah.command.admin + assiah.command.admin.inspect + assiah.admin |
/assiah admin send system | <玩家> | 向目标玩家发送系统邮件 | assiah.command.admin + assiah.command.admin.send + assiah.command.admin.send.system + assiah.admin |
/assiah admin broadcast | <目标> <标题> <正文> | 群发邮件 | assiah.command.admin + assiah.command.admin.broadcast + assiah.admin |
/assiah template list | [页码] | 查看个人和全局模板列表 | assiah.command.template + assiah.command.template.list |
/assiah template delete | <模板ID> | 删除自己的模板 | assiah.command.template + assiah.command.template.delete |
/assiah template rename | <模板ID> <新名称> | 重命名自己的模板 | assiah.command.template + assiah.command.template.rename |
/assiah admin template list | [页码] | 查看所有模板（含归属信息） | assiah.command.admin + assiah.command.admin.template + assiah.command.admin.template.list + assiah.admin |
/assiah admin template delete | <模板ID> | 强制删除任意模板 | assiah.command.admin + assiah.command.admin.template + assiah.command.admin.template.delete + assiah.admin |
/assiah admin template set-global | <模板ID> | 将个人模板提升为全局模板 | assiah.command.admin + assiah.command.admin.template + assiah.command.admin.template.set-global + assiah.admin |
权限节点
玩家命令权限
| 权限 | 说明 | 默认建议 |
|---|---|---|
assiah.command.main | 打开邮箱主界面 | 所有玩家 |
assiah.command.help | 查看命令帮助 | 所有玩家 |
assiah.command.inbox | 打开收件箱 | 所有玩家 |
assiah.command.sent | 打开已发送 | 所有玩家 |
assiah.command.draft | 打开草稿箱 | 所有玩家 |
assiah.command.trash | 打开回收站 | 所有玩家 |
assiah.command.archive | 打开归档 | 所有玩家 |
assiah.command.read | 查看邮件详情 | 所有玩家 |
assiah.command.claim | 领取邮件附件 | 所有玩家 |
assiah.command.compose | 撰写邮件 | 所有玩家 |
assiah.command.reply | 回复邮件 | 所有玩家 |
assiah.command.forward | 转发邮件 | 所有玩家 |
assiah.command.preference | 修改邮箱偏好 | 所有玩家 |
assiah.command.template | 使用模板命令父节点 | 所有玩家 |
assiah.command.template.list | 查看模板列表 | 所有玩家 |
assiah.command.template.delete | 删除自己的模板 | 所有玩家 |
assiah.command.template.rename | 重命名自己的模板 | 所有玩家 |
assiah.command.send | 使用快捷发送父节点 | 按需 |
assiah.command.send.item | 快捷发送主手物品 | 按需 |
assiah.command.send.text | 快捷发送文本附件 | 按需 |
管理命令权限
| 权限 | 说明 | 默认建议 |
|---|---|---|
assiah.command.send.kether | 快捷发送 Kether 附件，仍需 assiah.admin | OP |
assiah.command.send.currency | 快捷发送货币附件，仍需 assiah.admin | OP |
assiah.command.send.source-item | 快捷发送物品库附件，仍需 assiah.admin | OP |
assiah.command.placeholder | 查看 PAPI 占位符帮助，仍需 assiah.admin | OP |
assiah.command.reload | 重载配置，仍需 assiah.admin | OP |
assiah.command.admin | 使用管理员命令父节点，仍需 assiah.admin | OP |
assiah.command.admin.inspect | 审查玩家邮箱，仍需 assiah.admin | OP |
assiah.command.admin.send | 使用管理员发送父节点，仍需 assiah.admin | OP |
assiah.command.admin.send.system | 发送系统邮件，仍需 assiah.admin | OP |
assiah.command.admin.broadcast | 管理员命令群发邮件，仍需 assiah.admin | OP |
assiah.command.admin.template | 使用管理员模板父节点，仍需 assiah.admin | OP |
assiah.command.admin.template.list | 查看所有模板，仍需 assiah.admin | OP |
assiah.command.admin.template.delete | 强制删除任意模板，仍需 assiah.admin | OP |
assiah.command.admin.template.set-global | 将模板提升为全局模板，仍需 assiah.admin | OP |
业务权限
| 权限 | 说明 | 默认建议 |
|---|---|---|
assiah.admin | 管理员身份边界，用于管理员命令、管理员快捷发送和管理员 GUI 功能 | OP |
assiah.template.save | 保存草稿为模板 | 所有玩家 |
assiah.template.save.attachment | 保存模板时包含附件 | OP |
assiah.template.global | 管理全局模板 | OP |
assiah.broadcast | 在撰写界面使用群发目标 | OP |
assiah.vip | 主菜单 VIP 写信按钮显示条件，不控制核心业务 | 按需 |
assiah.test | 测试命令 /assiah-test | 测试服 OP |
使用示例
# 打开邮箱
/assiah
# 直接打开收件箱
/mailbox inbox
# 给玩家 Steve 写一封邮件
/ash compose Steve
# 回复一封邮件
/assiah reply abc123
# 领取邮件附件
/assiah claim abc123
# 快捷发送主手物品给 Steve
/assiah send item Steve
# 快捷发送文本附件
/assiah send text Steve 请查收这份说明
# 管理员快捷发送 Kether 脚本附件
/assiah send kether Steve tell "&a奖励已发放"
# 管理员快捷发送货币附件
/assiah send currency Steve vault 1000
# 管理员快捷发送物品库附件，数量省略时默认为 1
/assiah send source-item Steve mm:legendary_sword 1
# 查看 Assiah 内置 PAPI 占位符帮助
/assiah placeholder
# 管理员查看玩家邮箱
/assiah admin inspect Steve
# 管理员发送系统邮件
/assiah admin send system Steve
# 管理员群发邮件给所有在线玩家
/assiah admin broadcast *:on 服务器公告 今晚22点停服维护
# 管理员群发邮件给所有玩家（在线+离线）
/assiah admin broadcast *:all 活动通知 双倍经验活动开启
# 管理员群发邮件给 survival 子服在线玩家（需要 Redis 路由）
/assiah admin broadcast *:on:survival 周末活动 生存服活动已开始
# 管理员群发邮件给 survival 子服全部历史玩家
/assiah admin broadcast *:all:survival 回流奖励 登录即可领取回流礼包
# 重载配置
/assiah reload
# 查看模板列表
/assiah template list
# 删除模板
/assiah template delete abc123
# 管理员将模板设为全局
/assiah admin template set-global abc123
快捷发送说明
/assiah send 用于快速生成一封只带单个附件的邮件，适合临时补发奖励、测试附件或不想打开撰写 GUI 的场景。
| 子命令 | 用法 | 说明 |
|---|---|---|
item | /assiah send item <玩家> | 发送主手物品；发送失败时物品会退回背包，背包满时掉落到脚下 |
text | /assiah send text <玩家> <文本> | 发送一份文本附件；文本不能为空，也会经过内容过滤检查 |
kether | /assiah send kether <玩家> <Kether语句> | 发送 Kether 脚本附件，需要 assiah.command.send.kether 与 assiah.admin |
currency | /assiah send currency <玩家> <货币Key> <数量> | 发送货币附件，需要 assiah.command.send.currency 与 assiah.admin；货币 Key 对应 currency.yml |
source-item | /assiah send source-item <玩家> <物品源ID> [数量] | 发送物品库附件，需要 assiah.command.send.source-item 与 assiah.admin；数量省略时默认为 1 |
快捷发送邮件的默认标题、正文和附件显示名来自 mailbox.yml 的 command-send 配置段。你可以在那里分别调整物品、文本、Kether、货币、物品库附件的默认展示文本。
信息
/assiah send text 和 /assiah send kether 的最后一个参数会接收剩余整段输入，因此可以直接输入带空格的文本或脚本内容。
群发目标说明
/assiah admin broadcast 的 <目标> 参数支持以下格式：
| 目标 | 说明 |
|---|---|
*:on | 所有在线玩家 |
*:off | 所有离线玩家 |
*:all | 所有玩家（在线 + 离线） |
*:on:<子服名> | 指定子服当前在线玩家（需要 Redis 路由同步） |
*:all:<子服名> | 指定子服全部历史玩家（从数据库记录查询） |
玩家名 | 单个指定玩家 |
群发邮件默认跳过发送者速率限制，收件人数量受 mailbox.yml 中 max-batch-send-size 配置限制。
在撰写界面点击“收件人”后，管理员也可以输入同样的目标格式，直接把草稿切换成群发模式。
信息
*:off:<子服名> 目前并不存在对应语法。按子服筛选只支持 *:on:<子服名> 和 *:all:<子服名> 两种格式。