? wapeB - 终极 Minecraft 处罚系统、AI 哨兵 & 开发者 API
最新版本:v1.0.13
wapeB 是一个现代、高性能的 Paper/Spigot 处罚管理系统,专为 Minecraft 1.18.2 – 1.21.x 构建,并完全支持 Velocity Proxy。它集成了高级处罚套件、基于 AI 的自动聊天审核、多服务器作用域、可扩展的数据库导入器框架、全面的 Java API、Bukkit 自定义事件、动态命令覆盖以及内置的 HTTP REST Web API。
✨ 主要功能
- ? 完整的处罚套件:Ban(封禁)、TempBan(临时封禁)、IP-Ban(IP 封禁)、Temp-IP-Ban(临时 IP 封禁)、Mute(静音)、TempMute(临时静音)、IP-Mute(IP 静音)、Temp-IP-Mute(临时 IP 静音)、Warn(警告)、Kick(踢出)、KickAll(全员踢出)、Freeze(冻结)和 Lockdown(锁定)。
- ? 可扩展的导入器与自动检测:一键自动化数据库/文件迁移,支持 LiteBans (SQLite/MySQL)、AdvancedBan (SQLite/MySQL) 和 Vanilla JSON (
banned-players.json,banned-ips.json)。 - ⚡ Velocity Proxy 支持与配套插件:通过
wapeb:channel实现即时跨服务器插件消息传递,并通过wapeb-velocity在代理层面执行断开连接操作。 - ? 证据与证明系统 (
/proof):通过命令 (-proof:<url>)、GUI、Webhook、Java API 或 REST,将可点击的截图/视频证据 URL 直接附加到处罚记录中。 - ? 自动聊天快照:内存中的循环缓冲区会在执行处罚时自动捕获并冻结相关的聊天记录,生成人类可读的 JSON 文件,并保留清理策略。
- ⚡ 快速处罚模板与快捷方式:提供快速的数字和自定义命令快捷方式(例如
/ban Player #1、/mute Player #spam、/warn Player #toxicity),并自动继承静默标志。 - ? 高级小号检测与豁免审计:检测通过 IP 或
/24子网关联的替代账号,并提供完整的审计日志 (exemptBy,exemptDate) 和白名单管理 (/alts,/altexempt)。 - ? 多服务器作用域 (
activeservervsserver):可针对特定服务器(如survival、server1,server2)进行操作,或应用于整个网络(global),同时保留来源服务器的审计轨迹。 - ? Sentinel AI 自动审核:支持多 API 密钥池与轮询故障转移,结合本地启发式预过滤和 Groq AI 聊天违规分析,实现零服务器延迟。
- ? 内置赛博朋克风格 Web 面板:现代化的霓虹/玻璃拟态 Web 界面,支持游戏内双因素认证 (2FA) 登录、Chart.js 统计图表以及实时处罚管理。
- ? 高级冻结 / 屏幕共享系统:在冻结状态下阻止移动、PvP、方块破坏和物品掉落,并强制执行登出。
- ? 服务器锁定模式 (
/lockdown):在维护或遭受机器人攻击时,立即限制服务器访问权限,支持自定义踢出消息。 - ⏱️ 智能动态时长:
%duration%会自动计算距离过期的确切剩余时间,并在实时显示中进行向上取整处理。 - ⚙️ 动态命令别名:通过
config.yml或运行时 API 自定义或翻译任何命令(例如/ban→/kitiltas,/mute→/nemit)。 - ? 开发者 Java API 与自定义事件:支持完整的事件取消、执行者名称覆盖、可扩展的导入器注册,以及与外部插件(如 DiscordSRV、SyncCord、自定义机器人)的无缝集成。
- ? 内置 HTTP REST Web API:支持使用
X-API-Key身份验证进行远程处罚管理,适用于 Web 仪表板和外部服务。 - ? 员工与玩家历史记录追踪:追踪员工表现 (
/staffhistory) 和玩家完整的处罚历史 (/history)。 - ? 多存储后端:支持 MySQL / MariaDB(HikariCP 连接池)、SQLite 和 YAML 存储。
? 命令与权限
| 命令 | 用法 | 描述 | 权限 |
|---|---|---|---|
/ban |
/ban <玩家/IP> [时间] [原因/#代码] [-s] [-server] [-proof:url] |
封禁或临时封禁一名玩家 | wapeb.ban |
/banip |
/banip <玩家/IP> [时间] [原因/#代码] [-s] [-server] [-proof:url] |
封禁 IP/CIDR 子网 | wapeb.banip |
| /mute | /mute <玩家/IP> [持续时间] [原因/#代码] [-s] [-server] [-proof:url] | 静音或临时静音一名玩家 | wapeb.mute |
| /muteip | /muteip <玩家/IP> [持续时间] [原因/#代码] [-s] [-server] [-proof:url] | 对一名玩家执行 IP 静音 | wapeb.muteip |
| /warn | /warn <player> [reason/#code] [-s] [-server] [-proof:url] | 警告一名玩家 | wapeb.warn |
| /kick | /kick <player> [reason/#code] [-s] [-server] [-proof:url] | 将一名玩家踢出服务器 | wapeb.kick |
| /kickall | /kickall [reason] | 踢出所有非工作人员玩家 | wapeb.kickall |
| /proof | /proof <set\|remove\|reset\|check> <id> [url] | 检查、设置或移除处罚证据链接 | wapeb.proof |
| /unban | /unban <player/ip> [reason] [-s] | 解禁一名玩家或 IP 地址 | wapeb.unban |
| /unmute | /unmute <玩家/IP地址> [原因] [-s] | 解除对玩家或 IP 地址的静音 | wapeb.unmute |
| /unwarn | /unwarn <玩家> [id/all] | 移除玩家的警告 | wapeb.unwarn |
| | /freeze | /freeze <玩家> [原因] | 冻结/解冻玩家以进行屏幕共享 | wapeb.freeze |
| | /checkban | /checkban <玩家/ip> | 检查当前的封禁状态 | wapeb.checkban |
| | /checkmute | /checkmute <玩家/ip> | 检查当前的静音状态 | wapeb.checkmute |
| /history | /history <玩家> | 查看玩家的完整处罚记录 | wapeb.history |
| /staffhistory | /staffhistory <工作人员> | 查看工作人员的处罚操作 | wapeb.staffhistory |
| /alts | /alts <player> | 查看通过 IP/CIDR 关联的替代账号 | wapeb.alts |
| /altexempt | /altexempt <player> [add/remove] | 将账号加入免检测白名单 | wapeb.altexempt |
| /lockdown | /lockdown [on/off] [reason] | 切换服务器锁定模式 | wapeb.lockdown |
| /punish-rollback | /punish-rollback <id> | 撤销特定处罚 | wapeb.rollback |
| /punish | /punish <player> | 打开处罚 GUI / 模板选择界面 | wapeb.punish |
| /wapeb | /wapeb <重载\|取消链接\|导入> | 主插件管理与导入命令 | wapeb.admin |
☕ 开发者 API & JitPack 设置
? 完整 API 参考: GitHub API 文档
Gradle (build.gradle)
repositories {
mavenCentral()
maven { url 'https://jitpack.io' }
}
dependencies {
compileOnly 'com.github.lftkraft:wapeB:v1.0.13-alpha.3'
}
Maven (pom.xml)
<dependencies>
<dependency>
<groupId>com.github.lftkraft</groupId>
<artifactId>wapeB</artifactId>
<version>v1.0.13-alpha.3</version>
<scope>provided</scope>
</dependency>
</dependencies>
Java API 示例
import dev.azuyo.wapeB.WapeB;
import dev.azuyo.wapeB.api.WapeBAPI;
WapeBAPI api = WapeB.getApi();
// 检查玩家或其小号是否被封禁
boolean isBanned = api.isBannedForPlayerOrAlt("PlayerName");
// 发出全网封禁并附带证据
api.banPlayer("PlayerName", "检测到作弊", "Console", 86400000L, false, false, "global", "lobby", "https://youtu.be/proof123");
// 发出仅限服务器的静音处罚
api.mutePlayer("PlayerName", "聊天刷屏", "Admin", 3600000L, false, false, "survival");
// 使用预定义模板快速处罚
api.punishWithTemplate(targetUuid, "ban", "cheating", "Admin", false);
? HTTP REST Web API
wapeB 包含一个内置的 HTTP REST 服务器,用于远程 Web 仪表板和外部机器人。
- 认证头部:
X-API-Key: YOUR_API_KEY_HERE GET /api/player/checkban?player=PlayerNameGET /api/player/checkmute?player=PlayerNameGET /api/player/punishments?player=PlayerNameGET /api/punish/activeGET /api/punish/proof?id=105GET /api/punish/snapshot?id=105GET /api/player/recentchat?player=PlayerName&limit=30GET /api/import/sourcesPOST /api/import/executeGET /api/altexempt/listGET /api/altexempt/check?player=PlayerNamePOST /api/altexempt/setGET /api/templates/listGET /api/templates/get?key=cheatingPOST /api/templates/savePOST /api/templates/deletePOST /api/punish/execute(支持active_server、origin_server、proof)POST /api/punish/removePOST /api/lockdown
? 兼容性与支持
- Discord 社区: dc.coolnw.eu
- 支持平台: Paper、Purpur、Spigot(1.18.2 – 1.21.x)及 Velocity 代理
- Java 要求: Java 17+
- 源代码与问题追踪器: GitHub 仓库
- Minecraft 惩罚插件,免费的 LiteBans 替代品,Velocity 封禁插件,Paper 封禁插件,AI 聊天审核,冻结屏幕共享插件,Minecraft REST API 惩罚
? wapeB - Ultimate Minecraft Punishment System, AI Sentinel & Developer API
newest: v1.0.13
wapeB is a modern, high-performance Paper/Spigot punishment management system built for Minecraft 1.18.2 – 1.21.x with full Velocity Proxy support. It combines an advanced punishment suite, AI-powered automatic chat moderation, multi-server scoping, an extensible database importer framework, a comprehensive Java API, Bukkit Custom Events, dynamic command overrides, and a built-in HTTP REST Web API.
✨ Key Features
- ? Complete Punishment Suite: Ban, TempBan, IP-Ban, Temp-IP-Ban, Mute, TempMute, IP-Mute, Temp-IP-Mute, Warn, Kick, KickAll, Freeze, and Lockdown.
- ? Extensible Importers & Auto-Detection: One-click automated database/file migration for LiteBans (SQLite/MySQL), AdvancedBan (SQLite/MySQL), and Vanilla JSON (
banned-players.json,banned-ips.json). - ⚡ Velocity Proxy Support & Companion Plugin: Instant cross-server plugin messaging (
wapeb:channel) and proxy-level disconnects withwapeb-velocity. - ? Evidence & Proof System (
/proof): Attach clickable screenshot/video proof URLs directly to punishments via commands (-proof:<url>), GUI, Webhook, Java API, or REST. - ? Automated Chat Snapshots: In-memory rolling buffer automatically captures and freezes relevant chat history upon punishment into human-readable JSON files with retention cleanup.
- ⚡ Quick-Punish Templates & Shortcuts: Fast numeric and custom command shortcuts (e.g.
/ban Player #1,/mute Player #spam,/warn Player #toxicity) with automatic silent flag inheritance. - ? Advanced Alt-Account & AltExempt Audit: Detect alternative accounts linked by IP or
/24subnets with full audit logging (exemptBy,exemptDate) and whitelist management (/alts,/altexempt). - ? Multi-Server Scoping (
activeservervsserver): Target specific servers (survival,server1,server2) or apply network-wide (global), while preserving the origin server audit trail. - ? Sentinel AI Auto-Moderation: Multi-API key pool with round-robin failover, local heuristic pre-filtering, and Groq AI chat violation analysis with zero server lag.
- ? Included Cyberpunk Web Panel: A modern Neon/Glassmorphism web interface with in-game 2FA login, Chart.js statistics, and live punishment management.
- ? Advanced Freeze / Screenshare System: Prevents movement, PvP, block breaking, and item drops while frozen, with automatic logout enforcement.
- ? Server Lockdown Mode (
/lockdown): Instantly restrict server entry during maintenance or bot raids with customizable kick messages. - ⏱️ Smart Dynamic Duration:
%duration%automatically calculates the exact remaining time until expiration in real time with ceiling rounding. - ⚙️ Dynamic Command Aliases: Customize or translate any command (e.g.
/ban→/kitiltas,/mute→/nemit) viaconfig.ymlor runtime API. - ? Developer Java API & Custom Events: Full event cancellation, executor name overrides, extensible importer registration, and seamless integration for external plugins (DiscordSRV, SyncCord, custom bots).
- ? Built-in HTTP REST Web API: Remote punishment administration with
X-API-Keyauthentication for web dashboards and external services. - ? Staff & Player History Tracking: Track staff member performance (
/staffhistory) and full player punishment history (/history). - ? Multi-Storage Backend: Supports MySQL / MariaDB (HikariCP connection pool), SQLite, and YAML storage.
? Commands & Permissions
| Command | Usage | Description | Permission |
|---|---|---|---|
/ban |
/ban <player/ip> [time] [reason/#code] [-s] [-server] [-proof:url] |
Ban or Temp-Ban a player | wapeb.ban |
/banip |
/banip <player/ip> [time] [reason/#code] [-s] [-server] [-proof:url] |
IP/CIDR Subnet Ban | wapeb.banip |
/mute |
/mute <player/ip> [time] [reason/#code] [-s] [-server] [-proof:url] |
Mute or Temp-Mute a player | wapeb.mute |
/muteip |
/muteip <player/ip> [time] [reason/#code] [-s] [-server] [-proof:url] |
IP-Mute a player | wapeb.muteip |
/warn |
/warn <player> [reason/#code] [-s] [-server] [-proof:url] |
Warn a player | wapeb.warn |
/kick |
/kick <player> [reason/#code] [-s] [-server] [-proof:url] |
Kick a player from the server | wapeb.kick |
/kickall |
/kickall [reason] |
Kick all non-staff players | wapeb.kickall |
/proof |
/proof <set|remove|reset|check> <id> [url] |
Inspect, set, or remove punishment evidence URL | wapeb.proof |
/unban |
/unban <player/ip> [reason] [-s] |
Unban a player or IP address | wapeb.unban |
/unmute |
/unmute <player/ip> [reason] [-s] |
Unmute a player or IP address | wapeb.unmute |
/unwarn |
/unwarn <player> [id/all] |
Remove warnings from a player | wapeb.unwarn |
/freeze |
/freeze <player> [reason] |
Freeze/unfreeze player for screenshare | wapeb.freeze |
/checkban |
/checkban <player/ip> |
Inspect active ban status | wapeb.checkban |
/checkmute |
/checkmute <player/ip> |
Inspect active mute status | wapeb.checkmute |
/history |
/history <player> |
View full punishment history of a player | wapeb.history |
/staffhistory |
/staffhistory <staff> |
View staff member punishment actions | wapeb.staffhistory |
/alts |
/alts <player> |
View alternative accounts linked by IP/CIDR | wapeb.alts |
/altexempt |
/altexempt <player> [add/remove] |
Whitelist accounts from alt detection | wapeb.altexempt |
/lockdown |
/lockdown [on/off] [reason] |
Toggle server lockdown mode | wapeb.lockdown |
/punish-rollback |
/punish-rollback <id> |
Undo specific punishment | wapeb.rollback |
/punish |
/punish <player> |
Open punishment GUI / template selection | wapeb.punish |
/wapeb |
/wapeb <reload|unlink|import> |
Main plugin management & import command | wapeb.admin |
☕ Developer API & JitPack Setup
? Full API Reference: GitHub API Documentation
Gradle (build.gradle)
repositories {
mavenCentral()
maven { url 'https://jitpack.io' }
}
dependencies {
compileOnly 'com.github.lftkraft:wapeB:v1.0.13-alpha.3'
}
Maven (pom.xml)
<dependencies>
<dependency>
<groupId>com.github.lftkraft</groupId>
<artifactId>wapeB</artifactId>
<version>v1.0.13-alpha.3</version>
<scope>provided</scope>
</dependency>
</dependencies>
Java API Example
import dev.azuyo.wapeB.WapeB;
import dev.azuyo.wapeB.api.WapeBAPI;
WapeBAPI api = WapeB.getApi();
// Check if a player or alt account is banned
boolean isBanned = api.isBannedForPlayerOrAlt("PlayerName");
// Issue a network-wide ban with proof attachment
api.banPlayer("PlayerName", "Cheating detected", "Console", 86400000L, false, false, "global", "lobby", "https://youtu.be/proof123");
// Issue a server-specific mute
api.mutePlayer("PlayerName", "Chat Spam", "Admin", 3600000L, false, false, "survival");
// Quick-punish with pre-defined template
api.punishWithTemplate(targetUuid, "ban", "cheating", "Admin", false);
? HTTP REST Web API
wapeB includes a built-in HTTP REST server for remote web dashboards and external bots.
- Authentication Header:
X-API-Key: YOUR_API_KEY_HERE GET /api/player/checkban?player=PlayerNameGET /api/player/checkmute?player=PlayerNameGET /api/player/punishments?player=PlayerNameGET /api/punish/activeGET /api/punish/proof?id=105GET /api/punish/snapshot?id=105GET /api/player/recentchat?player=PlayerName&limit=30GET /api/import/sourcesPOST /api/import/executeGET /api/altexempt/listGET /api/altexempt/check?player=PlayerNamePOST /api/altexempt/setGET /api/templates/listGET /api/templates/get?key=cheatingPOST /api/templates/savePOST /api/templates/deletePOST /api/punish/execute(supportsactive_server,origin_server,proof)POST /api/punish/removePOST /api/lockdown
? Compatibility & Support
- Discord Community: dc.coolnw.eu
- Supported Platforms: Paper, Purpur, Spigot (1.18.2 – 1.21.x) & Velocity Proxy
- Java Requirement: Java 17+
- Source Code & Issue Tracker: GitHub Repository
- minecraft punishment plugin, free litebans alternative, velocity ban plugin, paper ban plugin, ai chat moderation, freeze screenshare plugin, minecraft rest api punishment
下载 wapeB
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 wapeB
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 wapeB
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 wapeB
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 wapeB
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 wapeB
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 wapeB
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 wapeB
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 wapeB
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
兼容 wapeb-velocity 1.0.1(或更高版本)。
? alpha.1-1.0.14 更新内容
? 1. 集中式处罚管道与主线程安全
- 中央
PunishmentService架构: 将输入验证和数据库 I/O 从 Bukkit 引擎调用中解耦。实现了清晰的三阶段执行生命周期:异步验证 → 数据库持久化 → 主线程分发。 - 零异步 Bukkit 异常: 所有 Bukkit 副作用(
Bukkit.getOfflinePlayer、PlayerPunishEvent、Bukkit.broadcast、player.kick、插件消息、物品栏和计分板)均通过调度器同步严格在主线程上分发,防止在 Paper 和 Purpur 上出现IllegalStateException崩溃。 - 统一 API 路由:
WapeBAPIImpl中的所有处罚和解罚操作现在都直接通过PunishmentService进行路由。
⏱️ 2. 严格的持续时间解析器与复合时间支持
- 多单位复合持续时间:
TimeUtil现在完全解析复杂的组合时间单位(例如1d12h30m、2w3d5h、45m30s)。 - 拼写保护(零意外永久封禁): 消除了不可解析输入(如
/ban Player 1x reason)上的旧版-1回退机制。无效语法现在返回Optional.empty(),清晰地警告执行者并中止处罚创建。 - 显式永久关键字: 永久处罚现在严格要求使用显式关键字(
permanent、perm或在永久命令变体中省略持续时间)。
? 3. 数据库生成的自增 ID 与竞态条件消除
- 原生数据库序列: 用原生数据库生成的键替换了客户端
getNextId()的竞态条件(MySQL/MariaDB 上的AUTO_INCREMENT,SQLite 上通过RETURN_GENERATED_KEYS实现的AUTOINCREMENT)。 - 多服务器安全: 消除了多代理或高并发环境中的行覆盖和重复 ID 冲突。
- 不可变处罚构建器模式: 在核心代码库中添加了
Punishment.builder()和复制构造函数,以消除位置参数混淆。
? 4. 强大的 IP 和 CIDR 子网引擎(IPv4 和 IPv6)
- 严格的八位字节范围检查: 用数字八位字节验证(
0–255)替换了有缺陷的正则表达式匹配,防止无效输入如999.999.999.999。 - 完整的 IPv6 支持: 在所有基于 IP 的处罚和验证例程中添加了原生 IPv6 地址匹配。
- 离线 CIDR 计算: 子网匹配现在直接通过位运算计算,而不会触发阻塞的 DNS 主机名解析。
? 5. 修复 IP 范围和子网解封 (/unbanip)
- 专用
unbanIpPunishmentAPI: 修复了以前无法工作的 IP 范围解封问题,其中引擎调用了unbanPlayer((UUID) null, ...)。 - 准确的范围停用:
/unbanip <range>现在识别目标 IP 处罚并在数据库中停用确切的记录,包括审计跟踪和解封事件。
? 6. 加固 REST Web API 与安全重构
- 默认绑定到本地主机: Web API 现在默认安全地绑定到
127.0.0.1,而不是在0.0.0.0上暴露端点。 - 基于头的身份验证: 弃用查询字符串凭据,改用标准的
Authorization: Bearer <token>头。 - 身份欺骗预防: API 端点严格从经过身份验证的会话派生
admin_uuid和工作人员凭据;拒绝客户端提供的覆盖 UUID。 - HTTP 方法强制与速率限制: 强制执行严格的
POST/GET方法、结构化 JSON 模式验证以及对敏感端点的 IP 速率限制。 - 审计日志记录: 每个修改性的 Web API 操作都会自动记录到中央审计日志系统中。
- 清洁的生命周期管理: 边界线程执行器保证在插件关闭期间(
onDisable)干净地终止。
? 7. 线程安全与原子 YAML 存储
- 原子文件写入:
YamlDataManager和PlayerDataManager现在将更改写入临时文件(.tmp),并通过StandardCopyOption.ATOMIC_MOVE替换数据,消除突然崩溃期间的文件损坏风险。 - 线程同步: 所有 YAML 读写都由可重入锁(
ReentrantLock)保护。 - 活动服务器作用域: 通过在 YAML 存储中正确映射
active_server而不是回退到本地server名称,修复了服务器作用域问题。 - 有限的 IP 历史记录: 将玩家 IP 历史记录记录限制为最近 50 个唯一地址。
? 8. 自定义 GUI 持有者与精确库存点击处理
- 自定义
PunishInventoryHolder: 用专用的库存持有者替换了脆弱 GUI 标题字符串解析,该持有者存储目标玩家 UUID 和槽位到动作的绑定。 - 准确的槽位映射: 修复了点击任何库存槽位都会触发第一个配置项的错误;点击现在执行与点击槽位绑定的确切动作。
? 9. 持久冻结系统 (frozen_players.yml)
- 跨重启持久性: 冻结的玩家状态现在持久保存到
plugins/wapeB/frozen_players.yml,使玩家在服务器重载和重启时保持冻结状态。 - 完全交互锁定: 严格禁止冻结玩家移动、跳跃、聊天、破坏/放置方块、掉落/拾取物品以及执行未授权命令。
? 10. Sentinel AI 自动静音安全与审计集成
- API 管道路由: 由 Sentinel AI 触发的自动静音现在通过
PunishmentService路由,而不是使用占位符-1ID 保存,确保所有广播、Discord 和快照钩子都能触发。 - 重复静音预防: 在自动静音之前添加了活动静音验证检查,以防止重叠处罚。
- 审计跟踪: AI 自动静音以完整的上下文记录在数据库审计日志中。
? 11. 封禁与解除禁言的完全静默标志(-s)传播
- 端到端静默解除处罚:
/unban、/unmute和/unbanip中的-s标志现在可通过PunishmentService正确传播。 - 抑制广播与 Webhook: 在解除处罚时,员工广播、全局广播消息以及 Discord webhook 警报均严格遵循静默标志。
? 12. 交互式游戏内分页系统
- 交互式聊天导航: 添加了
PaginationUtil,带有可点击的 MiniMessage 导航页脚(« Prev (X/Y) Next »),支持交互式悬停工具提示和点击执行命令。 - 集成命令: 统一了
/history、/warnings、/banlist、/staffhistory和/alts的分页功能。
?️ 13. 登录与登出监听器增强
- 异步登录小号验证: 玩家登录期间的小号检查和 IP 检查现改为异步运行,同时在登录管道中安全地保留接受或踢出的决定。
- 登出处罚生命周期:
PlayerQuitListener的操作(例如记录战斗退出静音/封禁)现在通过中央处罚管道路由,包含快照和事件。
⚡ 14. 全面的插件重载与凭据解绑
/wapeb reload上的完整缓存失效: 完全重新加载配置文件、语言键、Sentinel AI 模型、Lockdown 状态、Web API 实例和动态命令别名,且不会创建重复映射。/wapeb unlink上的凭据清理: 运行/wapeb unlink <player>现在会从数据库中清除活动的 Web 会话以及哈希化的 Web 仪表板密码。
? 15. 受限网络 I/O 与外部客户端加固
- 受限 Webhook 分发器: 使用受限的
ThreadPoolExecutor、5 秒套接字超时和安全关闭钩子替换了无限制的线程创建。 - 安全的 GeoIP 引擎: 使用安全的 HTTPS(
https://ipwho.is/)、内存 LRU/TTL 缓存和受限异步线程现代化改造了GeoIPUtil。 - Groq AI 客户端增强: 为 Groq API 请求添加了严格的连接(5 秒)和读取(15 秒)超时,并将重试调度从 Bukkit 主循环中解耦。
⌨️ 16. 统一的命令套件、Tab 补全与权限
- 临时命令家族: 在所有临时处罚命令(
/tempban、/tempbanip、/tempmute、/tempipmute、/tempshadowmute、/tempipshadowmute)中强制执行强制性的持续时间参数。 - 统一 Tab 补全器: 添加了
PunishmentTabCompleter,为玩家名称、持续时间预设、模板快捷代码(#)、证据标志(-proof:)和静默标志(-s)提供实时 Tab 补全。 - 清单清理: 声明了缺失的权限(
wapeb.import、wapeb.admin)并清理了plugin.yml中重复的命令定义。
兼容 wapeb-velocity 1.0.1(或更高版本)。
? v1.0.13 更新内容
? 1. ShadowMute 与 IP-ShadowMute 系统
- 隐身禁言: 完全支持
SHADOWMUTE、TEMPSHADOWMUTE、IPSHADOWMUTE和TEMPIPSHADOWMUTE。被处罚的玩家看到的消息仿佛正常发送,而服务器的其余部分则屏蔽了他们的消息。 - 命令与别名: 添加了
/shadowmute(别名:/smute)、/tempshadowmute(别名:/tempsmute)、/ipshadowmute和/tempipshadowmute。 - 工作人员窃听提醒: 拥有权限(
wapeb.shadowmute.notify或wapeb.notify.punishment)的工作人员在隐身禁言玩家发言时,会收到包含实际消息内容的实时通知。 - 统一解除禁言: 标准的
/unmute和/unipmute命令会自动检测并移除活跃的隐身禁言状态,无需使用单独的命令。 - 开发者 API: 添加了用于隐身禁言的完整 API 方法(
shadowMutePlayer、unshadowMutePlayer、getActiveShadowMute)。
? 2. 交互式小号账号加入提醒
- 加入检测: 当玩家使用关联的小号加入服务器时,工作人员现在可以收到警报(
alts.alert-on-join.enabled)。 - Rich MiniMessage UI: 完全自定义的加入通知,支持点击运行(
/alts %player%)以及显示每个小号当前状态的交互式悬停提示框([BANNED]、[MUTED]、[ONLINE]、[CLEAN])。 - 动态占位符: 添加了
%total_alts_count%、%banned_alts_count%、%muted_alts_count%、%alts%和%alts_hover%。
?️ 3. 智能 IP 处罚隔离
- 严格的非 IP 处罚隔离: 修复了数据库查找逻辑,使标准的非 IP 禁言/封禁仅通过玩家 UUID 进行匹配。同一 IP 网络上的其他账户绝不会受到误罚。
- 专用 IP 匹配处理器: 只有明确创建为基于 IP 的处罚(
IPBAN、IPMUTE、IPSHADOWMUTE等)才会在共享网络地址上应用 IP 匹配。
? 4. 针对 IP 处罚的准确尝试通知
- 真实的尝试登录玩家显示: 当受罚 IP 上的小号尝试登录(
ban-attempt)或聊天(mute-attempt/shadowmute-attempt)时,通知现在显示实际的尝试登录玩家名称(%player%),而不是最初被处罚的记录。 - 独立的冷却时间: 警报冷却计时器现在按连接玩家的唯一 UUID 进行跟踪。
? 5. /checkmute 与 /checkban 中查询目标的显示
- 准确的查找标题:
/checkmute <player>和/checkban <player>的标题和详细信息现在正确显示搜索玩家的名称于%player%和%target%中。 - 小号检测通知: 添加了
%alt_notice%和%punished_player%占位符,以清楚地指示处罚是否源自小号/IP 链接。
⚡ 6. 热重载安全的动态命令
- 命令处理器修复: 动态注册的和别名的命令(如
/smute)现在能够在重新加载后干净地重新绑定到活动的插件实例,而不会抛出已禁用插件的CommandException错误。
? 7. 多 API 密钥池与轮询轮换(Sentinel AI)
- 多密钥支持: 在
config.yml中添加了groq-api-keys列表支持。聊天分析请求现在自动在多个 Groq API 密钥之间以轮询方式分配,以扩展每分钟请求数(RPM)。 - 即时 429 故障转移: 如果某个密钥达到速率限制(
429 Too Many Requests),系统将自动无缝切换到池中下一个可用的 API 密钥,延迟为零。
⚡ 8. 智能本地启发式预过滤(Sentinel AI)
- 节省配额的预过滤器: 添加了
sentinel.ai.pre-filter,可在本地跳过琐碎、无害的闲聊,耗时 0 毫秒(节省 50–70% 的 API 配额)。 - 自动模式过滤: 自动忽略简短的闲聊(少于 3 个字符,如
k、xd、?)、坐标/数字(100 64 -200、500k)、标点符号/表情符号(???、:)、:D、^^)以及常见的无害游戏术语(gg、wp、ez、szia、oks、ty等)。
?️ 9. 提示注入与越狱保护(Sentinel AI)
- 加固的系统提示词: 注入的安全规则确保 AI 将玩家制作的绕过指令(例如 "ignore previous instructions"、"do not mute"、自定义 JSON 覆盖)严格视为纯文本,防止 LLM 被操纵。
? 10. 上下文感知的聊天历史记录分析(Sentinel AI)
- 聊天上下文集成: 添加了
sentinel.ai.context-lines(默认值:5),以提供来自ChatSnapshotManager的近期对话历史。AI 现在可以准确评估多行争论和上下文毒性。 - 优化的默认模型: 默认切换至
llama-3.1-8b-instant,以实现超低延迟和慷慨的免费层每日速率限制(14,400 RPD)。
? 11. 可扩展的导入器系统与游戏内命令
- 一键自动化导入器: 无缝地将现有处罚数据从流行插件迁移到 wapeB,同时保留完整的历史记录和活跃处罚状态:
- LiteBans: 从 SQLite(
litebans.sqlite)或外部 MySQL/MariaDB 数据库导入封禁、禁言、警告和踢出记录。 - AdvancedBan: 从 SQLite(
AdvancedBan.db/saved.db)或 MySQL 导入处罚和计算记录。 - Vanilla Minecraft JSON: 自动转换原生
banned-players.json和banned-ips.json,并计算持续时间和过期时间。
- LiteBans: 从 SQLite(
- 智能数据库自动检测: 运行
/wapeb import litebans或/wapeb import advancedban会自动检查源配置文件,并直接连接到 MySQL/MariaDB,无需任何手动连接字符串。 - 游戏内命令与 API: 添加了
/wapeb import <source>,支持实时进度报告、可扩展的 Java API(WapeBAPI#registerImporter)以及 REST API 端点(/api/import/sources、/api/import/execute)。
? 12. AltExempt 扩展审计系统与 REST API
- 完整审计追踪: 小号豁免记录现在持久化存储审计元数据,追踪谁授予了豁免(
exemptBy)以及确切的时间戳(exemptDate)。 - Java API 集成: 添加了
WapeBAPI#getAllAltExempts()、WapeBAPI#getAltExemptDetails(UUID/player)和WapeBAPI#setAltExempt(...),返回完整的AltExemptInfo审计对象。 - 远程 REST API 管理:
GET /api/altexempt/list– 查询所有当前被豁免的小号账号及其时间戳和颁发者。GET /api/altexempt/check?player=<name>– 即时检查目标是否被豁免为小号。POST /api/altexempt/set– 从外部 Web 仪表板和 Discord 机器人以编程方式添加或撤销小号豁免。
⚡ 13. 快速处罚模板与快捷系统
- 命令快捷方式: 工作人员现在可以使用快速数字和自定义快捷码来处罚玩家(例如
/ban Player #1、/mute Player #spam、/warn Player #toxicity)。 - 静默标志继承: 在
templates.yml中配置为silent: true的模板会自动以静默模式执行,无需工作人员手动附加-s。 - 运行时模板管理 API: 通过
WapeBAPI#saveTemplate(...)、WapeBAPI#deleteTemplate(...)和WapeBAPI#findTemplate(...)以编程方式管理模板。 - REST API 端点: 添加了
GET /api/templates/list、GET /api/templates/get、POST /api/templates/save和POST /api/templates/delete。
? 14. 自动聊天快照系统
- 内存滚动缓冲区: 自动跟踪最后 300 条全局聊天消息,具有纳秒级精度和玩家上下文信息。
- 事件快照创建: 在执行处罚时,自动捕获并持久化相关的聊天历史记录到格式化的、人类可读的 JSON 文件(
plugins/wapeB/snapshots/<id>.json)。 - 人类可读格式: 快照现在包含格式化日期(
created_date)、每条消息的时间戳(time,date)和一个直接的chat_log字符串数组,方便工作人员检查。 - 灵活的保留策略: 添加了小时和天数的保留清理(
retention: "1h","12h","7d","30d"),每 15 分钟异步运行,对服务器刻无影响。 - 离线交付队列: 后端服务器安全地将快照排队存储在
pending_snapshots/中,并在玩家加入时自动刷新到 Velocity。
? 15. 综合证据系统
- 新增
/proof命令: 添加了/proof <set|remove|reset|check> <id> [url],支持完整的 Tab 补全。 - 处罚命令标志: 所有处罚命令都直接接受
-proof:<url>(例如/mute Player 1h Toxicity -proof:)。 - 干净的 clickable 链接: 聊天中的证据链接(
/checkban、/checkmute、/proof check)可以干净地点击,并支持打开浏览器。 - 完整生态系统集成: 证据链接无缝显示在 GUI 菜单、Discord Webhooks、Java API 和 REST Web API(
/api/punish/proof)中。
? 16. 自动配置文件与语言文件同步 (Auto-Sync)
- 无缝升级: 更新插件 jar 现在会自动扫描并将所有新引入的配置部分和消息键合并到磁盘上的现有文件中。
- 保留自定义设置: 现有的自定义消息、前缀和数据库凭据保持 100% 不变。
- 缺失键回退: 安全的默认语言字符串回退可防止任何缺失消息错误。
- 完整本地化刷新: 更新了所有 11 种内置语言文件(
hu,en,de,fr,es,pt,ru,ro,da,sv,custom),采用干净的 UTF-8 编码。
? 17. 多服务器范围限定与 Velocity 代理支持
- 多服务器范围限定 (
activeservervsserver):activeserver: 处罚生效的目标范围(global、survival或server1,server2)。server: 执行处罚命令的源服务器。- 自动 MySQL & SQLite 架构迁移。
- 官方 Velocity 伴侣插件 (
wapeb-velocity): 即时跨服务器数据包同步,零数据库轮询延迟和代理级断开连接。 - 广播范围限定: 添加了
broadcast.show-remote-punishments配置。 - 开发者 Java 和 REST API 重构: 在 API 方法和
/api/punish/execute中全面支持activeServer和server。
? 18. 线程安全与历史增强
- 异步事件与线程安全:
PlayerPunishEvent、PlayerUnpunishEvent、PlayerFreezeEvent、PlayerUnfreezeEvent和LockdownToggleEvent动态检测调用线程上下文,解决 Paper/Purpur 上的IllegalStateException。 - 智能历史排序与分页: 保证最新优先顺序(第 1 页上的 #17、#16),带有动态页面跟踪(
(%page%/%max_page%))和%total%占位符。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