Zenith-Mod

插件

· 作者 kzlyth

高级管理插件,具备封禁/静音系统、升级模板、离线支持和 Web-API 集成,适用于专业服务器管理。

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

最新 1.2.7 · 26.1.2 · Bukkit / Folia

一键开服(送7天)

Zenith-Mod - 专业管理插件

缺少什么功能?

你觉得这个插件缺少了什么吗?在我们的 Discord 上提交一个工单,我们会尽快实现它!

这是一款专为现代 Paper 服务器构建的全面管理插件。Zenith-Mod 为你提供有效管理团队所需的一切功能,重点在于性能和可靠性。

核心功能

完整的管理套件

封禁系统 - 完整的封禁管理,支持 IP 封禁、临时和永久封禁、自动升级以及模板支持。无论玩家是否在线均可执行封禁。

静音系统 - 聊天静音并支持命令屏蔽。同样适用于离线玩家,你可以在他们加入之前就将其静音。包括基于 IP 的静音和自动升级功能。

警告系统 - 跟踪警告记录,支持升级级别和可自定义的阈值。一目了然地查看玩家的警告历史。

冻结系统 - 将玩家固定在原地并限制其移动。非常适合调查或防止破坏者逃脱。

踢出系统 - 增强的踢出功能,支持自定义理由和工作人员通知。

自动 Moderation (AutoMod) - AutoMod 系统自动监控聊天,并移除违反你服务器规则的消息——无需人工干预。 词过滤系统自动检测并删除包含黑名单词汇的消息。得益于内置的 Leetspeak(黑客语)规范化功能,像 1d10t, i.d.i.o.t 或 @ssh0le 这样的绕过尝试会被自动捕获——你只需在列表中添加基础词汇即可。 反垃圾邮件检测两种类型的垃圾信息:玩家反复发送相同消息(重复检测)以及玩家在短时间内向聊天发送过多消息(洪水检测)。两个阈值均可完全配置。 当消息被拦截时,玩家会收到通知,并且拥有 alert 权限的工作人员会在游戏中立即收到警报。警报也会以嵌入消息的形式发送到可配置的 Discord 频道。工作人员可以使用 /automod alerts 命令自行开启或关闭警报。

封禁列表 GUI - 封禁列表 GUI 为你的工作人员提供服务器上所有封禁(包括活跃和非活跃)的清晰概览——直接在游戏内通过 /banlist 命令访问。 活跃的封禁以红色显示,已过期的或已解封的玩家以绿色显示,让你一眼就能看清当前状态。每个条目显示玩家头像、封禁理由、类型(封禁或 IP 封禁)、剩余时长、发出封禁的工作人员以及案例 ID。 工作人员可以筛选列表以显示所有封禁、仅活跃封禁或仅非活跃封禁。内置的案例 ID 搜索功能允许你通过在聊天中输入 ID 来即时查找特定案例。点击活跃封禁条目可直接从 GUI 中解封该玩家。

高级管理工具

隐身系统 - 完全隐形,支持隐藏于 Tab 列表、上帝模式以及基于权限的可见性。工作人员可以在监控服务器时保持隐身。

小号检测与限制 - 自动检测小号账号,并限制来自同一 IP 地址的连接账号数量(可配置为每 IP 最多 5 个账号)。

客户端检测 - 检测玩家使用的客户端类型,并根据这些信息采取行动。

聊天冻结 - 暂时冻结所有聊天内容,用于发布公告或紧急情况。适用于全服公告。

备注系统 - 仅限工作人员使用的玩家备注,具备完整的历史记录追踪功能。保存玩家无法看到的内部备注。

历史记录系统 - 完整的审计追踪,所有管理操作均带有案例 ID。每项操作都会被记录并可搜索。

模板与升级系统

预配置模板 - 即用的处罚模板,会根据重复违规行为自动升级。设置一次,让系统处理惯犯。

多级升级 - 根据玩家受罚次数自动增加处罚时长。初犯给予警告,二犯短期封禁,三犯更长期封禁,以此类推。

IP/UUID 追踪 - 可根据模板选择按 IP 地址或 UUID 进行追踪。某些违规可能需要 IP 追踪,而其他则不需要。

自定义理由后缀 - 自动在封禁理由中添加违规级别信息。清楚说明某人为何受到更长的封禁。

