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

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, resell, or share this plugin binary.
• Decompiling, modifying, or copying parts of the code is strictly prohibited without explicit written permission from the author.