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