PermissionSystem
Running a Minecraft server often means juggling dozens of plugins, each adding its own layer of complexity. When it comes to managing player permissions, you need a solution that is fast, reliable, and won't bog down your server's performance. That's exactly what PermissionSystem delivers. Designed from the ground up for modern server software, this add-on provides a clean, intuitive way to handle groups, ranks, and permissions without the bloat.
Why Choose PermissionSystem for Your Server?
Many permission plugins are overloaded with features you'll never use, leading to unnecessary lag and complicated configuration files. PermissionSystem takes a different approach. It focuses on the core functionality every server owner needs: creating rank hierarchies, assigning temporary permissions, and formatting chat beautifully. The result is a plugin that is incredibly lightweight and built for speed. All database operations, whether you're using MySQL or MariaDB, run asynchronously in the background, ensuring your server's tick rate stays rock solid even during peak hours.
Core Features at a Glance
- Super Fast & Lightweight: Asynchronous database queries prevent main thread lag, keeping gameplay smooth.
- Group Hierarchies & Inheritance: Create unlimited ranks with custom weights and inherit permissions from parent groups effortlessly.
- Temporary Ranks: Grant time-limited VIP or moderator status with simple commands like
/rank username VIP 30 days. Expiries are handled automatically. - Premium Chat Formatting: Display prefixes, suffixes, and colors in chat with a clean, customizable system.
- Smart TAB-List Integration: Automatically detects other tablist plugins (like TAB or NametagEdit) and yields control to prevent flickering and conflicts.
- Full Vault & PlaceholderAPI Support: Works out of the box with Vault for economy and permission sync, plus PlaceholderAPI for dynamic placeholders in scoreboards, holograms, and more.
- Complete Customization: Edit every message, command output, and error in the
messages.ymlfile with full color code support.
Supported Platforms and Requirements
PermissionSystem is built for modern Minecraft server environments. It runs seamlessly on Paper, Spigot, and Purpur servers from version 1.21 to 1.21.8+. The plugin requires Java 21 to operate. While Vault and PlaceholderAPI are optional, they are highly recommended to unlock the full potential of cross-plugin compatibility. If you're using the foxygame.net launcher, you can install PermissionSystem with a single click and benefit from automatic updates that keep your server compatible with the latest Minecraft patches.
Commands and Permissions
PermissionSystem offers a comprehensive set of commands that are easy to remember and use. All commands are accessible through the /perm base command, with a convenient shorthand /rank for quick group assignments.
General Commands
/perm groups— List all available groups. (Permission:permissionsystem.permission)/perm users— List all cached player UUIDs. (Permission:permissionsystem.permission)/perm config <chat/tablist> <true/false>— Toggle chat formatting or tablist features. (Permission:permissionsystem.permission)
Group Management
/perm group <name> create— Create a new group./perm group <name> delete— Delete a group./perm group <name> list— Show all permissions of a group./perm group <name> add <permission>— Add a permission to a group (supports wildcards)./perm group <name> remove <permission>— Remove a permission from a group./perm group <name> addmember <player>— Add a player to a group./perm group <name> removemember <player>— Remove a player from a group./perm group <name> setDefault <true/false>— Set a group as the default for new players./perm group <name> setweight <weight/none>— Set weight for tablist sorting and Vault./perm group <name> setparent <parent>— Set a parent group for inheritance./perm group <name> setprefix <value>— Set the group prefix./perm group <name> setsuffix <value>— Set the group suffix.
User Commands
/perm user <player> list— Show all permissions and groups of a player./perm user <player> clear— Remove all custom permissions from a player./perm user <player> add <permission>— Give a custom permission to a player./perm user <player> remove <permission>— Remove a custom permission from a player./perm user <player> setgroup <group>— Set a player's primary group./perm user <player> setgroup <group> <time> <unit>— Assign a temporary group (e.g., 30 days, 10 minutes)./perm user <player> setprefix <prefix>— Set a custom prefix for a player./perm user <player> setsuffix <suffix>— Set a custom suffix for a player.
Shorthand Rank Command
The /rank command makes group assignment lightning fast. Use /rank <player> <group> to set a permanent rank, or /rank <player> <group> <time> <unit> for temporary ranks. Supported time units include seconds, minutes, hours, days, months, and years. This command requires the permissionsystem.rank permission.
PlaceholderAPI Integration
PermissionSystem exposes a rich set of placeholders for use in any PAPI-compatible plugin. These allow you to display dynamic information in tab lists, scoreboards, holograms, and chat formats.
%permissionsystem_group%— Player's primary group.%permissionsystem_group_weight%— Weight of the primary group.%permissionsystem_group_expiry%— Remaining time of a temporary group.%permissionsystem_prefix%— Active prefix (personal first, then group).%permissionsystem_suffix%— Active suffix.%permissionsystem_group_prefix%— Raw group prefix.%permissionsystem_group_suffix%— Raw group suffix.%permissionsystem_chat_prefix%— Player's chat prefix.%permissionsystem_chat_suffix%— Player's chat suffix.
How to Install PermissionSystem
Getting started with PermissionSystem is straightforward. First, ensure your server is running Paper, Spigot, or Purpur on Minecraft 1.21 or newer with Java 21. Then, simply download PermissionSystem from its official page and place the JAR file into your server's plugins folder. Restart your server, and the plugin will generate all necessary configuration files. If you plan to use MySQL, edit the config.yml to enter your database credentials. For those who prefer a hassle-free setup, the foxygame.net launcher offers a one-click install option that automatically handles version compatibility and updates for PermissionSystem.
Customization and Flexibility
Every aspect of PermissionSystem can be tailored to your server's identity. The messages.yml file lets you rewrite all command outputs, error messages, and notifications with full support for Minecraft color codes. Whether you want a formal tone for a roleplay server or a casual vibe for a minigame network, you have complete control. The plugin's smart tablist hook ensures that even if you use other tablist management tools, PermissionSystem will not cause conflicts, making it a safe addition to any existing setup.
Final Thoughts
PermissionSystem stands out as a modern, no-nonsense permissions solution for Minecraft servers. Its focus on performance, ease of use, and essential features makes it an excellent choice for both new and experienced server administrators. With support for the latest Minecraft versions, seamless Vault and PlaceholderAPI integration, and a clean command structure, it streamlines rank management without sacrificing power. Whether you're running a small community server or a large network, PermissionSystem provides the tools you need to keep your players organized and your server lag-free.