BetterAdmin

Tired of juggling half a dozen admin plugins just to kick, ban, mute, and keep tabs on players? BetterAdmin puts it all behind one GUI — click a player, pick an action, done. No memorizing command syntax for your whole staff team.

Compatibility: Paper, Minecraft 26.2, Java 25.

Features

• Player management GUI with pagination for large servers
• Kick, ban, temp-ban, mute, unmute — bans are profile/UUID-based, not name-based, so they stick even if a player changes their name
• Confirmation step before ban/tempban actions to prevent misclicks
• Inventory viewer and ender chest viewer
• Teleport, heal, feed, and freeze/unfreeze toggle
• Staff vanish mode
• Player lookup by name or UUID (works for offline players too — ban/tempban still available)
• Recent admin action history with one-click undo for bans, mutes, and freezes
• History, mutes, and freezes persist across restarts (data.yml)
• Reload config without restarting: /adminpanel reload
• Every player-facing message and permission node key is configurable via config.yml

Using the GUI

1. Run /adminpanel to open the player list.
2. Click a player to open their action menu: kick, ban, tempban, mute, unmute, freeze/unfreeze, teleport, heal, feed, view inventory, view ender chest, player info, or vanish (for yourself).
3. Actions that need input (ban/kick reason, mute or tempban duration, or a name/UUID lookup) prompt you to type the value in chat — type default on a reason prompt to use the standard message.
4. Ban and tempban ask for a confirmation click before they go through.
5. Open Recent admin history from the main menu to see the latest actions and undo a ban, mute, or freeze with one click.

Looking up an offline player works too — you'll only be able to ban/tempban them, since actions like teleport or inventory viewing need them online.

Configuration

BetterAdmin creates plugins/BetterAdmin/config.yml on first startup. Edit it and run /adminpanel reload to apply changes without restarting.

messages:
  only-player: "Only in-game players can use this command."
  no-permission: "You do not have permission to open the admin panel."
  player-offline: "That player is not online or could not be found."
  refresh-success: "Admin menu refreshed."
  reason-prompt: "Type the reason in chat and press enter. Type 'default' to use the standard reason."
  mute-prompt: "Type mute duration and optional reason in chat, e.g. 10m Spamming."
  tempban-prompt: "Type tempban duration and optional reason in chat, e.g. 1d Griefing."
  lookup-prompt: "Type the player name or UUID to look up in chat."
  lookup-failed: "Unable to resolve that player name or UUID."
  action-complete: "{actor} performed {action} on {target}."
  kicked: "Kicked {target}: {reason}."
  banned: "Banned {target}: {reason}."
  tempbanned: "Temporarily banned {target} for {duration}: {reason}."
  muted: "Muted {target} for {duration}."
  unmuted: "Unmuted {target}."
  already-muted: "{target} is already muted."
  already-unmuted: "{target} is not muted."
  player-frozen: "{target} has been frozen."
  player-unfrozen: "{target} has been unfrozen."
  cannot-perform-offline: "That action requires the player to be online."
  history-title: "Recent admin actions"
  no-history: "No history entries yet."
  mute-chat-block: "You are muted for {reason} until {until}."
  lookup-prompt-usage: "Enter a player name or UUID to manage."
  invalid-duration: "Invalid duration format. Use values like 10m, 2h, or 1d."
  lookup-opened: "Managing player {target}."
  info-player: "{target} is online with {health}❤, {food} food, {gamemode}, ping {ping}."
  not-online-for-inv: "Player must be online to view inventory or ender chest."
  healed: "Healed {target}."
  fed: "Fed {target}."
  teleported: "Teleported to {target}."
  lookup-result-offline: "Opened actions for offline player {target}. Only ban/tempban actions will work."
  config-reloaded: "BetterAdmin configuration reloaded."
  action-cancelled: "Action cancelled."
  undo-success: "Reverted {action} for {target}."
  vanish-on: "You are now vanished."
  vanish-off: "You are now visible."

permissions: use: betteradmin.use lookup: betteradmin.lookup history: betteradmin.history kick: betteradmin.kick ban: betteradmin.ban tempban: betteradmin.tempban mute: betteradmin.mute unmute: betteradmin.unmute freeze: betteradmin.freeze teleport: betteradmin.teleport heal: betteradmin.heal feed: betteradmin.feed viewinventory: betteradmin.viewinventory viewenderchest: betteradmin.viewenderchest info: betteradmin.info vanish: betteradmin.vanish reload: betteradmin.reload undo: betteradmin.undo

### Messages

Every player-facing string lives under `messages:` and supports the placeholders shown above (`{target}`, `{actor}`, `{reason}`, `{duration}`, `{action}`, `{until}`, and the info-panel stats). Change any of these to reword or translate the plugin's output.

### Permission node mapping

The `permissions:` block maps each internal action key to the actual permission node BetterAdmin checks. By default these point at the standard `betteradmin.*` nodes below — you generally don't need to touch this section unless you're remapping permissions to fit an existing node naming scheme.

## Commands

| Command | Permission | Description |
| --- | --- | --- |
| `/adminpanel` | `betteradmin.use` | Opens the BetterAdmin GUI |
| `/adminpanel reload` | `betteradmin.use` | Reloads `config.yml` without restarting |

## Permissions

| Permission | Default | Description |
| --- | --- | --- |
| `betteradmin.use` | op | Open the BetterAdmin GUI |
| `betteradmin.lookup` | op | Look up players by name or UUID |
| `betteradmin.history` | op | View admin history |
| `betteradmin.kick` | op | Kick players |
| `betteradmin.ban` | op | Permanently ban players |
| `betteradmin.tempban` | op | Temporarily ban players |
| `betteradmin.mute` | op | Mute players |
| `betteradmin.unmute` | op | Unmute players |
| `betteradmin.freeze` | op | Freeze players |
| `betteradmin.teleport` | op | Teleport to players |
| `betteradmin.heal` | op | Heal players |
| `betteradmin.feed` | op | Feed players |
| `betteradmin.viewinventory` | op | View player inventories |
| `betteradmin.viewenderchest` | op | View player ender chests |
| `betteradmin.info` | op | View player information |
| `betteradmin.vanish` | op | Toggle staff vanish mode |
| `betteradmin.reload` | op | Reload `config.yml` |
| `betteradmin.undo` | op | Revert a ban, tempban, mute, or freeze from the history menu |

## Installation

1. Download the jar for your Minecraft version from this page.
2. Place it in your server's `plugins/` folder.
3. Start (or restart) the server. `config.yml` is generated on first boot; `data.yml` is created to persist history, mutes, and freezes across restarts.
4. Run `/adminpanel` to open the GUI, or edit `config.yml` first and apply changes with `/adminpanel reload`.

## License

MIT