SimpleRoles 🎭

SimpleRoles is a powerful, lightweight, and zero-headache role management plugin for modern Minecraft servers. Designed from the ground up for seamless compatibility, SimpleRoles handles custom player roles, colored prefixes, and permission distributions instantly—all managed directly through clear, intuitive in-game commands.

✨ Key Features

• Mandatory TAB Plugin Sync: Deep, automatic integration with the TAB plugin (TabAPI). Prefixes are injected directly into server memory to format tab list entries and above-head nametags without requiring users to edit external configuration files.
• Optional Protocol Support: Fully compatible with ViaVersion and ViaBackwards, allowing multi-version servers to render prefixes cleanly across old and new Minecraft client versions.
• Instant Dynamic Updates: Role updates, prefix color changes, and member assignments update live in server memory without requiring server restarts or reloads.
• Built-in Permission Presets: Apply pre-packaged permission groups (from full Operators to basic Users and tier slots) to any role with a single command.
• Zero Ghost Formats: Cleanly wipes and resets player display names, tab entries, and permissions upon server quit, join, or role removal.

📜 Command Guide & Usage

All management is handled under the main /role command structure:

1. Role Management

• /role add <role> — Creates a new role in the configuration.
  • Example: /role add owner
• /role list — Lists all active roles currently registered on the server.
• /role <role> list — Displays all online and offline players assigned to the specified role.
  • Example: /role owner list

2. Prefix & Visual Formatting

• /role <role> set prefix <text> <color> — Configures the bracketed prefix and color for a role. Automatically formats the prefix into [TEXT] format and syncs it directly to TAB.
  • Example: /role owner set prefix OWNER red (Renders as a red [OWNER] in chat and the tab list).

3. Member Assignment

• /role <role> add <player> — Assigns a player to a role, applies their colored prefix, and equips their permission preset.
  • Example: /role owner add GingerYT
• /role <role> remove <player> — Strips a role from a player, removing their prefix and resetting their permissions back to default.
  • Example: /role owner remove GingerYT

4. Permission Assignment

• /role <role> permission set <preset> — Links a built-in permission preset directly to a role.
  • Example: /role owner permission set operator

🛡️ Built-in Permission Presets

SimpleRoles includes pre-configured permission presets to handle player capabilities without needing extra permission plugins:

⚙️ Server Requirements

• Server Engine: Paper / Spigot / Purpur (Minecraft 1.20+)
• Java Version: Java 17 or higher
• Required Plugin: TAB Plugin (v6.1.2 or higher)
• Optional Plugins: ViaVersion, ViaBackwards (for cross-version client support)