# 🛡️ 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...](https://paypal.me/your-link-here) * **Modrinth Profile:** [nicomods on Modrinth](https://modrinth.com/user/nicomods) * **CurseForge Profile:** [nicomods on CurseForge](https://curseforge.com/members/nicomods) --- ## ✨ 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 ` | Toggle chat formatting or tablist features | `permissionsystem.permission` | --- ### 👥 Group Commands *Manage server groups, prefixes, and inheritance.* | Command | Description | | :--- | :--- | | `/perm group create` | Create a new group | | `/perm group delete` | Delete a group | | `/perm group list` | List all permissions of a group | | `/perm group clear` | Remove all permissions from a group | | `/perm group add ` | Add a permission to a group (supports `*` and `.*`) | | `/perm group remove ` | Remove a permission from a group | | `/perm group addmember ` | Add a player to a group | | `/perm group removemember ` | Remove a player from a group | | `/perm group setDefault ` | Set a group as the default group for new players | | `/perm group setweight ` | Set weight for Tablist sorting and Vault | | `/perm group setparent ` | Set parent group to inherit permissions from | | `/perm group setprefix ` | Set group prefix | | `/perm group setsuffix ` | Set group suffix | --- ### 👤 User Commands *Modify individual player permissions, prefixes, and ranks.* | Command | Description | | :--- | :--- | | `/perm user list` | Show all permissions and groups of a player | | `/perm user clear` | Clear all custom permissions from a player | | `/perm user add ` | Give a custom permission to a player | | `/perm user remove ` | Remove a custom permission from a player | | `/perm user setgroup ` | Set the primary group of a player | | `/perm user setgroup ` | Give a temporary group (e.g. `30 days`, `10 minutes`) | | `/perm user setprefix ` | Set a custom prefix for a player (overrides group prefix) | | `/perm user setsuffix ` | Set a custom suffix for a player (overrides group suffix) | --- ### 👑 Shorthand Command *A fast, simple command to set player groups.* | Command | Description | Permission | | :--- | :--- | :--- | | `/rank ` | Set the group of a player | `permissionsystem.rank` | | `/rank ` | 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.