ServerRoles
github.com
- Free plan
- API
- Self-hosted
What ServerRoles is
ServerRoles is a role and permission management plugin for Paper or Purpur servers. Administrators manage roles through `/role`, setting display names, prefixes, hex colors, priorities, permissions, inheritance, and operator status. Timed roles accept day, hour, and minute durations, then return players to their default role after expiry. Expiry checks run when a player joins and every five minutes, so a role may remain active briefly beyond its set duration. Permissions can be inherited or negated with a leading hyphen, and configured chat formatting can add role prefixes and colors. YAML is the default storage option; SQLite and MySQL are also supported. Optional PlaceholderAPI support provides nine placeholders, and other plugins can query or change roles through the developer API. The documented requirements are Paper or Purpur 1.21.11 and Java 21 or later. ServerRoles is free and GPL-3.0 licensed. Its documentation says it is designed to be the sole permission provider and warns that another permission plugin may conflict.
Who it suits
ServerRoles suits administrators of Paper or Purpur 1.21.11 servers who need configurable roles, timed assignments, and storage choices. It may not suit servers relying on another permission plugin.
Good to know, and what to watch
- Supports YAML, SQLite, and MySQL
- Timed roles revert to the default role
- Role permissions can be inherited or negated
- Optional PlaceholderAPI integration provides nine placeholders
- Other plugins can use the developer API
- Requires Paper or Purpur 1.21.11
- Requires Java 21 or later
- Another permission plugin may conflict
- Role expiry checks can be delayed by up to five minutes
Getting started
- Open the ServerRoles GitHub website
- Use Paper or Purpur 1.21.11 with Java 21 or later
- Download a release JAR from the releases page
- Place the JAR in the server's `plugins/` folder
- Use `/role` commands with the `serverroles.admin` permission
Limits to check
Timed roles may remain active for up to five minutes after expiry because checks run every five minutes and when a player joins. The documentation also positions ServerRoles as the sole permission provider, warning that another permission plugin may conflict.
The verdict
ServerRoles offers role configuration, timed assignments, and integration options for supported server versions. Its sole-provider design and possible conflicts with other permission plugins are important to consider before installation.
Questions people ask
Is ServerRoles free?
Yes. It has a free plan and is identified as GPL-3.0 licensed.
Which servers does it support?
The documented platforms are Paper and Purpur 1.21.11, with Java 21 or later required.
Which storage systems are available?
YAML is the default, and SQLite and MySQL are also supported.
Can roles expire automatically?
Yes. Temporary roles accept day, hour, and minute durations, then revert players to their default role.
Can other plugins integrate with it?
Optional PlaceholderAPI integration provides nine placeholders, and a developer API can query or change roles.
What the maker publishes
- Access control
- All /role administration commands require the serverroles.admin permission, which defaults to operators. source
- Chat formatting
- The plugin can automatically add a player's role prefix and color to chat, and this feature can be toggled in configuration. source
- Developer API
- Other plugins can query and change roles through its developer API, and a cancellable role-change event is documented for online players. source
- 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. source
- Expiry timing
- Expired roles are checked every five minutes and when a player joins, so expiry can be delayed by up to five minutes. source
- 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. source
- Installation
- Installation instructions say to download a JAR from the releases page and place it in the server's `plugins/` folder. source
- Installation
- Installation consists of placing the downloaded ServerRoles JAR in the server's plugins folder and starting or restarting the server. source
- Integrations
- Optional PlaceholderAPI integration provides nine placeholders, with examples for TAB, chat, hologram, and scoreboard plugins. source
- Integrations
- Optional PlaceholderAPI integration provides nine placeholders, usable by compatible plugins such as TAB, DeluxeChat, Essentials, HolographicDisplays, DecentHolograms, and scoreboard plugins. source
- License
- The repository identifies the project as GPL-3.0 licensed. source
- Localization
- Player-facing messages are translatable, and the repository lists English (en_US) and Portuguese (pt_PT) as bundled options. source
- 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. source
- 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. source
- Permission rules
- Roles support permission nodes, inherited permissions, and permission negation using a leading hyphen. source
- Purpose
- ServerRoles is a role-based permissions and prefix management plugin for Paper or Purpur servers. source
- 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. source
- Requirements
- The documented requirements are Paper or Purpur 1.21.11 and Java 21 or later. source
- Role management
- Roles can have display names, prefixes, hex colors, priorities, permissions, inheritance, and operator status, managed with the `/role` command. source
- Role management
- It lets admins create and edit roles with display names, hex-colored prefixes, priorities, permission inheritance, and optional operator status. source
- Storage
- The plugin supports YAML, SQLite, and MySQL storage; YAML is the default. source
- Storage
- Role data can be stored in YAML, SQLite, or MySQL, with YAML as the default backend. source
- Temporary assignments
- Temporary roles accept combined day, hour, and minute durations, then revert players to the default role when they expire. source
- Temporary roles
- Roles can be assigned for a set duration and revert to the default role when they expire. source
Checked against the maker's pages on 3 Oct 2026.