OmniPanel gui

OmniPanel

OmniPanel is an all-in-one administration, moderation, player-management, and server-utility plugin built for modern Minecraft servers.

Instead of stacking separate plugins for staff tools, punishments, ranks, homes, kits, regions, player inspection, maintenance, events, authentication, and server management, OmniPanel connects those systems through one central platform.

The plugin is designed around menus, dialogs, shared permission checks, and consistent workflows rather than forcing staff to remember dozens of commands.

Whether you're running an SMP, community server, creator server, private server, or larger network, OmniPanel gives your staff one place to manage the server.

---

Why OmniPanel?

A normal server can quickly end up running separate plugins for:

• Moderation
• Punishments
• Staff Mode
• Player inspection
• Ranks
• Homes
• Kits
• Regions
• Events
• Authentication
• Maintenance
• Discord integration
• Player utilities
• Administrative tools

That usually means separate permission systems, different interfaces, overlapping commands, duplicate data, and plugins that do not know about each other.

OmniPanel is built differently.

One panel.

One connected permission system.

One moderation workflow.

One set of player-management tools.

One API for other plugins to integrate with.

---

Main Panel

Everything starts with:

/panel

The panel provides access to OmniPanel's administrative systems through a permission-aware interface.

Features include:

• Section-based navigation
• Feature-level permissions
• Search
• Pagination
• Context-aware menus
• Player selection
• Confirmation screens
• Paper Dialog integration
• Permission-aware buttons
• Staff-only actions
• Public-player menus where appropriate
• Back and Close navigation
• Extension support for add-ons

Opening /panel does not automatically give access to everything inside it.

Every protected feature is still checked server-side.

---

Panel Visibility & Access

OmniPanel uses a centralized access system for protected panel features.

Administrators can grant access to:

• Entire sections
• Individual features
• Specific staff members
• Specific ranks

This makes it possible to give staff exactly what they need.

For example:

• Helpers can inspect players without editing inventories.
• Moderators can freeze, jail, teleport, and moderate players without receiving rank-management access.
• Builders can receive region and building controls without punishment permissions.
• Developers can receive diagnostics and technical tools.
• Owners can retain complete access.

The built-in Panel Visibility & Access editor allows authorized staff to:

• Select a player or rank
• Choose full or custom access
• Browse sections
• Enable or disable individual features
• Review changes before applying them
• Grant or revoke complete sections

LuckPerms integration remains authoritative where available.

Explicit permission grants, denials, contexts, and external LuckPerms changes are respected.

---

Player Browser

Browse players through OmniPanel without needing to type usernames manually.

Player information can include:

• Online status
• Platform
• Rank
• Last seen
• Current world
• Playtime
• Homes
• Punishment history
• Staff notes
• Presence state

Player Actions provide access to additional tools depending on staff permissions.

---

Player Actions

Player Actions are organized into categories such as:

• Care & Movement
• Moderation & Records
• Utilities
• Advanced
• Additional Player Tools

Available actions depend on the staff member's permissions.

Integrated tools include:

• Teleportation
• Healing
• Inventory inspection
• Ender Storage inspection
• Punishment history
• Staff notes
• Freeze
• Jail
• Moderation tools
• Utility actions

Target actions remain bound to the selected player rather than silently falling back to the staff member.

---

Inventory Inspection

OmniPanel includes shared inventory-inspection sessions for staff.

Example:

/invsee inventory <player>

Viewing and editing are separate permissions.

The inventory system supports:

• Read-only inspection
• Authorized editing
• Storage slots
• Armour
• Offhand
• Concurrent-session protection
• Inventory transaction guards
• Offline player inspection
• Offline editing backups
• Login protection while an offline edit is active

Read-only sessions cannot write changes back to the target player.

Real player items are treated as items, not as GUI buttons.

---

Expanded Ender Storage

OmniPanel includes an expanded Ender Storage system backed by its existing storage database.

Features include:

• 54 usable chest slots
• Staff inspection
• Personal /echest access where permitted
• SQLite persistence
• Backups
• Legacy-data imports
• Vanilla synchronization
• Physical opening and closing sounds
• Lid animation
• Shared-viewer handling
• Corruption safeguards

Invalid stored item data fails closed instead of silently replacing stored items with empty slots.

---

Punishment System

OmniPanel includes a full punishment workflow for staff moderation.

Supported actions include:

