Admin360-Reloaded Manage Real-Time Help Requests! HEX Ratings Statistics - Admin360-Reloaded

💡欢迎使用 Admin360

还在为玩家求助太多、管理员应接不暇而烦恼吗？Admin360 是一款轻量级的实时求助与服务质量管理系统，旨在优化玩家与管理员之间的互动流程。它最初由 Vidhu 于 2013 年发布，新版在原有基础上进行了功能更新、错误修复和质量改进，为各种规模的 Minecraft 社区提供高效的团队协作与激励工具。

✨核心特性

• 开箱即用：安装后即可运行。
• 高度可配置：99% 的内容可通过配置文件自定义，支持 HEX 颜色代码。
• 多数据库支持：兼容 MySQL 和 SQLite。
• 控制台命令触发：可配置执行控制台命令。
• 清晰的配置文件：config.yml 结构清晰，易于理解。

🎮两大核心模块

支持工单系统

此模块让玩家可以在线创建支持请求（工单），管理员则能有序地处理这些请求，确保服务质量。

• 实时队列：新工单遵循“先到先得”原则自动进入待处理队列。
• 状态查询：玩家和管理员均可查询工单状态。
• 组织化通知：相关成员会收到清晰的工单动态通知。
• 信息统计：提供详细的工单处理统计数据。
• 完整管理：支持取消、删除、关闭、转移工单等操作。

荣誉点数系统

此系统通过收集玩家反馈来激励管理员，提升团队参与度与服务积极性。

• 服务评价：玩家可对收到的服务进行“好评”或“差评”。
• 专业统计：管理员可以查看个人及团队的荣誉点数统计。
• 竞争性排行榜：通过荣誉点数排行榜营造良性竞争氛围。

🔧工作流程示例 (v9.2.0)

第一步：创建工单 (玩家操作)

玩家 Amy 使用 /ticket create [详情] 发起求助。她的请求会进入待处理队列。此时，Amy 可以：

• 使用 /ticket cancel 取消自己的工单。
• 使用 /ticket status 查看工单状态。

第二步：领取工单 (管理员操作)

管理员 David 使用 /ticket next 处理队列中的下一个请求（假设是 Amy 的）。该请求会从待处理队列移至处理中列表。David 也可以：

• 使用 /ticket list 查看队列。
• 使用 /ticket select <玩家名> 手动选择特定工单。

第三步：处理工单 (管理员操作)

Admin360 会将 David 传送至 Amy 的位置。请注意，本插件不提供专用聊天频道，管理员需使用服务器现有的交流工具（如 /msg）。此时，David 可以：

• 使用 /ticket tp 传送到玩家身边。
• 使用 /ticket info 查看该工单的详细信息。

第四步：关闭工单 (管理员操作)

处理完毕后，David 使用 /ticket close 关闭工单。该请求会从处理中列表移至待完成列表，等待玩家反馈。David 也可以：

• 使用 /ticket transfer <管理员名> 将工单转交给其他管理员。
• 使用 /ticket drop 丢弃不合理的请求。

第五步：给予反馈 (玩家操作)

系统会提示 Amy 对服务进行评价。如果 Amy 使用 /ticket yes 给予好评：

• 工单将从待完成列表移至数据库，标记为已完成。
• David 会获得 1 点荣誉点数，并在其位置燃放绿色苦力怕烟花以示祝贺。

如果服务不佳，Amy 可以使用 /ticket no 给予差评。

⭐内部机制 (v9.1.0+)

Admin360 使用四个主要阶段（状态）及数据结构来管理请求：

• 待处理：待处理队列存放所有等待处理的请求。
• 处理中：处理中列表存放所有正在被处理的请求。
• 待完成：待完成列表存放所有已关闭、等待玩家评价的请求。
• 已完成：已完成请求不保存在内存中，而是存入数据库，用于统计和历史查询。

**流程说明**

• 创建工单时，请求加入待处理队列。
• 管理员处理时，请求从待处理队列移至处理中列表（状态：待处理 → 处理中）。
• 关闭工单时，请求从处理中列表移至待完成列表（状态：处理中 → 待完成）。
• 收到评价后，请求从待完成列表存入数据库（状态：待完成 → 已完成）。

**重要规则**

• 前三个阶段完全在内存中实时管理。
• 服务器重启或玩家离线时，所有未完成的请求将被作废。
• 拥有 admin360.staff.basic 权限的玩家在加入服务器时，会被添加到管理员列表以接收相关通知。

❓常见问题

这只是一个“普通”的工单插件吗？

不完全是。虽然我们称玩家发起的请求为“工单”，但它更准确地说是一个“实时求助请求”。Admin360 更像是 /helpop 的扩展版，因为它只处理在线玩家的主动请求。本质上，它是一个为繁忙服务器设计的实时请求管理系统，并集成了反馈与统计系统来跟踪团队表现、激励管理员。

