!Introductory Banner with basic information about the plugin

Preview of some of the GUIS. All are customizable!

!Introductory Banner with basic information about the plugin

Why SuperAdminGui?

!Why Super Admin GUI

SuperAdminGUI

SuperAdminGUI is a modular staff management and player administration GUI for Paper & Purpur 1.21+ servers.

Click Here for the WIKI

---

Player Management

Manage players directly through the GUI with configurable modules for:

• Player information
• Punishments
• LuckPerms groups
• Economy
• Inventory and Ender Chest
• Teleportation
• Player restrictions
• Staff notes
• Action logs
• Chat management

Modules can be enabled or disabled per staff role.

Staff Utilities

A dedicated staff hub provides configurable access to:

• Gamemode
• Vanish
• Invisibility
• Flight
• God Mode
• Heal and Feed
• Night Vision
• Effect clearing
• Movement speed
• Teleportation
• Time control
• Weather control

Each utility can have its own permission.

Custom Staff Roles

Create your own staff hierarchy through roles.yml.

Example roles:

Permission	Role	Access
superadmingui.role.trial	Trial Moderator	Warn, Kick, Mute, Info, Notes & History
superadmingui.role.moderator	Moderator	Adds Ban, Jail, Freeze, Teleport & Restrictions
superadmingui.role.admin	Admin	Adds Economy, Inventory, Utilities, Chat & Logs
superadmingui.role.operator	Operator	Full player management access

Roles can be configured with different modules and permissions.

Integrations

SuperAdminGUI supports:

• AdvancedBan — Punishments and punishment history
• LuckPerms — Groups, ranks and hierarchy protection
• Vault — Economy management
• ExcellentEconomy — Florin management
• SuperVanish / PremiumVanish — Vanish integration
• EssentialsX — Vanish fallback and utilities
• PlaceholderAPI — External placeholders

Customization

Configure the plugin through separate YAML files:

File	Purpose
config.yml	Core settings, database, hierarchy, limits & staff locations
modules.yml	Player-management modules
gui.yml	GUI layouts, slots, borders & sounds
roles.yml	Custom staff roles
messages.yml	Messages & MiniMessage formatting
jails.yml	Jail cell locations

Customize GUI layouts, slots, materials, item names, lore, sounds, messages, permissions, roles, modules, jail cells, teleport locations and economy limits.

SuperAdminGUI uses Adventure & MiniMessage, including hex colors, gradients, formatting tags and placeholders.

Commands

Command	Aliases	Permission	Description
/superadmingui	/sag, /admin, /staffgui	superadmingui.use	Opens the main staff dashboard
/superadmingui <player>	/sag <player>	superadmingui.use	Opens a player's management hub
/superadmingui logs	/sag logs	superadmingui.module.logs	Opens the global staff action logs
/superadmingui reload	/sag reload	superadmingui.reload	Reloads plugin configuration

Permissions

Administrative Permissions

Permission	Default	Description
superadmingui.use	op	Opens the SuperAdminGUI interface
superadmingui.admin	op	Full administrative access
superadmingui.reload	op	Reloads plugin configuration
superadmingui.bypass	false	Immunity against staff management actions
superadmingui.ip.view	op	Allows viewing player IP addresses

Staff Utility Permissions

Permission	Description
superadmingui.staff.use	Opens the Staff Self-Management Hub
superadmingui.staff.gamemode.survival	Access Survival mode
superadmingui.staff.gamemode.creative	Access Creative mode
superadmingui.staff.gamemode.adventure	Access Adventure mode
superadmingui.staff.gamemode.spectator	Access Spectator mode
superadmingui.staff.vanish	Toggle vanish
superadmingui.staff.vanish.see	See vanished staff
superadmingui.staff.invisibility	Toggle invisibility
superadmingui.staff.fly	Toggle flight
superadmingui.staff.god	Toggle God Mode
superadmingui.staff.heal	Heal yourself
superadmingui.staff.feed	Restore hunger
superadmingui.staff.cleareffects	Clear potion effects
superadmingui.staff.nightvision	Toggle Night Vision
superadmingui.staff.speed	Open speed selector
superadmingui.staff.teleport	Open teleport hub
superadmingui.staff.teleport.spawn	Teleport to spawn
superadmingui.staff.teleport.staff	Access configured staff locations
superadmingui.staff.teleport.back	Return to previous location
superadmingui.staff.teleport.random	Use safe random teleport
superadmingui.staff.time	Access world time controls
superadmingui.staff.weather	Access weather controls

Placeholders

PlaceholderAPI

Supported external placeholders include:

%vault_eco_balance% %luckperms_prefix% %player_ping%

Internal Placeholders

Placeholder	Value
{player} / {target}	Target username
{staff}	Staff member username
{uuid}	Target UUID
{status}	Online / Offline
{rank}	Primary LuckPerms group
{balance}	Vault balance
{florin}	Florin balance
{reason}	Action reason
{duration}	Punishment duration
{jail}	Jail cell identifier
{page}	Current page
{total_pages}	Total pages
{filter}	Active player filter
{coords}	Player coordinates
{time}	World time
{weather}	Current weather
{seconds}	Chat slowmode duration

Installation

1. Download SuperAdminGUI-1.0.0.jar.
2. Place it in plugins/.
3. Install any integrations you need.
4. Start or reload your server.
5. Give staff superadmingui.use or configure roles through roles.yml.
6. Run /superadmingui.

Requirements

• Server: Paper / Purpur
• Minecraft: 1.21+
• Java: Compatible with your server version

Optional integrations are only required for the features they provide.

---

Documentation