ZAdmin

插件

· 作者 ZarOfficial

一款管理员辅助插件,帮助你冻结玩家、隐身以及更多功能!

0 本站下载 0 关注 更新于 4 个月前

最新 1.1.0 · 1.21.11 · Paper / Spigot

一键开服(送7天)

ZAdmin

适用于 Paper 1.21.x 服务器的现代化、模块化、高性能游戏内管理平台。

ZAdmin 是一个独立的管理面板,可在任何 Paper 服务器上开箱即用,无需依赖任何私有或第三方插件。每个主要功能都是独立的模块,可以在运行时启用、禁用和重载;清晰的公共 API 允许其他开发者扩展面板,且 ZAdmin 永远不会依赖他们的插件。


功能

区域 获得的功能
仪表盘 一个可配置的库存 GUI 枢纽(/admin),支持 MiniMessage 文本、可配置的图标/槽位、音效、装饰边框和分页。
玩家管理 在线玩家列表 → 玩家检查器,显示用户名、UUID、延迟、生命值、饥饿值、饱和度、经验值、游戏模式、世界、坐标、旋转角度、余额(Vault)、前缀/后缀 & 组(LuckPerms),以及可选的 IP 地址。
玩家操作 传送、治疗、喂食、清空物品栏、查看物品栏 / 末影箱、冻结、上帝模式、隐身、踢出、封禁、警告、静音、发送消息、员工备注、账号检测、物品快照、复制 UUID。
物品快照 破坏性操作(例如清空物品栏)会先捕获一个可恢复的快照。浏览玩家的快照历史,点击右键即可一键回滚。
账号检测 可选择标记共享最后已知 IP 的账号。默认关闭(存储/比较 IP —— 这是一个涉及隐私的功能)。
聊天过滤 可选的反垃圾邮件(速率限制 + 重复抑制)和正则表达式单词/链接黑名单,违规升级可配置。拥有 zadmin.chat.bypass 权限者可绕过。
处罚升级 可配置的阶梯式处罚(例如:警告 → 静音:1小时 → 封禁:7天 → 永久封禁),根据违规次数应用,并附带一键原因预设。
跨服务器同步 通过共享的 MySQL/MariaDB 数据存储,在网络中传播封禁/静音和员工广播。默认关闭;对 SQLite 无影响。
指标统计 通过 bStats 收集匿名聚合使用统计数据。尊重 ZAdmin 的 metrics.enabled 设置以及全局 bStats 退出选项。
冻结系统 被冻结的玩家无法移动、破坏/放置方块、攻击、交互、掉落物品或(可选地)执行命令。如果冻结的玩家断开连接,员工将收到警报。
员工备注 支持无限数量的玩家备注,包含分类/标题/内容,支持分页、添加和删除,基于数据库存储。
举报 待处理 / 已认领 / 已关闭队列,支持认领、关闭、传送至目标玩家和历史记录查看。
处罚记录 警告、踢出、静音、临时静音、封禁、临时封禁、黑名单 —— 包含历史记录、持续时间、永久存储以及在 GUI 中撤销的功能。
经济监控 跟踪存款/取款,标记可疑(大额)交易,提供筛选和历史记录。在没有 Vault 的情况下优雅禁用。
日志记录 异步、批处理的审计日志,涵盖命令、加入/离开、处罚、经济、传送、员工操作、死亡等更多数据 —— 支持类别筛选、分页和导出。
调度器 用于广播、命令、保存、备份和重启的 GUI 编辑器,支持按间隔或每日/每周/每月计划执行。
开发者工具 插件列表及版本、世界/区块检查器、性能监控器(TPS/MSPT/RAM/线程)、占位符测试器、PDC/元数据/权限检查器。不涉及 NMS。
服务器仪表盘 实时 TPS、MSPT、RAM、CPU 负载、世界、区块、实体、方块实体、玩家、插件 —— 自动刷新。
模块管理 在运行时启用/禁用/重载所有功能;状态持久化到配置文件。
通知 游戏内弹窗(TPS 下降、新举报、冻结玩家离线、备份完成、处罚),支持可配置的音效,并提供外部提供商的 API。
挂钩集成 自动检测 Vault、PlaceholderAPI、LuckPerms 和 Geyser/Floodgate;缺失的插件只会禁用其相关功能,不会产生错误。

要求

  • Java 21+
  • Paper 1.21.x(仅使用 Bukkit Inventory API —— 无外部 GUI 框架)

可选软依赖:Vault、PlaceholderAPI、LuckPerms、Geyser/Floodgate。


命令与权限

命令 别名 描述
/admin /zadmin, /adm 打开仪表盘
/admin reload 重载配置和模块 (zadmin.settings.edit)
/admin module <enable|disable|list> [id] 管理模块 (zadmin.modules.manage)
/admin backup 运行手动备份 (zadmin.settings.edit)
/admin version 显示版本

基础权限:zadmin.use。每个操作都有各自的权限节点(例如 zadmin.player.freeze、zadmin.reports.claim、zadmin.logs.export、zadmin.developer.view)。授予 zadmin.* 可获得完全访问权限。完整列表请参阅 plugin.yml。


