?️ WeGuardian
Minecraft 服务器的专业处罚管理系统
by WeThink
✨ 功能特性
? 处罚系统
- Ban & TempBan - 永久或暂时封禁玩家
- IP Ban & TempIP Ban - 通过 IP 地址封禁玩家,并支持自动解析 IP
- Mute & TempMute - 永久或暂时禁言玩家
- IP Mute & TempIP Mute - 基于 IP 的禁言系统
- Kick - 立即将玩家踢出服务器
? 交互式 GUI
- Punishment GUI - 美观直观的处罚选择界面
- Duration Selector - 带有预设选项的易用时长选择器
- History Viewer - 支持分页浏览处罚历史
? 数据库支持
- SQLite - 零配置本地存储(默认)
- MySQL - 支持 MySQL 以适配更大规模的服务器
- HikariCP - 高性能连接池
- Caffeine Caching - 极速数据检索
? Web 仪表盘
- 内置 Web 面板用于远程管理
- REST API 支持自定义集成
- 可配置的品牌和外观
? Discord 集成
- 所有处罚操作的 Webhook 日志记录
- 批量发送消息以避免触发速率限制
- 精美的嵌入格式展示
⚡ 性能优化
- Folia Support - 完全兼容 Folia 服务器
- Async Operations - 非阻塞式数据库操作
- Lazy GUI Initialization - 优化的 GUI 性能
? 安装指南
- 下载最新的
WeGuardian.jar - 将其放入服务器的
plugins文件夹中 - 重启服务器
- 配置
plugins/WeGuardian/config.yml
? 命令列表
| 命令 | 描述 | 权限节点 |
|---|---|---|
/ban <player> [reason] |
永久封禁一名玩家 | weguardian.ban |
/tempban <player> <duration> [reason] |
暂时封禁一名玩家 | weguardian.tempban |
/unban <player> |
解封一名玩家 | weguardian.unban |
/banip <player> [reason] |
封禁玩家的 IP | weguardian.banip |
/tempbanip <player> <duration> [reason] |
暂时封禁玩家的 IP | weguardian.tempbanip |
/unbanip <player> |
解封玩家的 IP | weguardian.unbanip |
/mute <player> [reason] |
永久禁言一名玩家 | weguardian.mute |
/tempmute <player> <duration> [reason] |
暂时禁言一名玩家 | weguardian.tempmute |
/unmute <player> |
解除禁言 | weguardian.unmute |
/muteip <player> [reason] |
禁言玩家的 IP | weguardian.muteip |
/tempmuteip <player> <duration> [reason] |
暂时禁言玩家的 IP | weguardian.tempmuteip |
/unmuteip <player> |
解除玩家 IP 的禁言 | weguardian.unmuteip |
/kick <player> [reason] |
踢出一名玩家 | weguardian.kick |
/punish <player> |
打开处罚 GUI | weguardian.punish |
/history <player> |
查看处罚历史 | weguardian.history |
/weguardian reload |
重载配置 | weguardian.admin |
? 权限说明
| 权限节点 | 描述 | 默认值 |
|---|---|---|
weguardian.staff |
所有管理人员权限 | OP |
weguardian.admin |
管理员命令(重载等) | OP |
weguardian.bypass |
绕过所有处罚检查 | false |
⏱️ 时长格式
时长支持以下格式:
| 单位 | 示例 | 描述 |
|---|---|---|
s |
30s |
秒 |
m |
30m |
分钟 |
h |
6h |
小时 |
d |
7d |
天 |
w |
2w |
周 |
M |
1M |
月 |
y |
1y |
年 |
示例: 1h, 6h, 1d, 7d, 30d, 90d
⚙️ 配置项
数据库 (SQLite - 默认)
database:
type: "sqlite"
sqlite:
file: "punishments.db"
数据库 (MySQL)
database:
type: "mysql"
mysql:
host: "localhost"
port: 3306
database: "weguardian"
username: "root"
password: "password"
Discord Webhook
discord:
enabled: true
webhook-url: "YOUR_WEBHOOK_URL"
batch-interval-seconds: 5
Web 仪表盘
web-dashboard:
enabled: true
host: "0.0.0.0"
port: 8080
admin-api-key: "YOUR_SECURE_KEY"
?️ 运行环境要求
- Minecraft Server: Paper 1.21+ 或 Folia
- Java: 21 或更高版本
? 依赖项
- Paper API - 服务器 API
- FoliaLib - Folia 兼容性支持
- Caffeine - 缓存库
- HikariCP - 连接池
- ACF - 命令框架
- FastInv - GUI 框架
- bStats - 插件指标统计
- Javalin - Web 框架
? 技术支持
如需帮助或有疑问,请加入我们的 Discord 或在 GitHub 上提交 Issue。
? 许可证
本项目采用 MIT 许可证。详情请参阅 LICENSE.md。
Made with ❤️ by WeThink
?️ WeGuardian
Professional Punishment Management System for Minecraft Servers
by WeThink
✨ Features
? Punishment System
- Ban & TempBan - Permanently or temporarily ban players
- IP Ban & TempIP Ban - Ban players by IP address with automatic IP resolution
- Mute & TempMute - Silence players permanently or temporarily
- IP Mute & TempIP Mute - IP-based muting system
- Kick - Instantly remove players from the server
? Interactive GUI
- Punishment GUI - Beautiful and intuitive punishment selection interface
- Duration Selector - Easy-to-use duration selection with presets
- History Viewer - Browse punishment history with pagination
? Database Support
- SQLite - Zero-configuration local storage (default)
- MySQL - Scale to larger servers with MySQL support
- HikariCP - High-performance connection pooling
- Caffeine Caching - Lightning-fast data retrieval
? Web Dashboard
- Built-in web panel for remote management
- REST API for custom integrations
- Configurable branding and appearance
? Discord Integration
- Webhook logging for all punishments
- Batched messages to avoid rate limits
- Beautiful embed formatting
⚡ Performance
- Folia Support - Full compatibility with Folia servers
- Async Operations - Non-blocking database operations
- Lazy GUI Initialization - Optimized GUI performance
? Installation
- Download the latest
WeGuardian.jar - Place it in your server's
pluginsfolder - Restart your server
- Configure
plugins/WeGuardian/config.yml
? Commands
| Command | Description | Permission |
|---|---|---|
/ban <player> [reason] |
Permanently ban a player | weguardian.ban |
/tempban <player> <duration> [reason] |
Temporarily ban a player | weguardian.tempban |
/unban <player> |
Unban a player | weguardian.unban |
/banip <player> [reason] |
IP ban a player | weguardian.banip |
/tempbanip <player> <duration> [reason] |
Temp IP ban a player | weguardian.tempbanip |
/unbanip <player> |
Unban a player's IP | weguardian.unbanip |
/mute <player> [reason] |
Permanently mute a player | weguardian.mute |
/tempmute <player> <duration> [reason] |
Temporarily mute a player | weguardian.tempmute |
/unmute <player> |
Unmute a player | weguardian.unmute |
/muteip <player> [reason] |
IP mute a player | weguardian.muteip |
/tempmuteip <player> <duration> [reason] |
Temp IP mute a player | weguardian.tempmuteip |
/unmuteip <player> |
Unmute a player's IP | weguardian.unmuteip |
/kick <player> [reason] |
Kick a player | weguardian.kick |
/punish <player> |
Open punishment GUI | weguardian.punish |
/history <player> |
View punishment history | weguardian.history |
/weguardian reload |
Reload configuration | weguardian.admin |
? Permissions
| Permission | Description | Default |
|---|---|---|
weguardian.staff |
All staff permissions | OP |
weguardian.admin |
Admin commands (reload) | OP |
weguardian.bypass |
Bypass all punishments | false |
⏱️ Duration Format
Durations support the following formats:
| Unit | Example | Description |
|---|---|---|
s |
30s |
Seconds |
m |
30m |
Minutes |
h |
6h |
Hours |
d |
7d |
Days |
w |
2w |
Weeks |
M |
1M |
Months |
y |
1y |
Years |
Examples: 1h, 6h, 1d, 7d, 30d, 90d
⚙️ Configuration
Database (SQLite - Default)
database:
type: "sqlite"
sqlite:
file: "punishments.db"
Database (MySQL)
database:
type: "mysql"
mysql:
host: "localhost"
port: 3306
database: "weguardian"
username: "root"
password: "password"
Discord Webhook
discord:
enabled: true
webhook-url: "YOUR_WEBHOOK_URL"
batch-interval-seconds: 5
Web Dashboard
web-dashboard:
enabled: true
host: "0.0.0.0"
port: 8080
admin-api-key: "YOUR_SECURE_KEY"
?️ Requirements
- Minecraft Server: Paper 1.21+ or Folia
- Java: 21 or higher
? Dependencies
- Paper API - Server API
- FoliaLib - Folia compatibility
- Caffeine - Caching
- HikariCP - Connection pooling
- ACF - Command framework
- FastInv - GUI framework
- bStats - Plugin metrics
- Javalin - Web framework
? Support
For support and questions, join our Discord or open an issue on GitHub.
? License
This project is licensed under the MIT License. See LICENSE.md for details.
Made with ❤️ by WeThink
下载 WeGuardian
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 WeGuardian
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 WeGuardian
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 WeGuardian
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 WeGuardian
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 WeGuardian
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 WeGuardian
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 WeGuardian
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 WeGuardian
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 WeGuardian
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
?️ WeGuardian 更新日志
2.4 版本 – 完整消息与 GUI 配置更新
发布类型: 重大配置与自定义更新 重点: 灵活性、本地化以及服务器品牌定制
✨ 新功能
? 完全可配置的 messages.yml
-
新增专用的
messages.yml文件,用于集中管理所有面向玩家显示的文本 -
现在每条消息均可配置,包括:
- 聊天消息
- 错误消息
- 成功消息
- 通知
- 标题(Titles)与副标题(Subtitles)
- 动作栏(Action bar)消息
? GUI 自定义(100% 可配置)
-
所有 GUI 元素现均可从
messages.yml进行配置,包括:- GUI 标题
- 物品显示名称
- 物品描述文本(Lore)
- 按钮及说明文字
-
受影响的 GUI 界面:
- 惩罚 GUI
- 时长选择 GUI
- 历史记录 GUI
?️ 新的消息管理系统
-
引入了 MessagesManager 系统,旨在:
- 高效加载和缓存消息
- 支持在所有消息中使用占位符
- 确保全局格式的一致性
-
采用兼容 MiniMessage 的格式以支持现代化的文本样式
? 改进项
-
移除了以下位置的硬编码字符串:
- GUI 类
- 输入处理程序(原因输入、自定义时长输入)
- 命令反馈消息
-
提高了代码库的可维护性和可读性
-
非英语服务器的本地化工作更加简便
-
服务器管理员现在可以完全自定义 WeGuardian 的品牌展示,而无需修改源代码
? 开发者与管理员福利
- 修改消息无需重新编译
- 逻辑层与表现层实现清晰分离
- 未来更新将通过
messages.yml自动支持新增消息
⚠️ 升级注意事项
- 首次启动时,系统将自动生成
messages.yml文件 - 从旧版本升级的服务器应审查并自定义该新文件
- 此前位于
config.yml中的旧消息值现由messages.yml统一管理
✅ 建议操作
升级至 WeGuardian v2.4,以解锁对消息、GUI 界面及服务器展示的完全控制权。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