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

- Warnings — with a custom reason shown to the player - Warnings — runs the vanilla ban behind the scenes - Warnings — durations like `30s`, `10m`, `1h`; muted players' messages are silently cancelled - Warnings — 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

- Java: Paper 26.1.2 (or compatible builds) - Java: 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: German (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.