Ranks
Create ranks with permissions, prefixes and inheritance, give them to players for good or for a limited time, and show them in chat, tab and above heads.
The Ranks module is a complete permission system. You create your ranks in the web editor, give them to players, and InglisCore shows the right prefix in chat, in the player list and above each player's head. Ranks are shared across your whole network. If you prefer to keep LuckPerms, InglisCore can let LuckPerms handle permissions and only take care of the display.
Features
- Visual rank editor: display name, prefix, suffix, name color, weight, inheritance and permissions, with a live chat preview.
- Inheritance: a rank gets every permission of the ranks it inherits from.
- Weight: the heavier rank is the player's primary rank, the one shown by default. Weight also sorts the player list and decides who can act on whom.
- Default rank: automatically given to every player.
- Temporary ranks and permissions: give a rank or a single permission for a set time. When it runs out, it is removed and the player is told. Giving more time to a temporary rank adds to the time left.
- Personal permissions: give or deny a permission to one player, on top of their ranks.
- Per server permissions: a permission can apply to one server of your network only.
- Display: prefix and name color in the player list, prefix and suffix above the head, player list sorted by rank.
- Vault: other plugins (shops, chat plugins and so on) can read InglisCore ranks and permissions through Vault.
- LuckPerms mode: LuckPerms keeps handling permissions while InglisCore shows its prefixes, suffixes and groups.
Default ranks
On a fresh install, InglisCore creates a ready to use set of ranks. Their display names follow your server language.
| Rank | Weight | Notes |
|---|---|---|
| member | 0 | Default rank |
| vip | 10 | |
| mvp | 20 | Inherits from vip |
| helper | 50 | Basic punishment permissions (mute, kick, warn, history, staff alerts) |
| mod | 60 | Inherits from helper, all punishment permissions, /tp and /vanish |
| admin | 100 | Every permission (*) |
Change them, delete them or add your own: they are only a starting point.
Setting it up
Ranks tab
The Ranks tab of the module lists your ranks with their member count. Click New rank to create one (letters, digits and _ only), or click a rank to edit it.
| Field | What it does |
|---|---|
| Display name | Readable rank name, used in messages, the player list and placeholders. |
| Prefix | Shown before the name in chat, in the player list and above the head. |
| Suffix | Shown after the name. |
| Name color | Color codes applied to the name, for example &e. |
| Weight | The higher, the more important: player list order and primary rank. |
| Default rank | Automatically given to every player. |
| Inherits from | The rank gets every permission of the selected ranks. |
| Permissions | The permissions of the rank, see below. |
Deleting a rank removes it from every player on the whole network.
Writing permissions
| You write | Effect |
|---|---|
plugin.permission |
Grants this permission. |
* |
Grants everything. |
plugin.* |
Grants every permission of a plugin. |
-plugin.permission |
Denies this permission. |
lobby/plugin.permission |
Grants it on the server with the ID lobby only. Works with a denial too: lobby/-plugin.permission. |
When several sources disagree, the strongest one wins: a player's personal permissions come first, then their ranks from the heaviest to the lightest, then the default rank. A denial in a heavier rank therefore removes what a lighter rank grants.
Giving ranks to players
Open the Players page of the web editor, pick a player and go to their Ranks tab.
- Player ranks: choose a rank, type a duration (for example
1h,7d,30d) or leave it empty for a permanent rank, then choose Add to keep their other ranks or Replace all to remove them. - Personal permissions: add a permission for this player only, permanent or with a duration.
When a player has no rank at all, the default rank applies.
Settings tab
| Setting | What it does | Default |
|---|---|---|
| Rank management | internal: full InglisCore rank system. luckperms: LuckPerms handles permissions, InglisCore the display. Applies to the whole network and needs a restart. |
internal |
| Vault provider | Lets other plugins read InglisCore ranks through Vault. Needs a restart. | On |
| Name in tab | Shows the rank prefix and color in the player list. | On |
| Tab format | How names look in the player list. Variables: {prefix}, {suffix}, {namecolor}, {player}, {rank}, {clan}. |
{clan}{prefix}{namecolor}{player}{suffix} |
| Prefix above the head | Shows prefix and suffix above the head. Turn it off if another plugin handles nametags. | On |
| Sort tab by rank | Heaviest ranks show at the top of the player list. | On |
Using LuckPerms
Set Rank management to luckperms and restart. LuckPerms then handles every permission and group, and InglisCore reads from it:
- the prefix and suffix of the player,
- the name color from the
namecolormeta, for example/lp group vip meta set namecolor &e, - the primary group and its weight.
In this mode, the ranks in the web editor are not used on this server and /rank is disabled. If LuckPerms is missing, InglisCore falls back to its own rank system.
Moving away from LuckPerms? See migration to import your groups and players.
Commands
The full rank editor is in the web editor. /rank covers quick staff actions in game.
| Command | What it does | Permission |
|---|---|---|
/rank list |
Lists every rank with its weight and prefix. | inglis.ranks.admin |
/rank info <rank> |
Shows a rank's details. | inglis.ranks.admin |
/rank add <player> <rank> [duration] |
Gives a rank, permanent or for a duration. | inglis.ranks.admin |
/rank set <player> <rank> [duration] |
Gives a rank and removes all the player's other ranks. | inglis.ranks.admin |
/rank remove <player> <rank> |
Removes a rank. | inglis.ranks.admin |
/rank user <player> |
Shows a player's ranks, their expiry and primary rank. | inglis.ranks.admin |
/rank perm <player> <add|remove> <permission> [duration] |
Gives or removes a personal permission. | inglis.ranks.admin |
Aliases: /grade, /ranks. Durations look like 30m, 12h, 7d, 1mo. Leave the duration out, or write perm, for a permanent rank.
Staff using /rank in game are limited so they cannot promote themselves:
- they can only give or remove ranks lighter than their own,
- they can only act on players with a lower weight than theirs, never on themselves,
- they can only give permissions they have themselves, and never wildcards.
Operators and the console are not limited.
Permissions
| Permission | What it grants | Default |
|---|---|---|
inglis.ranks.admin |
Use /rank. |
Operators |
Placeholders
| Placeholder | Shows |
|---|---|
%ingliscore_rank% |
ID of the player's primary rank |
%ingliscore_rank_display% |
Display name of the rank shown for the player |
%ingliscore_rank_weight% |
Weight of the primary rank |
%ingliscore_prefix% |
Prefix, colored |
%ingliscore_prefix_raw% |
Prefix with its & codes, uncolored |
%ingliscore_suffix% |
Suffix |
%ingliscore_namecolor% |
Name color |
See placeholders for the full list.
Tips
- With the Identity module, players can choose which of their ranks is displayed with
/prefix. - Wildcards such as
*never grantinglis.sanctions.exemptor theinglis.sanctions.limit.permissions of the Punishments module. Add them by their full name to the ranks that need them. - Prefixes support hex colors and gradients, like the default MVP rank.