Documentation
EssentialsFree

Identity

Nicknames with history, a displayed rank chosen by the player, and the /realname, /whois and /seen commands.

The Identity module is about who players are and how they appear. Players can pick a nickname (freely or from a list you prepare) and choose which of their ranks is displayed. Everyone can look up a player with /whois or /seen, and find the real name behind a nickname with /realname.

Features

  • Nicknames shown in the chat and the tab list, shared by all the servers of your network.
  • Per rank control: for each rank, decide if players can change their nickname, and how: not at all, only from your list, freely, or both. Minimum and maximum length are also set per rank.
  • Nickname list: a list of ready made nicknames, each one available to everyone or only to some ranks.
  • Protection: allowed characters, banned words (also caught when written as 4dm1n), unique nicknames on the network, and protection of the real names of other players. Colors are never allowed in nicknames.
  • Real name on hover in the chat.
  • Nickname history and staff tools in the player profile: remove a nickname, or block nickname changes for a while or forever.
  • Displayed rank: players who own several ranks choose which one is shown with /prefix. When they get a new rank, the display goes back to automatic so the new rank shows.
  • Player profile with /whois, where you choose which information is shown and what only staff can see.
  • Last seen with /seen, on the whole network.

Setting it up

Open the Identity module in the web editor.

Nicknames and profile tab

Commands lists the five commands of the module. Open a card to set its aliases, permission, worlds and, rank by rank, access, cooldown and price (see commands). The /nick card also has, for each rank:

Limit What it does
Nickname Not allowed, From the list, Free or Free or from the list.
Minimum length Shortest nickname allowed.
Maximum length Longest nickname allowed (32 at most).

By default, players without a listed rank cannot change their nickname. The default rows give the vip rank the list only, the mvp rank the list or a free nickname, and the admin rank free nicknames up to 24 characters. Adapt them to your own ranks.

The /nick, /prefix and /whois cards also let you choose between Opens a menu and Answers in the chat. With the menu, /nick shows the nicknames of the list the player may use, plus a button to type a nickname in the chat when free nicknames are allowed.

Nicknames to choose from is your nickname list. For each nickname, leave the ranks empty to offer it to everyone, or list ranks separated by commas.

/whois profile chooses what /whois shows. For each piece of information, Shown turns it on and Staff only hides it from regular players:

Information Shown by default Staff only by default
Real name, Nickname, Displayed rank, First join, Last seen, Playtime, Current server, Balance, Level Yes No
All ranks No No
Position, Game mode Yes Yes
IP address, Alt accounts Yes Always

Balance needs the economy module and Level needs the progress module.

Settings tab

Setting What it does Default
Allowed characters Letters, digits, _ and spaces, Letters, digits and _, Also accented letters or Also common symbols. Letters, digits, _ and spaces
Banned words Words a nickname cannot contain. Also caught when written with numbers or symbols. A list of common offensive and staff words
Unique on the network Two players cannot have the same nickname. Off
Protect real names Nobody can take the name of another player as a nickname, even with a lookalike spelling of an online player. Off
Real name on hover Hovering a nickname in the chat shows the real name. Off

Player profile

In Players, the Identity tab of a player shows the current nickname and the Nickname history (old and new nickname, who changed it and when). From there you can:

  • Remove the nickname.
  • Block nickname changes for a duration such as 1d or 2w, or permanently if you leave it empty. Allow changes again lifts the block.

Commands

All the commands of this module can have their aliases, permission, cooldown, price, worlds and rank rules changed in the editor. See commands.

Command What it does Default permission
/nick [nickname] Changes your nickname, freely or from the list. Without argument, opens the nickname menu. Alias: /nickname. inglis.identity.nick
/nick off Removes your nickname. inglis.identity.nick
/nick <player> <nickname> Changes the nickname of another player. inglis.identity.nick.others
/nick <player> off Removes the nickname of another player. inglis.identity.nick.others
/prefix [rank] Chooses which of your ranks is shown. /prefix auto goes back to your highest rank. Aliases: /title, /tag. inglis.identity.prefix
/realname <nickname> Finds the real name behind a nickname. Alias: /whoisnick. inglis.identity.realname
/whois <player> Profile of a player. Aliases: /pinfo, /playerinfo. inglis.identity.whois
/seen <player> Last time a player was seen on the network, or the server they are on. Alias: /lastseen. inglis.identity.seen

/prefix needs the ranks module with Rank management set to the InglisCore system. In LuckPerms mode it is not available.

Permissions

Permission What it grants Default
inglis.identity.nick.others Change or remove the nickname of other players. Operators
inglis.identity.nick.bypass Ignore banned words and real name protection. Operators
inglis.identity.whois.staff See the information marked Staff only in /whois. Operators

Placeholders

Placeholder Shows
%ingliscore_nick% Nickname of the player, empty if none.
%ingliscore_displayname% Nickname of the player, or the real name if none.