配置

所有文件位于 plugins/ZAdmin/ 目录下,并通过 /admin reload 热重载:

  • config.yml — 行为开关、日志、经济、通知、冻结、备份、聊天过滤、升级策略、账号检测、跨服务器同步、指标统计、模块标志
  • messages.yml — 所有面向用户的字符串(MiniMessage 格式)
  • gui.yml — 仪表盘图标、槽位、名称和描述
  • database.yml — SQLite(默认)或 MySQL/MariaDB 连接配置

数据库

SQLite 是默认选项,无需额外设置。对于 MySQL/MariaDB,请在 database.yml 中设置 type: mysql 并填写连接详情。所有数据库访问均为异步进行,并通过 HikariCP 进行连接池管理;服务器线程绝不会因 I/O 操作而被阻塞。


公共 API

ZAdmin 提供了一个稳定的、通用的 API —— 它不包含对任何特定插件的引用。

在你的 plugin.yml 中将 ZAdmin 添加为 softdepend,然后:

import com.zadmin.api.*;
import com.zadmin.gui.Button;
import com.zadmin.util.ItemBuilder;
import org.bukkit.Material;

ZAdminProvider api = ZAdminAPI.get();

```java
// 1. 向仪表盘添加一个按钮
api.registerDashboardButton(DashboardButton.of(31, "myplugin.use",
        Button.of(ItemBuilder.of(Material.NETHER_STAR).name("<gold>My Feature").build(),
                ctx -> ctx.player().performCommand("myplugin open"))));

// 2. 向玩家检查器添加一个标签页
api.registerPlayerInspectorTab(new PlayerInspectorTab() {
    public String id() { return "myplugin_homes"; }
    public String permission() { return "myplugin.homes"; }
    public Button build(Player viewer, UUID target) {
        return Button.of(ItemBuilder.of(Material.RED_BED).name("<aqua>Homes").build(),
                ctx -> { /* 为目标打开你的家园 GUI */ });
    }
});

// 3. 注册一个命名操作
api.registerAction(new AdminAction() {
    public String id() { return "myplugin:reset"; }
    public String permission() { return "myplugin.reset"; }
    public void execute(Player staff, UUID target) { /* ... */ }
});

// 4. 注册模块(由 ZAdmin 启用/禁用/重新加载)
api.registerModule(myModule);

// 5. 接收通知(转发到 Discord、Web 面板等)
api.registerNotificationProvider(n ->
        getLogger().info("[" + n.severity() + "] " + n.type() + ": " + n.title()));

建议从您自己的 onEnable(或更晚阶段)访问 API,以确保其可用性。使用 ZAdminAPI.isAvailable() / ZAdminAPI.getOrNull() 进行空安全访问。该 API 也通过 Bukkit 的 ServicesManager 注册为 com.zadmin.api.ZAdminProvider。

PlaceholderAPI

当安装 PlaceholderAPI 时,ZAdmin 会注册 zadmin 扩展: %zadmin_tps%、%zadmin_mspt%、%zadmin_memory_used%、%zadmin_memory_max%、 %zadmin_frozen%、%zadmin_vanished%、%zadmin_god%、%zadmin_muted%。


架构

com.zadmin
├── api          公共扩展点(通用、插件无关)
├── command      /admin 命令及 Tab 补全
├── config       YAML 加载、消息服务
├── database     数据库抽象(SQLite / MySQL via HikariCP)、模式
├── gui          菜单框架(仅 Bukkit Inventory API)+ 内置菜单
├── hook         软集成(Vault、PlaceholderAPI、LuckPerms、Floodgate)
├── listener     全局事件监听器(连接、冻结、状态、经济)
├── model        不可变领域记录 + 枚举
├── module       模块框架 + 内置模块
├── placeholder  PlaceholderAPI 扩展
├── scheduler    异步任务执行器(主线程封送)
├── service      业务逻辑(异步、缓存、线程安全)
├── storage      DAOs(纯 JDBC、异步安全)
└── util         文本/MiniMessage、ItemBuilder、TimeUtil、冷却时间

设计原则: SOLID、显式组合根(ZAdminPlugin 中的依赖注入)、 无重复逻辑、线程安全的服务、完全异步的数据库与日志、智能 缓存,以及在禁用时彻底清理资源。旨在舒适地支持 300+ 并发玩家。


隐私

有两个功能因处理玩家 IP 地址而默认禁用:

  • 小号检测 (alt-detection.enabled) 存储并比较玩家的最后已知 IP。
  • 跨服务器同步 (sync.enabled) 在共用数据库上共享惩罚数据。

如果您启用了它们,您需要负责向玩家披露此做法,并遵守适用的数据保护法(例如 GDPR)。除非单独启用了 player.show-ip,否则 ZAdmin 不会通过小号检测 UI 显示原始 IP(仅显示结果账号名)。

匿名使用指标默认发送至 bStats。若要退出,请在 config.yml 中设置 metrics.enabled: false,或在 plugins/bStats/config.yml 中全局禁用 bStats。


许可证

公开发布供使用。欢迎署名。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源