• Warnings
• Temporary warnings
• Mutes
• Temporary mutes
• Bans
• Temporary bans
• IP bans
• Temporary IP bans
• Kicks
• Freeze
• Jail
• Reversals
• Staff notes
• Punishment records

Temporary punishments require valid finite durations and respect configured limits.

Punishments use the authoritative backend so GUI actions, API submissions, records, and enforcement stay connected.

---

Punishment Records

Punishment history can include:

• Staff actor
• Target
• Case
• Source
• Action
• Reason
• Duration
• Timestamp
• Result
• Available evidence

History uses compact summaries with full details available through the existing record interface.

Warnings, kicks, reversals, and expired temporary punishments are not incorrectly shown as permanent active sanctions.

---

Punishment Presets

OmniPanel includes searchable punishment presets for reviewed moderation situations such as:

• Fraud
• Phishing
• Malicious links
• Evasion
• Bot raids
• Exploits
• Harassment
• Spam

Custom server presets remain supported and remain authoritative.

Normal Minecraft behaviour such as legitimate trading, giveaways, or regular PvP is not automatically treated as a violation.

---

Duration Builder

Temporary punishments support normal duration units including:

• Seconds
• Minutes
• Hours
• Days
• Weeks
• Months
• Years

Duration validation is handled before temporary punishments are applied.

---

AutoMod

OmniPanel includes built-in chat moderation and evidence handling.

Features include:

• Blocked-word detection
• Strict-word lists
• Word-boundary matching
• Current-message evidence
• Spam detection
• Moderation alerts
• Configurable confidence requirements
• Saved evidence
• Staff review flows
• Atomic word-list updates

Commands include:

/automod words add
/automod words remove
/automod words list

and:

/automod strictwords add
/automod strictwords remove
/automod strictwords list

Blocked-word checks use the actual current message rather than stale content from previous messages.

---

AI Moderation Evidence

Where AI-assisted moderation is configured, OmniPanel treats AI output as evidence for review rather than automatic truth.

The moderation context accounts for normal Minecraft activity including:

• PvP
• Trading
• Economy activity

Automatic decisions require:

• A recognized category
• Evidence from the real message
• A verbatim matching quote
• Contextual support
• The configured confidence threshold

The default evidence confidence threshold is:

0.95

High-impact or uncertain cases remain review-oriented by default.

Evidence records can contain:

• Original message
• Matching quote
• SHA-256
• Capture time
• Source
• Model confidence where available

AI confidence is a safeguard, not proof.

---

Staff Mode

OmniPanel includes a built-in Staff Mode with safe inventory recovery.

Features include:

• Staff inventory backup
• Staff tools
• Vanish support
• Join/quit recovery
• Inventory restoration
• Flight-state restoration
• Collision restoration
• Pickup-state restoration
• Protection-state restoration
• Recovery after disconnect or shutdown
• Persistent tool identifiers
• Protected tool movement
• Staff Mode title
• On-duty action bar

Entering Staff Mode fails safely if the staff inventory cannot be backed up.

---

Staff Tools

Available administrative tools include:

• Sentinel Blade
• Excavator Pickaxe
• Timber Axe
• Justice Hammer

Tools can be granted individually instead of requiring access to every administrative tool.

Punishment-related tools still require the corresponding punishment permissions.

Issuing a staff tool does not overwrite occupied inventory slots.

---

Staff Chat

Staff Chat uses the same access system for:

• Toggling
• Sending
• Receiving
• Visibility
• Execution

Default and Member players do not receive Staff Chat automatically.

Staff messages are routed before normal public chat auditing or Discord forwarding.

If access is revoked before a pending Staff Chat message is sent, the message is cancelled instead of leaking into public chat.

---

Emergency Staff Teleport

OmniPanel includes:

/stafftp [message]

This allows authorized staff to send a private emergency teleport invitation.

Staff can respond using:

• Clickable Accept
• Clickable Deny
• /stafftp accept
• /stafftp deny
• /tpaccept
• /tpdeny

Emergency staff teleport requests always require explicit acceptance, even if normal TPA auto-accept is enabled.

Requests are session-bound, expire properly, and cannot be reused after reconnecting.

---

Public Teleport Requests

Normal player teleport commands remain public:

/tpa
/tpahere
/tpaccept
/tpdeny
/tpcancel
/tpauto

Players can configure:

• Whether they receive teleport requests
• Whether normal requests auto-accept

