Player Roles
by NucleoidMC
Player Roles lets a Fabric server owner assign players to named roles, each granting its own permissions, chat formatting and name decorations.
What it does
Roles are declared in a JSON file that defines three roles: admin, spectator and everyone. The everyone role is the default and cannot be removed, and any other role overrides it. When a player holds several roles that match the same thing, the conflict is settled by picking the role with the highest level. A command can be allowed or denied per role, and a pattern such as gamemode spectator or adventure matches only those gamemode command variants.
Each role can also carry a name decoration with optional text prepended or appended before the player name, a hex color list for text formatting, and a set of contexts that define where the decoration is applied, such as chat or the tab list. A chat type override can replace how messages from players with a given role are displayed, for example in the style of the say command. Vanilla chat type entries are read from the datapack when the server starts, so a change to them takes effect only after a restart and not during a live session.
Key features
Role permission management
Commands can be allowed or denied for each role, and an allow or deny rule decides the result when a command matches a pattern.
Name decorations
A role can add text before or after player names, with hex colors and a choice of chat, tab list or other contexts where the decoration appears.
Chat type overrides
Messages from players holding a role can be shown in a chosen chat type, such as the say command style.
Role hierarchy
Conflicting roles are resolved by level, so the admin and spectator roles take precedence over everyone in the example configuration.
Compatibility
Latest build for each game version and loader.
26.x5 of 5 versions with builds
1.21.x12 of 12 versions with builds
1.20.x5 of 5 versions with builds
1.19.x4 of 4 versions with builds
1.18.x2 of 2 versions with builds
1.17.x2 of 2 versions with builds
1.16.x2 of 2 versions with builds
This mod also publishes snapshot builds. Snapshots are not shown in the matrix.
Use cases
Who it’s for: Fabric server owners who want role-based permissions, chat formatting and name decorations defined in one configuration file. The mod is server-side only, so players join without installing it.
How it compares
Secret Spectator is also server-side only and open source under the MIT License, with files for 1.20.1 – 26.3, so it covers a similar Fabric server environment. IPWhitelist is server-side only and open source under the GNU General Public License v3.0 only, with files for 1.21.1 – 26.3, and focuses on a whitelist rather than roles.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| Player Roles | Fabric | 1.16.4 – 26.3 | Server-side only | 2026-09-17 |
| Secret Spectator | Fabric | 1.20.1 – 26.3 | Server-side only | 2026-06-17 |
| IPWhitelist | Fabric | 1.21.1 – 26.3 | Server-side only | 2026-10-10 |
Questions
Does Player Roles need to be installed on clients?
Which Minecraft versions does Player Roles support?
Can a role be removed from the default configuration?
In the catalog
Player Roles is one of 8,016 Management mods on ModsFinder, and one of 5,930 Management mods for Fabric. 8,071 mods support Minecraft 26.3.
More from NucleoidMC
Similar mods
What the author says
But what's going on here? This JSON file is declaring three roles: admin, spectator and everyone. everyone is the default role: every player will have this role, and it cannot be removed. The other roles that are specified function as overrides on top of the everyone role.
Official listing
- Modrinth page
- modrinth.com/mod/player-roles
- Owner
- NucleoidMC
- Published
- 2020-12-17
- Updated on Modrinth
- 2026-09-17
- Facts verified
- 2026-10-15