模板权限 - 细粒度的权限系统,确保初级工作人员只能使用特定的模板。

离线玩家支持

Zenith-Mod 的关键功能之一是即使玩家不在线,你也可以对其进行管理。这意味着你可以对离线玩家执行封禁、静音、警告、冻结或添加备注——当他们尝试加入服务器时,这些操作就会生效。这在处理举报或对在你处理之前下线采取行动的玩家可以说是特别有用。

注意:这里指的是当前处于离线状态的玩家,而非离线模式(破解版)Minecraft 服务器。该插件适用于标准的在线模式认证。

API 与集成

Java API 系统 (Beta)

Zenith-Mod 包含一个全面的 Java API,供希望将管理功能集成到自己插件中的开发者使用。

可用 API:

  • FreezeAPI - 通过编程方式冻结和解冻玩家,并跟踪历史记录
  • ChatFreezeAPI - 通过编程控制服务器聊天
  • EssentialsAPI - 上帝模式、飞行模式、治疗、喂食、清除物品栏、传送
  • VanishAPI - 通过编程方式隐身和取消隐身玩家
  • 事件系统 - 通过自定义事件监听管理操作(封禁、静音、警告、踢出事件)

所有 API 方法均使用 CompletableFuture 进行非阻塞操作,因此不会拖慢你的服务器速度。对于所有 API 操作,工作人员通知和历史记录日志都会自动发生。

API 文档:

API Beta 须知

Java API 目前处于 Beta 阶段。虽然核心插件功能稳定,但 API 功能在未来的版本中可能会发生变化。请自行承担使用风险。

其他集成

Web-API(高级版)- 用于外部集成和 Web 面板的 RESTful API。支持基于令牌的认证、实时服务器统计以及针对高级功能的许可证验证。

Discord Integration(Beta)- 在 Discord 中使用斜杠命令执行管理操作。非常适合远程管理或与 Discord 机器人集成。

性能优化

Zenith-Mod 中的所有功能均以性能为导向构建。所有操作均为完全异步,因此不会阻塞主服务器线程。我们使用 HikariCP 进行数据库连接池化,从而实现快速高效的数据库操作。配置更改无需重启服务器即可重新加载,且所有数据库查询均为非阻塞式。

现代架构

多数据库支持 - 支持 H2(默认)、SQLite、MySQL 或 MariaDB。单服务器建议使用 H2,多服务器环境建议使用 MySQL/MariaDB。

代理支持 - 完全支持 Velocity 和 BungeeCord 的 IP 转发。

模块化配置 - 每个模块都有独立的配置文件,便于按需自定义。

基于权限 - 提供完善的权限系统,让你可以控制谁能执行哪些操作。

错误处理 - 健壮的错误处理机制确保插件在出现问题时不会导致服务器崩溃。

模块

模块 描述
Ban 完整的封禁管理,包括 IP 封禁和升级机制
Mute 聊天静音,支持命令阻止和升级机制
Warn 警告系统,阈值可自定义
Freeze 玩家冻结,附带限制措施
Kick 增强型踢出系统
Vanish 完整的隐身系统
Limiter 小号检测与 IP 限制
History 完整的管理历史记录追踪
Notes 员工备注系统
Check 玩家信息与状态检查
Client Detector 客户端类型检测
Chat Freeze 临时聊天冻结
Essentials 上帝模式、飞行模式、治疗、喂食、清除、传送
Web-API(高级版) RESTful API 集成
Discord(Beta) Discord 机器人集成

我们的计划:

  • Punish Command - 通过 GUI 执行管理操作
  • VoiceChat Muting - 使用 Simple Voice Chat 在语音聊天中静音用户

技术规格

兼容性

  • Paper 1.21.4+ - 经过全面测试并支持
  • Paper 1.21.x - 极有可能兼容
  • Paper 1.20.x - 极有可能兼容
  • Paper 1.19.4 - 可能兼容
  • Paper 1.19.x - 可能会有小问题
  • Paper 1.18.x 及更早版本 - 不支持
  • Spigot - 部分支持(某些功能可能无法正常工作)

要求

  • Java:17 或更高版本
  • 服务器:推荐 Paper 1.19.4+
  • 数据库:H2(默认)、SQLite、MySQL 或 MariaDB
  • 权限:LuckPerms 或类似插件(推荐)

