Documentation
EssentialsFree

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 namecolor meta, 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.

Tip

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 grant inglis.sanctions.exempt or the inglis.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.