🛡️ PermissionSystem
This is my custom PermissionSystem, I hope you enjoy it! I built this to be a clean, incredibly fast, and simple permission and rank system for modern Spigot/Paper servers. It does exactly what it needs to do without any unnecessary bloat or lag.
💖 Support
✨ Features
- ⚡ Super Fast & Lightweight — Built to run completely lag-free. Database queries (MySQL/MariaDB) run asynchronously in the background so your server never lags.
- 👥 Group Hierarchies & Inheritance — Create unlimited ranks with weights and inherit permissions from other groups.
- ⏳ Temporary Ranks — Assign VIP or temporary ranks easily (e.g.
/rank username VIP 30 days). Expiries are handled automatically.
- 💬 Premium Chat Formatter — Easy and beautiful display of prefixes, suffixes, and colors directly in chat.
- 🎨 Smart TAB-List Hook — Automatically detects if you are using other tablist plugins (like TAB or NametagEdit) and yields scoreboard control to prevent conflicting nametags and flickering.
- 🔌 Vault & PlaceholderAPI Support — Fully integrates with Vault and PlaceholderAPI out of the box so all your other plugins sync up perfectly.
- 📦 Fully Customizable — Edit every single message, command output, and error in
messages.yml with full color code support.
📋 Commands & Information
ℹ️ General Commands
| Command |
Description |
Permission |
/perm groups |
List all groups |
permissionsystem.permission |
/perm users |
List all cached player UUIDs |
permissionsystem.permission |
/perm config <chat/tablist> <true/false> |
Toggle chat formatting or tablist features |
permissionsystem.permission |
👥 Group Commands
Manage server groups, prefixes, and inheritance.
| Command |
Description |
/perm group <name> create |
Create a new group |
/perm group <name> delete |
Delete a group |
/perm group <name> list |
List all permissions of a group |
/perm group <name> clear |
Remove all permissions from a group |
/perm group <name> add <permission> |
Add a permission to a group (supports * and .*) |
/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 group for new players |
/perm group <name> setweight <weight/none> |
Set weight for Tablist sorting and Vault |
/perm group <name> setparent <parent> |
Set parent group to inherit permissions from |
/perm group <name> setprefix <value> |
Set group prefix |
/perm group <name> setsuffix <value> |
Set group suffix |
👤 User Commands
Modify individual player permissions, prefixes, and ranks.
| Command |
Description |
/perm user <player> list |
Show all permissions and groups of a player |
/perm user <player> clear |
Clear 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 the primary group of a player |
/perm user <player> setgroup <group> <time> <unit> |
Give a temporary group (e.g. 30 days, 10 minutes) |
/perm user <player> setprefix <prefix> |
Set a custom prefix for a player (overrides group prefix) |
/perm user <player> setsuffix <suffix> |
Set a custom suffix for a player (overrides group suffix) |
👑 Shorthand Command
A fast, simple command to set player groups.
| Command |
Description |
Permission |
/rank <player> <group> |
Set the group of a player |
permissionsystem.rank |
/rank <player> <group> <time> <unit> |
Give a temporary group to a player |
permissionsystem.rank |
💡 Supported Units for temporary ranks: seconds, minutes, hours, days, months, years
🔑 Permissions
permissionsystem.* — Wildcard access to all features and commands.permissionsystem.permission — Gives access to the /perm command.permissionsystem.rank — Gives access to the /rank command.
🧩 PlaceholderAPI Placeholders
Use these placeholders in any PAPI-compatible plugin (like Tab, Scoreboards, Holograms, etc.):
| Placeholder |
Description |
%permissionsystem_group% |
Returns the primary group of the player |
%permissionsystem_group_weight% |
Returns the weight of the primary group |
%permissionsystem_group_expiry% |
Returns the remaining time of the temporary group (e.g. 29 days 23 hours) |
%permissionsystem_prefix% |
Returns the player's active prefix (personal first, falls back to group) |
%permissionsystem_suffix% |
Returns the player's active suffix (personal first, falls back to group) |
%permissionsystem_group_prefix% |
Returns the raw group prefix |
%permissionsystem_group_suffix% |
Returns the raw group suffix |
%permissionsystem_group_chat_prefix% |
Returns the group chat prefix |
%permissionsystem_group_chat_suffix% |
Returns the group chat suffix |
%permissionsystem_chat_prefix% |
Returns the player's chat prefix |
%permissionsystem_chat_suffix% |
Returns the player's chat suffix |
⚙️ Requirements
| Requirement |
Version |
| Minecraft Server |
1.21 - 1.21.8+ (Paper / Spigot / Purpur) |
| Java Version |
Java 21 |
| Vault |
Optional (for external plugin integration) |
| PlaceholderAPI |
Optional (for dynamic placeholders) |
📜 License & Terms of Service
This plugin is proprietary software. All rights reserved by NicoMods.
By downloading and using this plugin, you agree to the following terms:
- You are allowed to use this plugin on your own servers (both personal and commercial).
- You are not allowed to redistribute or resell this plugin.
- Decompiling, modifying, or copying parts of the code is strictly prohibited without explicit written permission from the author.
