跳到主要内容

管理员功能

Assiah 为管理员提供了邮箱审查、系统邮件、群发目标筛选和定时邮件功能。管理命令通常需要 assiah.admin 权限；如果你是在撰写界面里使用群发目标，还需要 assiah.broadcast 权限。

审查玩家邮箱​

/assiah admin inspect <玩家>

在游戏内执行时会打开管理员面板 GUI，展示目标玩家的邮箱统计信息：

  • 收件箱邮件总数
  • 未读邮件数量
  • 回收站邮件数量
  • 归档邮件数量
  • 领取失败的邮件数量

在控制台执行时会以文本形式输出摘要信息。

发送系统邮件​

/assiah admin send system <玩家>

向目标玩家发送一封系统邮件。系统邮件使用管理员配置中的默认标题和正文：

admin:
  console-sender-name: "console"
  console-sender-display-name: "控制台"
  default-system-mail-title: "管理员通知"
  default-system-mail-body: "这是一封由管理员发送的系统邮件。"
  default-admin-display-name: "管理员"

审计日志​

管理员的操作会被记录到审计日志中，包括：

  • 检查玩家邮箱
  • 补发邮件
  • 移动邮件到指定文件夹

审计记录存储在数据库的 assiah_audit 表中。

群发目标选择​

管理员在撰写界面编辑收件人，或使用 /assiah admin broadcast <目标> <标题> <正文> 时，可以直接输入以下目标。前者需要 assiah.broadcast，后者需要 assiah.admin：

目标格式说明
*:on所有在线玩家
*:off所有离线玩家
*:all所有玩家
*:on:<子服名>指定子服当前在线玩家
*:all:<子服名>指定子服全部历史玩家

其中：

  • *:on:<子服名> 依赖 Redis 路由同步，适合群组服实时定向推送
  • *:all:<子服名> 从数据库中的服务器访问记录查询，不依赖 Redis 在线状态
  • *:off:<子服名> 当前并不支持，文档和配置中都不要写成这种格式

更完整的跨服说明见 跨服支持。

定时邮件​

Assiah 1.3.0 新增了 scheduled-mail.yml，你可以把每日奖励、每周公告、节日补偿写成固定任务，插件会按分钟级调度自动投递。

定时邮件支持：

  • cron 周期任务，例如每天 8:00 发签到奖励
  • timestamps 一次性任务，例如节日福利或活动补偿
  • 与普通群发相同的目标选择语法，包括 *:on:<子服名> 与 *:all:<子服名>
  • 货币、物品库、文本、Kether、原始物品五类附件
  • 接收条件、领取条件、过期时间、摘要等高级字段

详细配置和示例请看 定时邮件。

群发物品库物品​

管理员可以在撰写界面的 GUI 中通过"物品库物品"按钮（末影箱图标）添加物品库附件，输入物品源 ID 后系统会预览构建结果。添加完附件后，使用群发目标（*:on / *:off / *:all / *:on:<子服名> / *:all:<子服名>）发送即可。

物品源引用格式为 物品源名称:物品ID，省略物品源名称时默认使用 minecraft 源。完整的物品源列表和引用格式请参考 附件系统 - 可用物品源列表。

重载配置​

/assiah reload

重载所有配置文件（config.yml、mailbox.yml、scheduled-mail.yml、语言文件、UI 配置），并重新启动定时邮件调度器，无需重启服务器。