HN 系列 Wiki

主题

这页按 当前实现 汇总 HNMail 已可使用的命令入口与管理入口。

玩家命令：/mail ​

/mail ​

打开收件箱 GUI。

text
/mail

用途：

  • 查看收件箱
  • 打开邮件详情
  • 在 GUI 里领取附件
  • 删除邮件

/mail unread ​

查看未读邮件数量。

text
/mail unread

/mail send ​

发送一封基础纯文本邮件。

text
/mail send <玩家> <标题>|<正文>

例如：

text
/mail send Steve 问候|你好，欢迎查看你的第一封邮件

说明：

  • 当前版本只有这种直接发送格式
  • 没有聊天会话式 compose / draft / cancel 流程

/mail claim ​

领取某封邮件的附件。

text
/mail claim <邮件ID>

支持的附件类型取决于当前配置与依赖：

  • ITEM
  • MONEY
  • COMMAND

/mail settings ​

查看或切换自己的来信设置。

text
/mail settings
/mail settings status
/mail settings on
/mail settings off
/mail settings toggle

用途：

  • 允许玩家来信
  • 拒收玩家来信
  • 查看当前状态

/mail block ​

拉黑某位玩家，阻止其给你发信。

text
/mail block <玩家>

/mail unblock ​

取消拉黑某位玩家。

text
/mail unblock <玩家>

管理命令：/hnmail ​

主命令别名：

text
/hnmail
/hnm

基础管理 ​

/hnmail reload ​

text
/hnmail reload

重载配置、模板与消息文件。

/hnmail cleanup ​

text
/hnmail cleanup

立即执行一次后台清理任务。

通常会涉及：

  • 过期邮件清理
  • 已删除邮件彻底清理
  • 附件 / 审计关联清理
  • 广播任务日志清理

管理发信与奖励投递 ​

/hnmail senditem ​

text
/hnmail senditem <玩家> <标题>|<正文>
/hnmail senditem <玩家> <标题>|<正文> consume

将管理员主手物品作为邮件附件发送给目标玩家。

consume ​

如果带这个参数，发送成功后会扣除主手物品。

/hnmail sendlibitem ​

text
/hnmail sendlibitem <玩家> <source:itemId> [数量] -- <标题>|<正文>

从 HNCore 统一物品库网关 解析外部物品，并作为邮件附件发送给目标玩家。

当前实现里，命令补全会优先提示这些已知来源前缀：

  • baikiruto:<itemId>
  • bi:<itemId>
  • mm:<itemId>
  • mythic:<itemId>
  • neige:<itemId>
  • ni:<itemId>

例子：

text
/hnmail sendlibitem Steve mythic:example_sword 1 -- Mythic奖励|请查收这把物品库武器
/hnmail sendlibitem Steve mm:example_sword 1 -- Mythic奖励|使用别名来源发送
/hnmail sendlibitem Steve neige:example_item 1 -- Neige奖励|请查收这件 NeigeItems 物品
/hnmail sendlibitem Steve ni:example_item 1 -- Neige奖励|使用别名来源发送

说明：

  • 该命令不会改动现有 /hnmail senditem 的主手发送行为
  • source 会先交给 HNCore 统一物品库网关处理，必要时会归一化到 canonical source
  • 因此有些来源别名可能不会出现在补全中，但手动输入后仍然可能可用
  • 如果 HNCore 统一物品库网关不可用、来源不可用、itemId 不存在、数量非法，命令会返回明确错误原因
  • 若解析结果是不支持序列化的唯一堆叠物品，当前实现会拒绝发送

/hnmail sendmoney ​

text
/hnmail sendmoney <玩家> <货币> <金额> <标题>|<正文>

发送带金币附件的邮件。

前提：

  • 已安装 HNEconomy
  • allow-money-attachment: true

/hnmail sendcommand ​

text
/hnmail sendcommand <玩家> <标题>|<正文> -- <命令...>

发送带命令附件的邮件。

例子：

text
/hnmail sendcommand Steve VIP奖励|请查收你的权限奖励 -- lp user {player} parent add vip

前提：

  • allow-command-attachment: true

模板、群发与广播日志 ​

/hnmail sendtemplate ​

text
/hnmail sendtemplate <玩家> <模板>

发送模板邮件给单个玩家。

模板可以包含：

  • 标题
  • 正文
  • 模板附件（money / command）

/hnmail sendtemplateall ​

text
/hnmail sendtemplateall <模板>
/hnmail sendtemplateall <模板> online

两种模式 ​

  • 不带第二参数：对玩家目录中的全部玩家执行离线群发
  • 带 online：只对在线玩家发送

发送后会生成任务 ID，并写入广播日志。

广播日志与检查 ​

/hnmail broadcastlog ​

text
/hnmail broadcastlog
/hnmail broadcastlog list
/hnmail broadcastlog list running
/hnmail broadcastlog list failed
/hnmail broadcastlog list template <模板>
/hnmail broadcastlog list completed template <模板> 2
/hnmail broadcastlog <任务ID>
/hnmail broadcastlog <任务ID> <页码>

用途：

  • 查看最近群发任务列表
  • 按状态筛选任务
  • 按模板筛选任务
  • 查看单个任务详情与失败明细

当前可用状态筛选：

  • all
  • running
  • completed
  • failed

/hnmail attachmentaudit ​

text
/hnmail attachmentaudit serial <序列号> [all|claimed|unclaimed] [页码]
/hnmail attachmentaudit itemtype <物品类型> [all|claimed|unclaimed] [页码]
/hnmail attachmentaudit type <物品类型> [all|claimed|unclaimed] [页码]

按附件序列号或物品类型查询附件审计记录。

用途：

  • 追查某个附件序列号流向
  • 查询某类物品附件是否已被领取
  • 核对某批奖励邮件的附件状态
  • 辅助排查重复领取、未领取、投递异常等问题

说明：

  • serial：按附件唯一序列号查询
  • itemtype / type：按物品类型查询，type 是兼容别名
  • 领取状态筛选支持：
    • all
    • claimed
    • unclaimed
  • 页码从 1 开始

当前版本没有的命令 ​

为了避免对照旧文档时混淆，这里特别说明：

当前版本 没有 这些命令：

  • /mail compose
  • /mail draft
  • /mail cancel
  • /hnmail admin
  • /hnmail sendtemplategui
  • /hnmail inspect
  • /hnmail inspectgui
  • /hnmail maillog

如果你看到旧资料提到这些入口，请以本页为准。

最建议的新手命令起手顺序 ​

如果你第一次接触 HNMail，不建议一上来就先摸群发和命令附件。

建议顺序：

  1. /mail send
  2. /mail
  3. /mail unread
  4. /mail claim
  5. /mail settings
  6. /mail block
  7. /hnmail senditem
  8. /hnmail sendlibitem
  9. /hnmail sendtemplate
  10. /hnmail sendtemplateall
  11. /hnmail broadcastlog
  12. /hnmail attachmentaudit

权限节点 ​

当前插件声明的管理权限有：

  • hnmail.command.reload
  • hnmail.command.senditem
  • hnmail.command.sendlibitem
  • hnmail.command.sendmoney
  • hnmail.command.sendcommand
  • hnmail.command.sendtemplate
  • hnmail.command.sendtemplateall
  • hnmail.command.broadcastlog
  • hnmail.command.cleanup
  • hnmail.command.attachmentaudit

默认都是 op。

建议联动阅读 ​

HN 系列插件文档

Copyright © 2024