wapeb

🔨 wapeB - Ultimate Minecraft Punishment System, AI Sentinel & Developer API

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, 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.
• ⚡ Velocity Proxy Support & Companion Plugin: Instant cross-server plugin messaging (wapeb:channel) and proxy-level disconnects with wapeb-velocity.
• 🌐 Multi-Server Scoping (activeserver vs server): Target specific servers (survival, server1,server2) or apply network-wide (global), while preserving the origin server audit trail.
• 🤖 Sentinel AI Auto-Moderation: Integrates with Groq AI to detect toxicity, swearing, and chat violations automatically in real time 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) via config.yml or runtime API.
• 🔌 Developer Java API & Custom Events: Full event cancellation, executor name overrides, and seamless integration for external plugins (DiscordSRV, SyncCord, custom bots).
• 🌐 Built-in HTTP REST Web API: Remote punishment administration with X-API-Key authentication for web dashboards and external services.
• 📜 Staff & Player History Tracking: Track staff member performance (/staffhistory) and full player punishment history (/history).
• 👥 Advanced Alt-Account & CIDR Detection: Detect alternative accounts linked by IP or /24 subnets with whitelist exemption support (/alts, /altexempt).
• 💾 Multi-Storage Backend: Supports MySQL / MariaDB (HikariCP connection pool), SQLite, and YAML storage.

📜 Commands & Permissions

☕ 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.1'
}

Maven (pom.xml)

<dependencies>
    <dependency>
        <groupId>com.github.lftkraft</groupId>
        <artifactId>wapeB</artifactId>
        <version>v1.0.13-alpha.1</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
api.banPlayer("PlayerName", "Cheating detected", "Console", 86400000L, false, false, "global");

// Issue a server-specific mute
api.mutePlayer("PlayerName", "Chat Spam", "Admin", 3600000L, false, false, "survival");

🌐 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=PlayerName
• GET /api/player/checkmute?player=PlayerName
• GET /api/player/punishments?player=PlayerName
• GET /api/punish/active
• POST /api/punish/execute (supports active_server & origin_server)
• POST /api/punish/remove
• POST /api/lockdown

📜 Compatibility & Support

• Supported Platforms: Paper, Purpur, Spigot (1.18.2 – 1.21.x) & Velocity Proxy
• Java Requirement: Java 17+
• Source Code & Issue Tracker: GitHub Repository