- Home
- Minecraft Permissions Plugins
- ServerRoles
ServerRoles
What it is
ServerRoles is a free role and permission management plugin for Paper or Purpur servers. Administrators use the `/role` command to set each role's display name, prefix, hex color, priority, permissions, inheritance, and operator status. Permission nodes can be inherited or negated with a leading hyphen, and a configurable option can add role prefixes and colors to chat. Roles can also be assigned for a duration expressed in days, hours, and minutes, then revert to a player's default role. Expiry checks run when a player joins and every five minutes, so a role may remain active for up to five minutes after its duration. YAML is the default storage option, with SQLite and MySQL also supported. Optional PlaceholderAPI integration provides nine placeholders; other plugins can query or change roles through the developer API. Installation uses a release JAR placed in the server's `plugins/` folder. The documented requirements are Paper or Purpur 1.21.11 and Java 21 or later. The project is GPL-3.0 licensed and is designed as the server's sole permission provider.
For and against
For
- Roles support inheritance and permission negation
- YAML, SQLite, and MySQL storage
- Temporary roles revert to the default role
- Developer API lets plugins query or change roles
Against
- Requires Paper or Purpur 1.21.11
- Requires Java 21 or later
- Another permission plugin may conflict
- Role expiry checks can be delayed up to five minutes
The verdict
ServerRoles offers role configuration, multiple storage options, and plugin integration at no listed cost. Its requirements are specific, and its documentation warns against pairing it with another permission provider.
Who it suits
ServerRoles suits administrators of Paper or Purpur servers who need configurable roles, permissions, and prefixes. It may also suit developers integrating role changes with other plugins.
On the record
- Access control
- All /role administration commands require the serverroles.admin permission, which defaults to operators.github.com · read 3 Oct 2026
- Chat formatting
- The plugin can automatically add a player's role prefix and color to chat, and this feature can be toggled in configuration.github.com · read 3 Oct 2026
- Developer API
- Other plugins can query and change player roles and permissions through the ServerRoles API, and listen for a cancellable role-change event that fires for online players.github.com · read 3 Oct 2026
- Expiry timing
- Expired temporary roles are checked every five minutes and when a player joins, so scheduled expiry may be delayed by up to five minutes.github.com · read 3 Oct 2026
- Installation
- Installation consists of placing the downloaded ServerRoles JAR in the server's plugins folder and starting or restarting the server.github.com · read 3 Oct 2026
- Integrations
- Optional PlaceholderAPI integration provides nine placeholders, usable by compatible plugins such as TAB, DeluxeChat, Essentials, HolographicDisplays, DecentHolograms, and scoreboard plugins.github.com · read 3 Oct 2026
- License
- The repository identifies the project as GPL-3.0 licensed.github.com · read 3 Oct 2026
- Localization
- Player-facing messages are translatable, and the repository lists English (en_US) and Portuguese (pt_PT) as bundled options.github.com · read 3 Oct 2026
- Notable limitation
- The project says ServerRoles is designed to be the sole permission provider, and warns that another permission plugin such as LuckPerms may conflict.github.com · read 3 Oct 2026
- Permission provider limitation
- The documentation says ServerRoles is designed to be the sole permission provider and warns that another permission plugin such as LuckPerms may conflict.github.com · read 2 Oct 2026
- Permission rules
- Roles support permission nodes, inherited permissions, and permission negation using a leading hyphen.github.com · read 3 Oct 2026
- Purpose
- ServerRoles is a lightweight role-based permission and prefix management plugin for Paper and Purpur 1.21.11 servers running Java 21 or later.github.com · read 3 Oct 2026
- Requirements
- The documented requirements are Paper or Purpur 1.21.11 and Java 21 or later.github.com · read 2 Oct 2026
- Role management
- It lets admins create and edit roles with display names, hex-colored prefixes, priorities, permission inheritance, and optional operator status.github.com · read 3 Oct 2026
- Storage
- Role data can be stored in YAML, SQLite, or MySQL, with YAML as the default backend.github.com · read 3 Oct 2026
- Temporary assignments
- Temporary roles accept combined day, hour, and minute durations, then revert players to the default role when they expire.github.com · read 3 Oct 2026
- Temporary roles
- Roles can be assigned for a set duration and revert to the default role when they expire.github.com · read 2 Oct 2026
