? EnchancedBan (v1.0.0)
? 概述
EnchancedBan 是一款专为现代 Paper 和 Purpur 服务器(支持 1.20.x 至 1.21+ 版本)打造的下一代高性能惩罚与管理套件。
EnchancedBan 从零开始构建,旨在取代过时的封禁插件。它融合了高速异步数据库架构、现代 Kyori Adventure MiniMessage 深红渐变美学、受 LibertyBans 启发的多级小号检测功能,以及全面的 Network Guard 地理定位分析。
✨ 主要特性
? 1. 引人注目的深红渐变 UI
- 原生支持 Kyori Adventure MiniMessage 渲染(无传统格式显示的故障)。
- 惊艳的深红与血红渐变效果(
<gradient:#ff416c:#8a2387>,<gradient:#ff3333:#8a0000>),赋予服务器管理权威且高端的质感。
- 交互式悬停卡片(显示 UUID、执行者、剩余时间)及可点击的快捷操作。
? 2. LibertyBans 风格的小号检测 (/alts)
- 多级检测层级:
NORMAL(强匹配):当前共享同一 IP 地址的账号。
STRICT(历史匹配):过去曾从共享 IP 连接的账号。
- 动态惩罚着色:
- ? 被封禁的小号: 以红色斜体显示(
<red><i>)。
- ? 被静音的小号: 以金色斜体显示(
<yellow><i>)。
- ? 干净的小号: 以灰色斜体显示(
<gray><i>)。
- 员工加入提醒: 当玩家加入时,拥有
enchancedban.alts.notify 权限的员工会立即看到已知的小号及其状态。
- 隐私 IP 掩码: 默认情况下 IP 地址会被掩码处理(
192.168.***.***),除非员工持有 enchancedban.alts.ip 权限。
?️ 3. Network Guard 地理定位与安全 (/guard analyze)
- 双提供商快速地理定位查询(使用
ipwho.is,并自动回退至 ip-api.com)。
- 显示国家、城市、地区、ISP/组织、时区以及城市定位准确率。
- 代理 / VPN / 托管检测: 即时高亮可疑的连接路径。
- 内存缓存引擎,防止触发速率限制或导致服务器卡顿。
⚖️ 4. 全面的惩罚套件
- 封禁与临时封禁:
/ban, /tempban, /unban。
- IP 封禁与临时 IP 封禁:
/ipban, /tempipban, /unbanip。
- 静音与临时静音:
/mute, /tempmute, /unmute(禁止聊天和私语)。
- 踢出:
/kick,带有时尚的自定义断开连接横幅。
- 警告与自动升级:
- 使用
/warn 发出正式警告,使用 /warns 查看活动警告,使用 /clearwarns 清除它们。
- 自动惩罚升级: 配置阈值(例如:3 次警告 = 2 小时临时静音,5 次警告 = 1 天临时封禁,7 次警告 = 永久封禁)。
- 回滚系统 (
/rollback <staff> <duration>):
- 静默标志 (
-s):
- 在惩罚命令中任意位置添加
-s 以抑制公共广播,仅通知员工。
⚡ 5. 企业级异步性能
- 基于 HikariCP 高性能连接池构建。
- 支持零配置的 SQLite(默认)和可扩展的 MySQL / MariaDB。
- 100% 异步数据库操作,配合内存缓存实现零延迟登录检查。
? 6. Discord Webhook 集成
- 内置异步 Discord webhook 通知系统。
- 发送丰富的深红
#C21807 嵌入消息,包含目标玩家、执行员工、持续时间和原因。
? 命令与权限
管理命令
| 命令 |
参数 |
权限 |
描述 |
/ban |
<player> [reason] [-s] |
enchancedban.ban |
永久封禁一名玩家。 |
/tempban |
<player> <duration> [reason] [-s] |
enchancedban.tempban |
临时封禁一名玩家(例如 30m,2h,7d,1mo)。 |
/ipban |
<player|ip> [reason] [-s] |
enchancedban.ipban |
永久封禁一个 IP 地址。 |
/tempipban |
<player|ip> <duration> [reason] [-s] |
enchancedban.tempipban |
临时封禁一个 IP 地址。 |
/unban |
<player|uuid> |
enchancedban.unban |
解封一名玩家。 |
/unbanip |
<ip> |
enchancedban.unbanip |
解封一个 IP 地址。 |
/mute |
<player> [reason] [-s] |
enchancedban.mute |
永久静音一名玩家的聊天和私语。 |
/tempmute |
<player> <duration> [reason] [-s] |
enchancedban.tempmute |
临时静音一名玩家。 |
/unmute |
<player> |
enchancedban.unmute |
解除一名被静音玩家的静音状态。 |
/warn |
<player> [reason] [-s] |
enchancedban.warn |
向一名玩家发出正式警告。 |
/warns |
<player> |
enchancedban.warn |
查看一名玩家的所有活动警告。 |
/clearwarns |
<player> |
enchancedban.clearwarns |
清除一名玩家的所有活动警告。 |
/kick |
<player> [reason] [-s] |
enchancedban.kick |
将在线玩家踢出服务器。 |
分析与调查命令
| 命令 |
参数 |
权限节点 |
描述 |
/check |
<player> |
enchancedban.check |
查看玩家的封禁、静音、警告次数及关联账号概览。 |
/history |
<player> [page] |
enchancedban.history |
分页查看历史处罚日志。 |
/alts |
<player> [page] |
enchancedban.alts |
扫描并显示关联的备用账号(普通模式与严格模式)。 |
/guard |
analyze <player> |
enchancedban.guard |
运行 IP 地理定位、ISP 提供商以及 VPN/代理安全扫描。 |
/rollback |
<staff> <duration> |
enchancedban.rollback |
批量撤销某名工作人员发出的活跃处罚。 |
/enchancedban |
reload |
enchancedban.admin |
重新加载 config.yml 和 messages.yml。 |
? 权限参考
| 权限节点 |
描述 |
默认值 |
enchancedban.* |
授予对 EnchancedBan 所有功能的完全访问权限。 |
op |
enchancedban.admin |
可重新加载配置文件及使用管理命令。 |
op |
enchancedban.exempt |
使玩家免疫于被封禁、静音、警告或踢出。 |
false |
enchancedban.silent |
允许查看静默处罚广播(-s)。 |
op |
enchancedban.alts.notify |
当玩家使用备用账号登录时,自动接收工作人员通知。 |
op |
enchancedban.alts.ip |
在 /alts 查询结果中显示未掩码的 IP 地址。 |
op |
enchancedban.guard.ip |
在 /guard analyze 结果中显示未掩码的 IP 地址。 |
op |
⚙️ 配置 (config.yml)
# 数据库存储设置
storage:
type: sqlite # sqlite, mysql, or mariadb
sqlite:
file: "enchancedban.db"
# 备用账号检测
alts:
alert-on-join: true # 当携带备用账号的玩家连接时提醒工作人员
alert-only-punished: false # 仅当至少有一个备用账号被封禁/静音时才提醒
alert-limit: 6 # 登录警报中显示的最大备用账号数量
per-page: 8 # /alts 命令每页显示的条目数
# 地理定位守卫
guard:
cache-minutes: 60
timeout-ms: 4000
# 自动警告升级操作
warn-actions:
enabled: true
actions:
3: "tempmute {player} 2h Reached 3 warnings"
5: "tempban {player} 1d Reached 5 warnings"
7: "ban {player} Permanent ban due to repeated offenses"
# Discord Webhook
discord:
enabled: false
webhook-url: ""
server-name: "Survival"
embed-color: "#C21807"
? 从源码构建
环境要求
- JDK 21 或更高版本
- Maven 3.8+(或使用随附的
mvnw.cmd 包装器)
构建步骤
git clone https://github.com/DarkIgnite/EnchancedBan.git
cd EnchancedBan
.\mvnw.cmd clean package
编译后的 shaded jar 文件将位于:
target/enchancedban-1.0.0.jar
?? 作者与致谢
- 创建者与首席开发者: DarkIgnite
- 灵感来源: 作为 AdvancedBan 和 LibertyBans 的高级现代化改进版本开发而成。
- 许可证: GNU General Public License v3.0 (GPL-3.0)。
? EnchancedBan (v1.0.0)
? Overview
EnchancedBan is a next-generation, high-performance punishment and moderation suite built exclusively for modern Paper and Purpur servers (supporting versions 1.20.x through 1.21+).
Engineered from the ground up to replace outdated ban plugins, EnchancedBan merges high-speed asynchronous database architecture with modern Kyori Adventure MiniMessage crimson gradient aesthetics, LibertyBans-inspired multi-tier Alt Account Detection, and comprehensive Network Guard Geolocation Analysis.
✨ Key Features
? 1. Striking Crimson Gradient UI
- Full native Kyori Adventure MiniMessage rendering (no legacy formatting glitches).
- Stunning crimson & blood-red gradients (
<gradient:#ff416c:#8a2387>, <gradient:#ff3333:#8a0000>) that give server discipline an authoritative, premium feel.
- Interactive hover cards (UUIDs, punishers, remaining times) and clickable shortcut actions.
? 2. LibertyBans-Style Alt Account Detection (/alts)
- Multi-Tier Detection Levels:
NORMAL (Strong Match): Accounts currently sharing the same IP address.
STRICT (Historical Match): Accounts that have connected from a shared IP in the past.
- Dynamic Punishment Coloring:
- ? Banned Alts: Displayed in red italics (
<red><i>).
- ? Muted Alts: Displayed in gold italics (
<yellow><i>).
- ? Clean Alts: Displayed in gray italics (
<gray><i>).
- Staff Join Alerts: When a player joins, staff with
enchancedban.alts.notify instantly see known alt accounts and their status.
- Privacy IP Masking: IP addresses are masked by default (
192.168.***.***) unless staff hold the enchancedban.alts.ip permission.
?️ 3. Network Guard Geolocation & Security (/guard analyze)
- Dual-provider fast geolocation lookup (
ipwho.is with automatic fallback to ip-api.com).
- Displays Country, City, Region, ISP/Organization, Timezone, and City Accuracy Percentage.
- Proxy / VPN / Hosting Detection: Highlights suspicious connection routes instantly.
- In-memory caching engine to prevent rate limits or server freezes.
⚖️ 4. Comprehensive Punishment Suite
- Bans & Tempbans:
/ban, /tempban, /unban.
- IP-Bans & Temp-IP-Bans:
/ipban, /tempipban, /unbanip.
- Mutes & Tempmutes:
/mute, /tempmute, /unmute (blocks chat and private whispers).
- Kicks:
/kick with a stylish custom disconnect banner.
- Warnings & Automated Escalation:
- Issue formal warnings with
/warn, view active warnings with /warns, and clear them with /clearwarns.
- Auto-Punish Escalation: Configure thresholds (e.g. 3 warns = 2h tempmute, 5 warns = 1d tempban, 7 warns = permanent ban).
- Rollback System (
/rollback <staff> <duration>):
- Instantly undo accidental or rogue moderator ban waves in seconds!
- Silent Flag (
-s):
- Add
-s anywhere in punishment commands to suppress public broadcasts and notify staff only.
⚡ 5. Enterprise Asynchronous Performance
- Built on HikariCP high-performance connection pooling.
- Supports zero-setup SQLite (default) and scalable MySQL / MariaDB.
- 100% asynchronous database operations with in-memory caching for zero-tick login checks.
? 6. Discord Webhook Integration
- Built-in async Discord webhook notification system.
- Sends rich crimson
#C21807 embeds featuring target player, staff issuer, duration, and reason.
? Commands & Permissions
Moderation Commands
| Command |
Arguments |
Permission |
Description |
/ban |
<player> [reason] [-s] |
enchancedban.ban |
Permanently ban a player. |
/tempban |
<player> <duration> [reason] [-s] |
enchancedban.tempban |
Temporarily ban a player (e.g. 30m, 2h, 7d, 1mo). |
/ipban |
<player|ip> [reason] [-s] |
enchancedban.ipban |
Permanently ban an IP address. |
/tempipban |
<player|ip> <duration> [reason] [-s] |
enchancedban.tempipban |
Temporarily ban an IP address. |
/unban |
<player|uuid> |
enchancedban.unban |
Unban a player. |
/unbanip |
<ip> |
enchancedban.unbanip |
Unban an IP address. |
/mute |
<player> [reason] [-s] |
enchancedban.mute |
Permanently mute a player in chat and whispers. |
/tempmute |
<player> <duration> [reason] [-s] |
enchancedban.tempmute |
Temporarily mute a player. |
/unmute |
<player> |
enchancedban.unmute |
Unmute a muted player. |
/warn |
<player> [reason] [-s] |
enchancedban.warn |
Issue a formal warning to a player. |
/warns |
<player> |
enchancedban.warn |
View all active warnings for a player. |
/clearwarns |
<player> |
enchancedban.clearwarns |
Clear all active warnings for a player. |
/kick |
<player> [reason] [-s] |
enchancedban.kick |
Kick an online player from the server. |
Analytics & Investigation Commands
| Command |
Arguments |
Permission |
Description |
/check |
<player> |
enchancedban.check |
View quick overview of ban, mute, warn count, and alts. |
/history |
<player> [page] |
enchancedban.history |
View paginated historical punishment logs. |
/alts |
<player> [page] |
enchancedban.alts |
Scan and display associated alt accounts (Normal vs Strict). |
/guard |
analyze <player> |
enchancedban.guard |
Run IP geolocation, ISP, and VPN/proxy security scan. |
/rollback |
<staff> <duration> |
enchancedban.rollback |
Mass undo active punishments issued by a staff member. |
/enchancedban |
reload |
enchancedban.admin |
Reload config.yml and messages.yml. |
? Permissions Reference
| Permission Node |
Description |
Default |
enchancedban.* |
Grants full access to all EnchancedBan features. |
op |
enchancedban.admin |
Access to reload configs and administrative commands. |
op |
enchancedban.exempt |
Makes player immune to being banned, muted, warned, or kicked. |
false |
enchancedban.silent |
Allows seeing silent punishment broadcasts (-s). |
op |
enchancedban.alts.notify |
Receives automatic staff notifications when a player joins with alts. |
op |
enchancedban.alts.ip |
Displays unmasked IP addresses in /alts lookup results. |
op |
enchancedban.guard.ip |
Displays unmasked IP addresses in /guard analyze results. |
op |
⚙️ Configuration (config.yml)
# Database Storage Settings
storage:
type: sqlite # sqlite, mysql, or mariadb
sqlite:
file: "enchancedban.db"
# Alt Account Detection
alts:
alert-on-join: true # Alert staff when player with alts connects
alert-only-punished: false # Only alert if at least 1 alt is banned/muted
alert-limit: 6 # Max alts to show in join alerts
per-page: 8 # Entries per page in /alts
# Geolocation Guard
guard:
cache-minutes: 60
timeout-ms: 4000
# Automated Warn Escalation Actions
warn-actions:
enabled: true
actions:
3: "tempmute {player} 2h Reached 3 warnings"
5: "tempban {player} 1d Reached 5 warnings"
7: "ban {player} Permanent ban due to repeated offenses"
# Discord Webhook
discord:
enabled: false
webhook-url: ""
server-name: "Survival"
embed-color: "#C21807"
? Building from Source
Requirements
- JDK 21 or newer
- Maven 3.8+ (or use the included
mvnw.cmd wrapper)
Build Steps
git clone https://github.com/DarkIgnite/EnchancedBan.git
cd EnchancedBan
.\mvnw.cmd clean package
The compiled shaded jar will be located at:
target/enchancedban-1.0.0.jar
?? Author & Credits
- Creator & Lead Developer: DarkIgnite
- Inspiration: Developed as an advanced modernization of AdvancedBan and LibertyBans.
- License: GNU General Public License v3.0 (GPL-3.0).
评论 0
登录后参与评分
还没有评论,来抢沙发吧