EnchancedBan

插件

· 作者 DarkIgnite

面向现代 Paper 服务器的下一代惩罚管理插件,采用绯红渐变样式、LibertyBans 风格的账号检测以及守卫分析功能。

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

最新 1.0.0 · 26.2 · Paper / Purpur

一键开服(送7天)

? 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)。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源