原创 【SuperMail·邮件系统】 1.1.9

插件简介​

• 给所有玩家发送邮件：包括睡眠，在线，和未来新加入您服务器的任何玩家
• 给在线玩家发送邮件：当发送时，只判断当前在线的所有玩家。
• 给指定玩家发送邮件：指定某个玩家，无论他是否在线都可以
• 邮件里支持发放物品，支持玩家点击【领取】时执行控制台指令以便给玩家发放权限
• 支持强制删除邮件，这配合第一条，可以发一些限时福利，活动结束后删除邮件，后来的玩家就领取不到了
• 玩家页面独立，支持玩家手动删除邮件，或清空邮件
• 精美的UI，也可以自定义邮件的背景图
• 当有新邮件时，会在屏幕底部单独弹出一个小UI提示所有玩家（包括新进服的玩家），直到玩家的邮件中没有未读邮件，提示UI才会消失。

1.1.0发送个人邮件（+ 按钮）​

• 权限控制：需要 supermail.player权限，左上角左侧，没权限看不到按钮
  • 
• 内容输入框小技巧：您可以使用“~”符号来另起一行，发送时会自动识别
• 玩家搜索：支持模糊搜索玩家名称
  • 玩家可以在【收件人】直接写入stemaid
  • 考虑到玩家不知道对方ID，也支持输入名字
  • 输入名字支持模糊搜索，并自动弹出玩家选项UI，避免发错玩家
  • 也可以选择输入框旁边的【在线玩家】
  • 
• 物品选择：可从背包和快捷栏选择物品作为附件
  • 自动识别玩家背包和快捷栏物品
  • 选择后物品图标变为绿色，包括物品名称，数量等记录
  • 发送邮件后会从玩家身上扣除选中的物品
  • 

1.1.0发送服务器邮件（MG 按钮）​

• 权限控制：需要 supermail.admin权限，左上角右侧，没权限看不到按钮
  • 
• 内容输入框小技巧：您可以使用“~”符号来另起一行，发送时会自动识别
• 多种发送模式：
  • 发给所有玩家（包括离线玩家和未来新进服的玩家）
  • 发给在线玩家
  • 发给指定玩家（也带模糊搜索功能）
• 
• 物品选择：可从背包和快捷栏选择物品作为附件
  • 和玩家版一样，区别是选择的物品不会扣除
• 收藏夹：点击物品右上角的星标加入收藏
  • 点击货到付款右侧的星标进入收藏夹
  • 可以选择之前收藏的物品，选择数量后，选中物品
  • 可以不通过背包直接在收藏夹选择物品发送附件
  • 支持收藏夹和背包同时选择
• 
• 历史邮件：MG或指令发送的邮件内容右侧可点击星标收藏此邮件
  • 在MG页面点击【历史】按钮进入历史邮件页面
  • 收藏的邮件显示在此页面，包含标题，内容，附件
  • 选中历史邮件会变为绿色背景，并使用相同的标题，内容，附件物品和数量填充到左侧输入框
  • 选择发送的目标，即可可以直接使用历史邮件发送
  • 也支持重新编辑，或添加新的背包物品/收藏夹物品
  • 可以使用此功能编辑一些经常发布的固定内容和固定物品，在MG页面给自己发邮件即可收藏
• 
• 回执功能：
  • MG或指令发送的邮件，会在邮件内容左上角看到【回执】按钮
  • 点击可以查看已读此邮件的玩家列表
  • 点击可以查看已领取此邮件附件的玩家列表
• 
• 服主可以在邮件列表看到【撤销】按钮
  • 撤销按钮仅对服主生效
  • 点击撤销后会删除对应邮件，包括：所有玩家邮件列表中的此邮件，配置文件（如果有），存档数据
  • 只有通过MG页面，或指令发送的官方邮件，才会显示此按钮
  • 

1.1.2交易功能​

• +页面和MG页面都拥有此功能【货到付款】
  • 在UI中，可以现选择右侧物品作为邮件附件物品（选中物品为绿色，代表要送出的物品）
  • 然后勾选右下方的【货到付款】按钮）（选中物品为蓝色，代表要对方回执的物品）
  • 建议先选好要送出的物品，最后在勾选货到付款，选择回执物品
  • 支持选择多个回执物品
  • 
• 对方领取邮件附件时：
  • 需要扣除回传物品，如果背包没有此物品会弹出UI提示
  • 如果满足，会扣除回传物品，并领取成功
  • 扣除的物品会自动发送邮件给对方，交易成功
  • 官方没有也不需回执邮件，正常扣除玩家物品后领取成功
  • 
• 附件到期时间
  • 玩家之间默认48小时，到期后对方未领取，会自动发送邮件退还，到期后领取时也会提示已到期退还
  • 官方没有到期时间，如果需要限时领取，可以手动删除邮件
  • 