配置

  • 热重载:使用 /zenith reload 在不重启服务器的情况下重新加载所有配置
  • 模块化配置:每个模块在 modules/ 目录下都有其独立的 YAML 文件
  • 颜色支持:完全支持十六进制颜色代码和 Minecraft 颜色代码
  • 占位符:所有消息中均支持动态占位符

关键命令

  • /ban <player> <template> - 使用模板封禁玩家
  • /mute <player> <template> - 使用模板静音玩家
  • /warn <player> <template> - 使用模板警告玩家
  • /freeze <player> - 原地冻结玩家
  • /vanish - 切换隐身模式
  • /history <player> - 查看玩家的管理历史记录
  • /notes <player> - 管理员工的玩家备注
  • /check <player> - 检查玩家的当前状态
  • /zenith reload - 重新加载所有配置文件
  • /zenith help - 显示所有可用命令

员工功能

  • 所有管理事件的实时通知
  • 基于重复违规行为的自动升级
  • 基于 IP 的追踪以防止小号滥用
  • 带有可搜索案例 ID 的完整审计轨迹
  • 支持离线玩家管理
  • 为初级员工提供仅限模板的模式

性能亮点

  • 异步操作:不阻塞服务器线程
  • 连接池化:使用 HikariCP 实现最佳数据库性能
  • 智能缓存:频繁访问的数据会被缓存
  • 文件轮转:按日期自动轮转日志文件
  • 错误恢复:数据库操作自动重试

统计与追踪

  • 玩家加入和离开追踪
  • 管理行动计数
  • 活跃封禁和静音追踪
  • 每个模板的违规计数
  • 小号账号检测
  • IP 地址追踪(支持代理)

自定义

  • 消息:可在 messages.yml 中完全自定义
  • 颜色:全程支持十六进制颜色
  • 占位符:所有消息中支持动态内容
  • 前缀:所有消息的前缀可配置
  • 持续时间格式:可自定义持续时间显示

入门指南

  1. 下载插件并将其放入 plugins/ 文件夹
  2. 重启服务器
  3. 在 config.yml 中配置数据库设置
  4. 如有需要,在 messages.yml 中自定义消息
  5. 在 modules/ 目录中配置模块
  6. 使用 /zenith reload 应用任何配置更改

面向插件开发者

Zenith-Mod 提供了全面的 Java API 用于插件集成:

ZenithAPI api = ZenithAPI.getInstance();
if (api != null && api.isAvailable()) {
    // 使用 FreezeAPI, ChatFreezeAPI, EssentialsAPI, VanishAPI
    // 使用 ZenithEventBus 订阅事件
}

完整 API 文档:

API 使用示例
// 订阅封禁事件
ZenithEventBus bus = ZenithEventBus.getInstance();
bus.subscribe(PlayerBanEvent.class, event -> {
    getLogger().info(event.getPlayerName() + " was banned: " + event.getReason());
});

// 通过 API 冻结玩家
FreezeAPI freezeAPI = api.getFreezeAPI();
freezeAPI.freeze(playerUuid, staffUuid, "Investigation").thenAccept(success -> {
    if (success) {
        getLogger().info("Player frozen successfully");
    }
});

重要说明

  • Java API:目前处于 BETA(测试)阶段——API 结构在未来的版本中可能会发生变化。
  • Discord 集成:目前处于 BETA 阶段——请谨慎使用。
  • 高级功能:部分功能需要许可证。
  • 数据库:单机服务器设置推荐使用 H2。
  • MySQL/MariaDB:多服务器设置推荐使用 MySQL/MariaDB。

支持与资源

  • Discord:加入我们的 Discord
  • 高级模块:可在 Discord 获取
  • 文档:Zenith-Mod Docs
  • API 文档:Javadocs
  • 支持:可在 Discord 获取

为什么选择 Zenith-Mod?

性能优先 - 零线程阻塞,完全异步操作
现代设计 - 专为 Paper 1.21.4+ 及最新 API 构建
完整解决方案 - 一个插件满足所有需求
开发者友好 - 提供全面的 Java API 用于集成
可扩展 - 适用于小型和大型服务器
专业级 - 企业级可靠性
可配置 - 高度自定义以满足您的需求
文档完善 - 提供全面的文档和支持


由 Zenith Studios 用 ❤️ 制作

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源