Emergency staff requests remain separate from normal auto-accept behaviour.

---

Homes

OmniPanel includes a public homes system.

Commands include:

/home
/homes
/sethome
/delhome
/unsethome

Features include:

• Named homes
• Teleportation
• GUI access
• Safe deletion
• Region checks
• Atomic persistence
• Rank-based home limits
• Alias-aware rank handling

When multiple active ranks are present, OmniPanel uses the highest applicable home allowance instead of adding allowances together.

Default Home Limits

Existing custom limits remain supported.

---

Random Teleport

/rtp remains available as a normal player command.

Default cooldown:

60 seconds

Existing explicitly configured cooldowns are preserved.

Available destinations include:

• Overworld
• Nether
• End
• Close

Administrative RTP controls include:

• Cooldown
• Countdown
• Target worlds
• Search radius
• Attempts
• World-border handling
• Safety filters
• Protected-region buffer
• No-RTP zones
• Cooldown clearing
• Testing

The cooldown starts only after a successful teleport.

---

Personal Settings

Players can open:

/settings

The personal settings menu is separate from OmniPanel's administrative settings.

Available options include:

• Receive TPA requests
• TPA auto-accept
• Player visibility
• Collision
• Item pickup
• Personal time
• Personal weather
• Settings sounds
• Hostile natural-spawn preference
• Peaceful natural-spawn preference
• Stack My Items
• My Coordinates
• Clear My Inventory
• Reset

Personal time and weather only affect the player's view and do not alter the world's global state.

---

Safer Inventory Clearing

Inventory clearing requires a protected confirmation.

The confirmation is tied to:

• Player
• Target
• Inventory state
• Session

The following cannot accidentally confirm a clear:

• Escape
• Cancel
• Shift-click
• Double-click
• Number keys
• Drop clicks
• Bottom-inventory clicks
• Replayed confirmations
• Expired confirmations

If the inventory changes before confirmation, the old request becomes invalid.

---

Personal Mob-Spawn Preferences

Players can control nearby natural hostile and peaceful mob spawning around themselves.

The system is local to the opted-out player and configurable by radius.

It does not:

• Change a global gamerule
• Delete existing mobs
• Affect spawners
• Affect spawn eggs
• Affect breeding
• Affect command-spawned mobs
• Create separate client-only mobs

Nearby players who allow spawning take priority in shared areas.

---

Rank Manager

OmniPanel includes deep LuckPerms integration for rank management.

Features include:

• Main-rank assignment
• Additional ranks
• Promotions
• Temporary ranks
• Permanent ranks
• Duration selection
• Rank display
• TAB synchronization
• Chat synchronization
• Name-tag synchronization
• Rank aliases
• Offline assignments
• Serialized rank writes
• Failure rollback

Normal rank assignment replaces the player's previous main rank.

Additional ranks are managed separately through Multi Ranks.

Unrelated groups and direct player permissions are preserved.

---

Apply Rank to Everyone

Authorized staff can bulk-apply a selected rank.

The flow allows staff to choose:

• Online players only
• All known players

Before applying, OmniPanel displays the operation count and requires confirmation.

Protected and owner-level accounts are skipped.

Permission:

omnipanel.access.ranks.apply-to-everyone

---

Rank Badges

OmniPanel includes a generated rank-resource-pack contribution containing custom rank badges.

Current rank badges include:

• Owner
• Co-Owner
• CEO
• Executive
• Manager
• Admin
• Builder
• Developer
• Moderator
• Helper
• MVP
• VIP
• YouTuber
• Hero
• Champion
• Legendary
• Member
• Default

Presence badges are also included for:

• LIVE
• AFK

The badges use the dedicated font:

omnipanel:ranks

The normal Minecraft font is not replaced.

Text fallback remains available when the resource pack is not accepted.

---

ResourcePackManager Integration

OmniPanel contributes its generated rank assets to the existing ResourcePackManager workflow.

ResourcePackManager remains responsible for:

• Combining packs
• Hosting
• Prompting players
• Delivering the final pack

OmniPanel does not compete with ResourcePackManager by sending another standalone pack.

If using the badge system, keep your normal combined ResourcePackManager setup configured.

---

Name & Chat Styles

OmniPanel includes configurable name and chat styling.

The current style collection contains:

468 selectable styles across 13 pages.

Included collections include:

• Smooth Signatures
• Silk Motion

Existing profile IDs and saved player selections remain compatible.

