原创 闭源 工具 RomanAdminMailbox——一款有点好用的服主邮箱插件 1.0.0

RomanAdminMailbox 为服务器提供管理员邮箱系统。玩家可以通过这个系统向管理员提交问题、建议和反馈，管理员可以方便地查看、处理这些问题，并给玩家发放奖励。

---

​

​

玩家教程​

使用/ramb 打开服主邮箱

界面说明​

问题列表界面（6行 × 9列）
┌────────────────────────────────────────────────────────┐
│ [全部] [开放] [处理中] [已解决] [已关闭] [已拒绝] [刷新] [提交] │ ← 第一行：筛选和操作按钮
├────────────────────────────────────────────────────────┤
│ [#1 服务器卡顿] [#2 物品丢失] [#3 ...] │ ← 问题列表（4行 × 7个）
│ ... │
├────────────────────────────────────────────────────────┤
│ [上一页] [第 1/3 页] [下一页] [管理面板] │ ← 最后一行：导航按钮
└────────────────────────────────────────────────────────┘
颜色含义：
绿色-开放中-等待处理的新问题
黄色-处理中-管理员正在处理
蓝色-已解决-问题已解决
灰色-已关闭-问题已关闭
红色-已拒绝-问题被拒绝

提交问题​

提示：每位玩家最多只能同时存在 10 个开放中的问题。

点击展开...

查看问题详情​

添加评论​

评论最大长度为 1000 字符。超时为 60 秒。

点击展开...

关闭自己的Issue​

如果你的问题已经解决，或者你想取消一个问题：

1. 打开问题详情
2. 点击 【关闭Issue】 按钮（铁门图标）
3. 确认关闭

注意：只有问题的提交者本人才能关闭，且只能关闭 "开放中" 或 "处理中" 的问题。

点击展开...

---

管理员教程​

打开管理面板​

处理问题​

作为管理员，你可以对所有问题进行操作：

1. 在问题列表中点击任意问题打开详情
2. 你会看到比普通玩家更多的操作按钮

更改状态​

发放奖励​

你可以给提交问题的玩家发放奖励：

1. 打开问题详情
2. 点击 【发奖励】 按钮（金锭图标）
3. 在奖励配置界面：
   
   • 确认目标玩家（默认是提交者）
   • 点击 【添加命令】 添加奖励命令
   • 在聊天框输入命令（例如：give {player} diamond 10）
   • 可以添加多条命令
4. 点击 【确认发布】 发放奖励

命令模板示例：

​

• give {player} diamond 10 → 给玩家 10 个钻石
• eco give {player} 1000 → 给玩家 1000 金币
• xp give {player} 100 levels → 给玩家 100 级经验

{player} 会自动替换为目标玩家的名字。

点击展开...

安全提示：禁止使用 stop、op、deop 等危险命令。

点击展开...

删除Issue​

如果某个问题不符合规范或包含不当内容：

1. 打开问题详情
2. 点击 【删除】 按钮（屏障图标）
3. 问题会被标记为删除（软删除，数据仍然保留在数据库中）

---

命令参考​

玩家命令​

权限节点​

romanmailbox.use | true (所有人) | 允许使用邮箱功能 |
romanmailbox.admin`| op (仅OP) | 允许打开管理面板和操作所有功能 |

---

配置详解​

配置文件路径：plugins/RomanAdminMailbox/config.yml

数据库配置​

database:
host: localhost # MySQL 服务器地址
port: 3306 # MySQL 端口
name: romanmailbox # 数据库名称
user: root # 数据库用户名
password: '' # 数据库密码
pool-size: 10 # 连接池大小
connection-timeout-ms: 5000 # 连接超时（毫秒）
leak-detection-ms: 60000 # 连接泄漏检测（毫秒）

UI 模式配置​

ui:
mode: auto # UI 模式：auto（自动）/ vanilla（原版）/ arcartx
issues-per-page: 20 # 每页显示问题数量
refresh-debounce-ms: 500 # 刷新防抖时间（毫秒）
vanilla:
use-player-skulls: true # 评论是否使用玩家头颅
comment-lore-max-lines: 8 # 评论 Lore 最大行数
description-via-book: true # 描述是否通过书本展示
input-timeout-seconds: 60 # 输入超时时间（秒）

限制配置​

limits:
max-issues-per-player-open: 10 # 每位玩家最多开放问题数（0=无限制）
title-max-length: 64 # 标题最大长度
description-max-length: 2000 # 描述最大长度
comment-max-length: 1000 # 评论最大长度

通知配置​

notifications:
notify-all-admins: true # 是否通知所有管理员
chat-prefix: '&7[&6邮箱&7]' # 聊天消息前缀
actionbar-duration-ticks: 60 # ActionBar 显示时长（tick）

状态显示配置​

status-display:
OPEN: '&a开放中'
IN_PROGRESS: '&e处理中'
RESOLVED: '&b已解决'
CLOSED: '&7已关闭'
REJECTED: '&c已拒绝'
你可以修改这些颜色代码来自定义状态显示。

奖励命令黑名单​

reward-command-blacklist:
- 'stop'
- 'op'
- 'deop'
- 'pardon'
- 'whitelist'
这些命令禁止在奖励中使用，防止管理员误操作。

---

常见问题 FAQ​

一般问题​

Q: 玩家没有安装 ArcartX mod 能使用吗？

可以！插件支持原版UI模式，不需要安装任何客户端mod。

点击展开...

Q: 如何切换 UI 模式？

在 config.yml 中修改 ui.mode：

​

• auto - 自动检测
• vanilla - 强制原版UI
• arcartx - 强制 ArcartX UI

点击展开...

Q: 插件支持哪些 Minecraft 版本？

目前支持 Paper 1.21.8 或更高版本。

点击展开...

使用问题​

Q: 为什么无法提交问题？

检查是否已达到最大开放问题数限制（默认10个）。关闭一些旧问题后再试。

点击展开...

Q: 评论超时了怎么办？

默认超时时间为 60 秒。你可以在配置中修改 ui.vanilla.input-timeout-seconds。

点击展开...

Q: 如何查看完整的问题描述？

在问题详情界面，点击右上角的 【查看描述】 按钮（书本图标）。

点击展开...

管理问题​

Q: 如何成为管理员？

需要拥有 romanmailbox.admin 权限。默认情况下只有 OP 玩家拥有此权限。

点击展开...

Q: 奖励命令支持哪些变量？

支持 {player} 变量，会自动替换为目标玩家的名字。

点击展开...

Q: 为什么有些命令不能用于奖励？

为了保护服务器安全，以下命令被禁止：stop、op、deop、pardon、whitelist。你可以在配置中添加更多黑名单命令。

点击展开...

技术问题​

Q: 数据库连接失败怎么办？

检查以下几点：

​

1. MySQL 服务是否运行
2. 配置文件中的 host、port、user、password 是否正确
3. 数据库用户是否有创建数据库的权限
4. 防火墙是否允许连接

点击展开...

Q: 插件启动时显示 "ArcartX not found"？

如果你使用原版UI模式，这是正常的提示信息。如果你需要 ArcartX UI，请安装 ArcartX 服务端插件。

点击展开...