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 机器人集成 |
我们的计划:
技术规格
兼容性
- 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 中完全自定义
- 颜色:全程支持十六进制颜色
- 占位符:所有消息中支持动态内容
- 前缀:所有消息的前缀可配置
- 持续时间格式:可自定义持续时间显示
入门指南
- 下载插件并将其放入
plugins/ 文件夹
- 重启服务器
- 在
config.yml 中配置数据库设置
- 如有需要,在
messages.yml 中自定义消息
- 在
modules/ 目录中配置模块
- 使用
/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。
支持与资源
为什么选择 Zenith-Mod?
性能优先 - 零线程阻塞,完全异步操作
现代设计 - 专为 Paper 1.21.4+ 及最新 API 构建
完整解决方案 - 一个插件满足所有需求
开发者友好 - 提供全面的 Java API 用于集成
可扩展 - 适用于小型和大型服务器
专业级 - 企业级可靠性
可配置 - 高度自定义以满足您的需求
文档完善 - 提供全面的文档和支持
由 Zenith Studios 用 ❤️ 制作
Zenith-Mod - Professional Moderation Plugin
Missing something?
Do you miss something in this Plugin? Open a Ticket in our Discord and we'll implement it very asap!
A comprehensive moderation plugin built for modern Paper servers. Zenith-Mod gives you everything you need to manage your community effectively, with a focus on performance and reliability.
Core Features
Complete Moderation Suite
Ban System - Full ban management with IP bans, temporary and permanent bans, automatic escalation, and template support. Ban players whether they're online or offline.
Mute System - Chat muting with command blocking support. Works for offline players too, so you can mute someone before they even join. Includes IP-based muting and automatic escalation.
Warning System - Track warnings with escalation levels and customizable thresholds. See a player's warning history at a glance.
Freeze System - Freeze players in place with movement restrictions. Perfect for investigations or preventing griefers from escaping.
Kick System - Enhanced kick functionality with custom reasons and staff notifications.
AutoMod -
The AutoMod system automatically monitors chat and removes messages that violate your server rules — no manual intervention needed.
Word Filter automatically detects and removes messages containing blacklisted words. Thanks to built-in Leetspeak normalization, bypass attempts like 1d10t, i.d.i.o.t or @ssh0le are caught automatically — you only need to add the base word to the list.
AntiSpam detects two types of spam: players sending the same message repeatedly (duplicate detection) and players flooding the chat with too many messages in a short time (flood detection). Both thresholds are fully configurable.
When a message is blocked, the player receives a notification and staff members with the alert permission are instantly notified in-game. Alerts are also sent to a configurable Discord channel as an embed. Staff can toggle their own alerts on/off with /automod alerts.
Banlist GUI -
The Banlist GUI gives your staff a clean overview of all bans on your server — both active and inactive — directly in-game via /banlist.
Active bans are displayed in red, expired or already unbanned players in green, making it easy to see the current status at a glance. Each entry shows the player head, ban reason, type (Ban or IP-Ban), remaining duration, the staff member who issued the ban, and the Case ID.
Staff can filter the list to show all bans, active bans only, or inactive bans only. A built-in Case ID search lets you find a specific case instantly by typing the ID in chat. Clicking on an active ban entry unbans the player directly from the GUI.
Advanced Management Tools
Vanish System - Complete invisibility with tab list hiding, god mode, and permission-based visibility. Staff can stay hidden while monitoring the server.
Alt Detection & Limiting - Automatically detect alt accounts and limit how many accounts can connect from the same IP address (configurable up to 5 accounts per IP).
Client Detection - Detect what client players are using and take action based on that information.
Chat Freeze - Temporarily freeze all chat for announcements or emergencies. Useful for server-wide announcements.
Notes System - Staff-only notes for players with full history tracking. Keep internal notes that players can't see.
History System - Complete audit trail with case IDs for all moderation actions. Every action is logged and searchable.
Template & Escalation System
Pre-configured Templates - Ready-to-use punishment templates that automatically escalate based on repeat offenses. Set up once and let the system handle repeat offenders.
Multi-level Escalation - Automatic duration increases based on how many times a player has been punished. First offense gets a warning, second gets a short ban, third gets longer, and so on.
IP/UUID Tracking - Choose whether to track by IP address or UUID per template. Some offenses might need IP tracking, others don't.
Custom Reason Suffixes - Automatically add offense level information to ban reasons. Makes it clear why someone got a longer ban.
Template Permissions - Granular permission system so junior staff can only use certain templates.
Offline Player Support
One of Zenith-Mod's key features is that you can moderate players even when they're not currently online. This means you can ban, mute, warn, freeze, or add notes to players who are offline - the action will take effect as soon as they try to join. This is especially useful for handling reports or taking action on players who logged off before you could deal with them.
Note: This refers to players who are currently offline, not offline-mode (cracked) Minecraft servers. The plugin works with standard online-mode authentication.
API & Integrations
Java API System (Beta)
Zenith-Mod includes a comprehensive Java API for developers who want to integrate moderation features into their own plugins.
Available APIs:
- FreezeAPI - Programmatically freeze and unfreeze players with history tracking
- ChatFreezeAPI - Control server chat programmatically
- EssentialsAPI - God mode, fly mode, heal, feed, clear inventory, teleport
- VanishAPI - Vanish and unvanish players programmatically
- Event System - Listen to moderation actions with custom events (Ban, Mute, Warn, Kick events)
All API methods use CompletableFuture for non-blocking operations, so they won't slow down your server. Staff notifications and history logging happen automatically for all API actions.
API Documentation:
API Beta Notice
The Java API is currently in Beta. While core plugin functionality is stable, API features may undergo changes in future versions. Use at your own risk.
Other Integrations
Web-API (Premium) - RESTful API for external integrations and web panels. Token-based authentication with real-time server statistics and license validation for premium features.
Discord Integration (Beta) - Use slash commands in Discord to perform moderation actions. Great for remote moderation or integrating with Discord bots.
Performance Optimized
Everything in Zenith-Mod is built with performance in mind. All operations are fully asynchronous, so nothing blocks the main server thread. We use HikariCP for database connection pooling, which means fast and efficient database operations. Configuration changes can be reloaded without restarting the server, and all database queries are non-blocking.
Modern Architecture
Multi-Database Support - Works with H2 (default), SQLite, MySQL, or MariaDB. Use H2 for single servers, MySQL/MariaDB for multi-server setups.
Proxy Support - Full support for Velocity and BungeeCord IP forwarding.
Modular Configuration - Each module has its own config file, making it easy to customize what you need.
Permission-Based - Comprehensive permission system so you can control who can do what.
Error Handling - Robust error handling means the plugin won't crash your server if something goes wrong.
Modules
| Module |
Description |
| Ban |
Complete ban management with IP bans and escalation |
| Mute |
Chat muting with command blocking and escalation |
| Warn |
Warning system with customizable thresholds |
| Freeze |
Player freezing with restrictions |
| Kick |
Enhanced kick system |
| Vanish |
Complete invisibility system |
| Limiter |
Alt detection and IP limiting |
| History |
Complete moderation history tracking |
| Notes |
Staff notes system |
| Check |
Player information and status checks |
| Client Detector |
Client type detection |
| Chat Freeze |
Temporary chat freezing |
| Essentials |
God mode, fly mode, heal, feed, clear, teleport |
| Web-API (Premium) |
RESTful API integration |
| Discord (Beta) |
Discord bot integration |
What we're planning:
- Punish Command - Take moderation actions through a GUI
- VoiceChat Muting - Mute people in voice chat using Simple Voice Chat
Technical Specifications
Compatibility
- Paper 1.21.4+ - Fully tested and supported
- Paper 1.21.x - Very likely compatible
- Paper 1.20.x - Very likely compatible
- Paper 1.19.4 - Probably compatible
- Paper 1.19.x - May work with minor issues
- Paper 1.18.x and older - Not supported
- Spigot - Partially supported (some features may not work)
Requirements
- Java: 17 or higher
- Server: Paper 1.19.4+ recommended
- Database: H2 (default), SQLite, MySQL, or MariaDB
- Permissions: LuckPerms or similar (recommended)
Configuration
- Hot-Reload: Use
/zenith reload to reload all configs without restarting
- Modular Config: Each module has its own YAML file in the
modules/ directory
- Color Support: Full hex color support and Minecraft color codes
- Placeholders: Dynamic placeholders in all messages
Key Commands
/ban <player> <template> - Ban a player using a template
/mute <player> <template> - Mute a player using a template
/warn <player> <template> - Warn a player using a template
/freeze <player> - Freeze a player in place
/vanish - Toggle vanish mode
/history <player> - View a player's moderation history
/notes <player> - Manage staff notes for a player
/check <player> - Check a player's current status
/zenith reload - Reload all configuration files
/zenith help - Show all available commands
Staff Features
- Real-time notifications for all moderation events
- Auto-escalation based on repeat offenses
- IP-based tracking to prevent alt account abuse
- Complete audit trail with searchable case IDs
- Offline player moderation support
- Template-only mode for junior staff members
Performance Highlights
- Async Operations: Nothing blocks the server thread
- Connection Pooling: HikariCP for optimal database performance
- Smart Caching: Frequently accessed data is cached
- File Rotation: Automatic log file rotation by date
- Error Recovery: Automatic retry for database operations
Statistics & Tracking
- Player join and leave tracking
- Moderation action counts
- Active ban and mute tracking
- Offense count per template
- Alt account detection
- IP address tracking (with proxy support)
Customization
- Messages: Fully customizable in
messages.yml
- Colors: Hex color support throughout
- Placeholders: Dynamic content in all messages
- Prefix: Configurable prefix for all messages
- Duration Format: Customizable duration display
Getting Started
- Download the plugin and place it in your
plugins/ folder
- Restart your server
- Configure your database settings in
config.yml
- Customize messages in
messages.yml if needed
- Configure modules in the
modules/ directory
- Use
/zenith reload to apply any configuration changes
For Plugin Developers
Zenith-Mod provides a comprehensive Java API for plugin integration:
ZenithAPI api = ZenithAPI.getInstance();
if (api != null && api.isAvailable()) {
// Use FreezeAPI, ChatFreezeAPI, EssentialsAPI, VanishAPI
// Subscribe to events with ZenithEventBus
}
Full API Documentation:
API Usage Example
// Subscribe to ban events
ZenithEventBus bus = ZenithEventBus.getInstance();
bus.subscribe(PlayerBanEvent.class, event -> {
getLogger().info(event.getPlayerName() + " was banned: " + event.getReason());
});
// Freeze a player via API
FreezeAPI freezeAPI = api.getFreezeAPI();
freezeAPI.freeze(playerUuid, staffUuid, "Investigation").thenAccept(success -> {
if (success) {
getLogger().info("Player frozen successfully");
}
});
Important Notes
- Java API: Currently in BETA - API structure may change in future versions
- Discord Integration: Currently in BETA - use with caution
- Premium Features: Some features require a license
- Database: H2 is recommended for single-server setups
- MySQL/MariaDB: Recommended for multi-server setups
Support & Resources
- Discord: Join our Discord
- Premium Modules: Available on Discord
- Documentation: Zenith-Mod Docs
- API Documentation: Javadocs
- Support: Available on Discord
Why Zenith-Mod?
Performance First - Zero thread blocking, fully async operations
Modern Design - Built for Paper 1.21.4+ with latest APIs
Complete Solution - Everything you need in one plugin
Developer Friendly - Comprehensive Java API for integrations
Scalable - Works great for small and large servers
Professional - Enterprise-grade reliability
Configurable - Highly customizable to fit your needs
Well Documented - Comprehensive documentation and support
Made with ❤️ by Zenith Studios
评论 0
登录后参与评分
还没有评论,来抢沙发吧