AdminAbuse

# AdminAbuse A GUI-based admin dashboard for Paper servers — moderation tools and a built-in troll menu, all driven by inventory menus instead of typed commands. ## Overview AdminAbuse gives operators a single command, `/admin`, that opens a paginated dashboard of every online player. Click any player head to access kick, ban, chat-timeout, warn, warn-history, and troll actions. Reasons are collected through chat prompts — no command syntax to memorize. The plugin also ships with a separate `/troll <player>` menu containing 40+ harmless prank effects, useful for community events, April Fool's, or simply messing with friends in a controlled way. Every effect cleans itself up automatically. ## Features ### Admin Dashboard (`/admin`) - Paginated grid of all online players with live info (ping, world, gamemode, warn count, mute status) - Click any player head to open the per-player action menu - Reasons (kick / ban / warn) and durations (mute) are typed in chat — type `abbrechen` (German for *cancel*) to abort an action ### Moderation - **Kick** — with a custom reason shown to the player - **Ban** — runs the vanilla ban behind the scenes - **Chat Timeout (Mute)** — durations like `30s`, `10m`, `1h`; muted players' messages are silently cancelled - **Unban / Unmute** — a single action that lifts both - **Warnings** — issue a warning, view the full history with timestamps and the issuing admin's name, and clear all warnings for a player All warning and mute data persists across restarts in `plugins/AdminAbuse/players.json`. ### Troll Menu (`/troll <player>`) Over 40 non-destructive effects across four themes: **Player Status** Nausea, Blindness, Slowness, Jump Boost, Levitation, Giant / Mini scale, Empty / Full hunger, Sleep pose, Swim loop, Backwards walk **Inventory Tricks** (auto-restored after 30 seconds) Potato / Dirt / Egg inventory, Lucky Block items, +1 to every stack, "Diamond" naming chaos, full inventory shuffle **World Manipulation** Ice floor, cobweb cage, fake lightning, snow storm, water-column particles — all original blocks return automatically **Mobs & Sounds** Chicken rain, cat stalking, vindicator jumpscare, bee swarm, creeper / wither / enderman / ghast / TNT sounds, random teleport, ender-style multi-TP, mount pig **UI / Chat** Action-bar spam, title spam, fake bossbar, fake OP message ### Safety & Cleanup - Effects last roughly 30 seconds and revert on their own - During an inventory swap, players cannot drop, place, break, or eat the fake items - Saved world blocks cannot be broken while the troll is active and are restored on schedule - On player disconnect, death, or plugin disable / reload, all troll state is reverted: real inventories returned, original blocks placed back, temporary mobs despawned - No troll effect deals damage; nothing persists past the duration ## Commands | Command | Description | Permission | |---|---|---| | `/admin` | Opens the admin dashboard | `adminabuse.use` | | `/troll <player>` | Opens the troll menu for a target | `adminabuse.troll` | ## Permissions | Permission | Description | Default | |---|---|---| | `adminabuse.use` | Access to the admin dashboard | `op` | | `adminabuse.troll` | Access to the troll menu | `op` | ## Installation 1. Download the latest `AdminAbuse-x.x.jar` 2. Drop it into your server's `plugins/` folder 3. Start (or restart) the server 4. Run `/admin` in-game as an operator — no configuration file required ## Compatibility - **Server**: Paper 26.1.2 (or compatible builds) - **Minecraft**: 26.1.2 - **Java**: 25 or newer The plugin uses the modern Paper API (`AsyncChatEvent`, Adventure components, attribute scaling) and will not run on Spigot or older Bukkit forks. ## Language Two languages ship out of the box: **English** (default) and **German**. Pick the active language by editing `plugins/AdminAbuse/config.yml`: ```yaml language: en # or 'de' ``` Custom translations: drop a `lang/<code>.yml` (e.g. `lang/fr.yml`) into the plugin folder and set `language: fr`. Missing keys fall back to German. The chat-input cancel keyword is locale-specific (`cancel` in English, `abbrechen` in German) — read from the active language file.