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

All in-game text is currently in **German**. The codebase uses standard Adventure components, so translation forks are straightforward — the chat-input cancel keyword is `abbrechen`.