我的 config.yml 文件总是重新生成！

这可能是因为 YAML 格式错误。建议使用带有错误检测功能的高级文本编辑器（如 Sublime Text 或 Notepad++）来编辑 .yml 文件，并查看控制台提示的错误行号。

插件支持 MySQL 和 BungeeCord 吗？

• MySQL：支持。
• BungeeCord：不支持。插件无法直接在 BungeeCord 上运行。如果您拥有服务器网络并希望同步数据，可以在每个子服务器上安装插件实例，并让所有实例连接到同一个 MySQL 数据库。

如何编辑数据库文件？

所有数据都存储在数据库（SQLite 或 MySQL）中。

• SQLite：如需重置，删除 .db 文件并重启服务器即可。如需执行 SQL 命令或查询，可以尝试使用 DB Browser for SQLite 工具。

插件支持 UUID 吗？

目前不支持。插件使用区分大小写的玩家名称来存储记录。如果玩家更改了名字并想恢复数据，您需要手动使用数据库工具（如 DB Browser for SQLite）进行转移（提示：使用 UPDATE SQL 命令）。我们期待在未来更新中实现 UUID 支持。

如何设置自定义命令别名？

例如，想将主命令从 /ticket 改为 /request，请按以下步骤操作：

• 找到服务器根目录下的 commands.yml 文件并用文本编辑器打开。
• 参照以下示例编辑并保存：

    command-block-overrides: []
    aliases:
      request:
      - ticket $1-

（`$1-` 表示将新命令的所有参数传递给原命令）

• 重启服务器。

如何在 config.yml 中使用 HEX 颜色代码？

v9.1.0 及以上版本已为 1.16+ 服务器添加了 HEX 颜色支持。格式如下：

"#e69296这是#c8a2c8一条#e69296测试消息。"

🎮命令与权限

通用命令 (无需权限)

• /ticket, /ticket help - 显示命令列表。
• /admin360 help - 显示命令列表。
• /admin360 - 显示 Admin360 插件信息。
• /request, /helpop - /ticket 的命令别名。

玩家命令 (权限节点：admin360.player.*)

• [] 为可选参数，<> 为必填参数。
• /ticket create [详情] - (admin360.player.basic) - 创建新请求。
• /ticket cancel - (admin360.player.basic) - 取消自己的请求。
• /ticket status - (admin360.player.status) - 查询自己的请求状态。
• /ticket stats - (admin360.player.stats) - 查看请求统计。
• /ticket yes - (admin360.player.basic) - 反馈：给服务好评。
• /ticket no - (admin360.player.basic) - 反馈：给服务差评。

管理员命令 (权限节点：admin360.staff.*)

• [] 为可选参数，<> 为必填参数。

第一步：领取请求

• /ticket list - (admin360.staff.basic) - 显示待处理队列中的请求列表。
• /ticket select <玩家名> - (admin360.staff.basic) - 从待处理队列中手动选择一个请求。
• /ticket next - (admin360.staff.basic) - 处理待处理队列中的下一个请求。

第二步：处理请求

• /ticket tp - (admin360.staff.teleport) - 将自己传送到请求者身边。
• /ticket info - (admin360.staff.info) - 获取当前处理的请求详情。
• （请使用其他插件进行交流，如 /msg, /reply 等）

第三步：处理决策

• /ticket transfer <管理员名> - (admin360.staff.transfer) - 将工单转移给其他管理员。
• /ticket drop - (admin360.staff.drop) - 丢弃工单（适用于处理不合理请求）。
• /ticket close - (admin360.staff.basic) - 关闭并标记工单为完成。

请求移除

• /ticket remove <玩家名> - (admin360.staff.remove) - 静默移除目标玩家的所有请求（无论状态）。
• /ticket purge [阶段] - (admin360.staff.purge) - 移除特定阶段的所有请求。

- 可选阶段：`pending` (默认), `attending`, `completing`, `all`

荣誉点数系统

• /ticket hpstats [玩家名] - (admin360.staff.hpstats) - 显示荣誉点数统计。
• /ticket hptop [行数] - (admin360.staff.hptop) - 显示荣誉点数排行榜。
• /ticket history [行数] - (admin360.staff.history) - 打印荣誉点数历史（可视为工单历史）。
• /ticket hpreset <玩家名> - (admin360.staff.hpreset) - 重置目标玩家的所有历史记录。

配置重载

• /admin360 reload - (admin360.staff.reload) - 重载配置文件。

权限重要说明

• 除 OP 外，默认不会将任何权限授予任何用户组。您需要手动将权限节点添加到服务器上合适的权限组中。
• Admin360 会在玩家加入服务器时，将拥有 admin360.staff.basic 权限的玩家注册到管理员列表。如果玩家在线时被授予此权限，需要重新进入服务器才能生效。
• 为防止刷分，拥有 admin360.staff.basic 权限的管理员被硬编码禁止使用 /ticket create 和 /ticket cancel 命令。

