🛡️ 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

Donations / Spenden: soon…
Modrinth Profile: nicomods on Modrinth
CurseForge Profile: nicomods on CurseForge

✨ 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

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.