1.1.2快捷回信​

• 仅限玩家之间的邮件生效
• 玩家会在邮件右上角看到【回信】按钮
• 点击后自动打开+页面，自动填入对方的ID和标题
• 

1.1.3实体信箱联动​

• 玩家可以摆放信箱后，打开信箱时自动打开邮件页面
• 当有未读邮件时，会在信箱上显示悬浮文字提示
• 悬浮文字仅对真正有未读邮件的玩家可见，没有未读邮件悬浮文字自动消失
• 

数据清理机制​

• 自动清理：当玩家删除邮件时，系统会自动清理对应的存档数据。清理范围：
  • 玩家对玩家邮件（P2P_开头）
  • 系统回执邮件（Receipt_开头）
  • 退回物品邮件（Return_开头）
  • API发送的邮件（API_开头）
  • MG发给个人邮件（MG_PERSONAL_开头）
• 保留数据：官方邮件不会被自动清理，只能通过管理员指令或撤销按钮删除，包括范围：
  • MG_：MG发给所有玩家的邮件
  • MG_ONLINE_：MG发给在线玩家的邮件
  • CMD_ALL_：指令发给所有玩家的邮件
  • CMD_ONLINE_：指令发给在线玩家的邮件
• 清理时机：
  • 单独删除邮件时（点击删除按钮）
  • 清空所有邮件时（一键删除功能）
• 领取按钮显示逻辑：
  • MG页面给在线/所有发物品：管理员随时可以领取，因为也算在在线/所有玩家列表一员
  • MG页面给指定玩家发物品：对方没领取，管理员可以看到领取按钮，对方领取后管理员看不到领取按钮（同步）
  • MG页面给自己发物品：随时可以领取，领取后不再显示领取按钮
  • +页面个人对个人发物品：发送者看不到发出的邮件。对方正常显示

插件授权​

插件指令​

• 指令不写内容：【标题】必须和配置文件里的标题吻合，并且根据配置文件里的标题名和内容以及奖励发送邮件
• 指令写了内容：根据指令里写的内容发送邮件，并且在发送邮件时判断背包里的物品，这意味着写了内容的指令会同时用背包里的物品和数量作为邮件里可以领取的物品。如果不希望领取物品，记得发邮件时背包清空。

配置​

{
  "邮件内容设置": {
    "标题1": {
      "标题": null,
      "内容": "内容",
      "控制台指令": [],
      "奖励物品": [
        {
          "物品ID": -151838493,
          "物品数量": 100,
          "火焰燃料": 0,
          "蓝图目标": 0,
          "弹药数量": 0,
          "弹药类型": 0,
          "数据整数": 0,
          "位置": -1,
          "燃料": 0.0,
          "耐久度": 100.0,
          "最大耐久": 100.0,
          "是否蓝图": false,
          "皮肤ID": 0,
          "物品名称": "",
          "物品文本": null,
          "物品配件": null
        },
        {
          "物品ID": 1776460938,
          "物品数量": 100,
          "火焰燃料": 0,
          "蓝图目标": 0,
          "弹药数量": 0,
          "弹药类型": 0,
          "数据整数": 0,
          "位置": -1,
          "燃料": 0.0,
          "耐久度": 100.0,
          "最大耐久": 100.0,
          "是否蓝图": false,
          "皮肤ID": 0,
          "物品名称": "",
          "物品文本": null,
          "物品配件": null
        },
        {
          "物品ID": -1985799200,
          "物品数量": 100,
          "火焰燃料": 0,
          "蓝图目标": 0,
          "弹药数量": 0,
          "弹药类型": 0,
          "数据整数": 0,
          "位置": -1,
          "燃料": 0.0,
          "耐久度": 100.0,
          "最大耐久": 100.0,
          "是否蓝图": false,
          "皮肤ID": 0,
          "物品名称": "",
          "物品文本": null,
          "物品配件": null
        }
      ],
      "需要扣除的物品": null,
      "发送者": "官方",
      "发送时间": "2025年08月14日 00:35",
      "到期时间": null,
      "是否已退回": false
    }
  },
  "其他设置": {
    "邮件图片": "提示2.png",
    "使用XMNotificationUI调用名称": "",
    "最小偏移": ".67 .05",
    "最大偏移": ".8 .15",
    "打开命令": "u",
    "主UI背景图": "背景111.png",
    "一键已读图片": "已读.png",
    "清空邮件图片": "清空.png",
    "领取图片": "领取.png",
    "删除图片": "删除.png"
  }
}

安装说明​

• 将下载中的文件夹放到data文件夹，以便使用UI背景图
• 提供了默认背景图，提示UI，您需要在配置文件中写入图片的文件名来应用。也可以根据题提供的图片尺寸自行设计新的
• 

插件截图​

视频介绍​