🔧运行环境要求

• Java 8 或更高版本。
• 权限插件，推荐 LuckPerms 或 PermissionsEx。
• Spigot 1.8 或更高版本，或其等效分支（如 Paper）。

---

特别鸣谢：感谢 DemocracyCraft 服务器的 Dartanboy 和 Technofied 对本项目的贡献！想体验一个使用 Admin360 提供优质服务的服务器吗？快来试试 DemocracyCraft 吧！

Admin360-Reloaded 插件文档

Admin360-Reloaded 是一款功能强大的服务器管理插件，专为需要高级管理工具和玩家监控的服务器管理员设计。它提供了全面的命令、权限和配置选项，帮助管理员高效地维护服务器秩序与安全。

💡核心功能

• 玩家管理：提供踢出、封禁、禁言、传送等基础管理操作。
• 高级监控：实时查看玩家背包、末影箱、经验值及游戏模式。
• 服务器维护：执行保存、重启、设置时间与天气等服务器级操作。
• 物品与实体管理：生成物品、清理实体、修复玩家物品栏。
• 自定义配置：支持通过配置文件调整消息、权限和插件行为。

🎮命令列表

基础管理命令

• /kick <玩家名> [原因] - 将指定玩家踢出服务器。
• /ban <玩家名> [原因] - 永久封禁指定玩家。
• /tempban <玩家名> <时长> [原因] - 临时封禁玩家（时长示例：1d2h30m）。
• /mute <玩家名> [时长] [原因] - 禁言玩家。
• /tp <玩家名> - 传送到指定玩家位置。
• /tphere <玩家名> - 将指定玩家传送到自己身边。

信息与检查命令

• /invsee <玩家名> - 查看指定玩家的背包。
• /enderchest <玩家名> - 查看指定玩家的末影箱。
• /exp <玩家名> - 查看指定玩家的经验值。
• /gamemode <模式> [玩家名] - 更改玩家游戏模式（survival, creative, adventure, spectator）。

服务器操作命令

• /save-all - 强制保存世界数据。
• /time set <时间|day|night> - 设置世界时间。
• /weather <clear|rain|thunder> - 设置天气。
• /clear <玩家名> - 清空玩家物品栏。
• /repair - 修复手中物品（需有对应权限）。

高级与工具命令

• /give <玩家名> <物品> [数量] - 给予玩家物品。
• /killall <实体类型> - 清除世界中的特定实体（如ZOMBIE, CREEPER）。
• /fly [玩家名] - 启用或禁用飞行模式。
• /vanish - 进入隐身模式（对其他玩家不可见）。
• /admin360 - 显示插件帮助信息。

🔧权限节点

插件的主要权限节点基于命令自动生成，格式通常为 admin360.<命令名>（例如 admin360.kick, admin360.ban）。部分关键权限包括：

• admin360.* - 授予所有插件命令权限（管理员推荐）。
• admin360.invsee - 允许使用 /invsee 命令。
• admin360.mute - 允许使用禁言命令。
• admin360.fly - 允许使用飞行命令。
• admin360.vanish - 允许使用隐身命令。

✨安装与配置

安装步骤

• 确保服务器运行 Spigot 或 Paper（1.13.x 及以上版本）。
• 从发布页面下载最新版本的 Admin360-Reloaded.jar。
• 将 JAR 文件放入服务器的 plugins 文件夹。
• 重启服务器。
• 插件首次运行后，会在 plugins/Admin360-Reloaded/ 目录下生成配置文件。

配置说明

主要的配置文件为 config.yml，你可以在此自定义：

• 插件前缀与消息。
• 默认禁言时长。
• 是否启用特定模块（如封禁系统广播）。
• 数据库连接设置（如果使用 MySQL）。

建议在修改配置后重启服务器或使用 /admin360 reload 命令重载配置。

❓常见问题

• Q: 插件支持哪些 Minecraft 版本？
• A: 支持 1.13.x 及以上的 Spigot/Paper 服务端。建议使用最新稳定版服务端以获得最佳兼容性。

• Q: 如何更新插件？
• A: 下载新版 JAR 文件，替换 plugins 文件夹中的旧文件，然后重启服务器。建议先备份旧配置。

• Q: 封禁信息存储在哪里？
• A: 默认使用本地文件存储（SQLite）。可以在 config.yml 中配置为 MySQL 以实现跨服务器同步。

• Q: 命令没有权限怎么办？
• A: 请确保你的权限组插件（如 LuckPerms）已正确配置 admin360.* 或对应的具体权限节点。

• Q: 如何获取更多帮助？
• A: 请访问插件的 GitHub Wiki 页面或提交 Issue。