Supported settings include:

• Animation enablement
• Speed
• Frame timing

Name, chat, and TAB styling share the same renderer.

Minecraft team colours still use Minecraft's native 16-colour limit where required, while compatible component displays can retain richer RGB and gradient styling.

---

AFK & Presence

OmniPanel includes an AFK and presence system integrated with rank display.

AFK protection resists passive movement such as:

• Water
• Wind charges
• Knockback
• Ordinary velocity
• Player collision
• Mob collision

AFK is cleared by actual player movement, /afk, or successful teleportation.

Camera movement alone does not count as returning.

Mounted players are dismounted when entering AFK, and AFK players cannot be mounted.

AFK movement protection does not provide damage immunity.

---

Kits

OmniPanel includes a GUI-driven kit system.

Kit features include:

• Creation and editing
• Cooldowns
• Permissions
• Preview
• Search
• Categories
• Safe item delivery
• Overflow handling
• Rollback on failed transactions
• Playtime rewards

Kit claims preserve existing inventory contents and merge compatible stacks where possible.

A partially filled inventory is not automatically treated as full.

---

Playtime Kit Rewards

Kits can optionally reward players after reaching configured playtime thresholds.

Configure through Manage Kit or:

/kit playtime <kit> <minutes|off>

Rewards are stored per UUID and kit threshold.

Cooldown resets do not cause the same playtime reward to be granted again.

The Kit API exposes:

playtimeMinutes

---

Donor Utilities

VIP, MVP, Hero, Champion, and Legendary can receive default access to utilities such as:

/echest
/craft
/anvil

Each utility has its own:

• Permission
• Configuration switch

Existing explicit grants and denials remain authoritative.

/echest uses OmniPanel's existing expanded Ender Storage rather than creating a second storage backend.

---

Region Protection

OmniPanel includes its own native region system.

Regions can control server behaviour such as:

• Building
• Breaking
• Interaction
• PvP
• Water
• Lava
• Buckets
• Protected boundaries
• Region ownership
• Staff bypass
• Event usage

WorldEdit and FAWE selections can be used to create or resize OmniPanel regions.

Selections must be complete and belong to loaded worlds.

Changes respect configured volume limits.

Failed region writes roll back automatically.

---

WorldEdit Selection Integration

Authorized integrations can use a player's WorldEdit selection for native OmniPanel region operations.

A WorldEdit selection by itself does not provide OmniPanel protection.

The selection must first be saved as an OmniPanel region.

---

Server Rules

OmniPanel includes an editable Rules Studio.

Authorized staff can:

• Add rules
• Edit rules
• Delete rules
• Reorder rules

Configurable options include:

• Title
• Introduction
• Page size

An empty rules list can still be edited.

---

Maintenance Mode

Maintenance controls are available through OmniPanel Settings.

Features include:

• Enable/disable
• Custom text
• Placeholders
• Escaped newlines
• Fallback controls

Editing maintenance text does not automatically enable maintenance mode.

---

Jail

OmniPanel's jail system can control:

• Commands
• Chat
• Building
• Interaction
• Items
• PvP

Jail configuration access is separate from the ability to jail a player.

Allowed-command lists are synchronized across jail guards, including intentionally empty lists.

Jail notices retain the recorded jailer and punishment duration.

---

Watch & Notify

Authorized staff can use the existing watch service to monitor selected player activity and receive notifications.

Watch access and notification access remain separately permission-controlled.

---

Owner Log

Owner Log records important administrative and moderation activity.

Records can include:

• Actor
• Target
• Case
• Action
• Reason
• Duration
• Source
• Result

Categories include:

• Punishments
• Commands
• Game-mode changes

Game-mode changes are recorded separately from submitted commands.

Credential-related commands are excluded from command logging.

Features include:

• Filtering
• Pagination
• Refresh
• Detailed records
• Live punishment alerts
• Selected-command tracking
• Game-mode tracking

Disabling recording keeps existing records and does not disable security enforcement.

---

Owner Command Approval

Individual commands can optionally require owner approval.

Owners can:

• Approve once
• Deny

Approval only allows one retry of the exact command under the same session and world conditions.

Approval does not:

• Run the command as console
• Grant missing permissions
• Bypass rank checks
• Bypass world restrictions
• Bypass argument validation

Requests expire and cannot be reused with changed arguments.

---

Command Hub

Command Hub provides a central view of registered se