Nick System

Display nicknames that hold up everywhere, without letting anyone steal an identity.

Beta. The nick system is still in beta. It works everywhere described below, but expect rough edges and report anything odd.

/nick <name> changes a player's name everywhere it is shown: chat, tab list, scoreboard, join and leave messages, private messages, /pay, /tpa, team invites and advancements. The nickname survives reloads and restarts, and /unnick (or /nick off) takes it back. Because the nickname is the name other players see, they can also use it to reach the player: /msg, /tpa, /pay and team invites all accept it.

You may still see your own real name

This is expected and not a bug: your own Minecraft client can still show you your real name in some places (for example above your own head with NickOverheadName). Everyone else sees the nickname normally. The plugin tells a player this the first time they nick.

Protection

A nickname cannot be used to impersonate someone. It is refused if it:

belongs to a real account,
is a rank name (Nick.BlockRankNames),
stands on Nick.Blacklist,
contains % (those leak through PlaceholderAPI),
or is already worn by another player.

Give muteessentials.nick.bypass to anyone who should be exempt.

Moderation is never affected: warns, kicks, bans, ranks, gamemode, /eco, /check, /invsee and the block log always act on the real account, and their tab completion completes real names.

Staff visibility

Operators and holders of muteessentials.nick.see are shown RealName (Nick) in join and leave messages, /pay, /tpa, /msg, team invites, client detection and /check. Normal players only ever see the nickname. The Admin GUI shows a player's current nickname and a nickname history with the rank that was worn, when the nickname started, when it ended and how long it lasted.

Nick with a rank

/nick <name> <rank> lets staff appear as a rank, capped at their own so nobody can nick upwards. It needs muteessentials.nick.rank, and Nick.AllowRankNick turns the whole feature off.

Nickname above the head

With ProtocolLib installed, PrefixSystem.NickOverheadName also rewrites the name above the head. It is off by default. The first time someone nicks, they are told that their own client may still show their real name to them, while everyone else sees the nickname.

Configuration

Nick:
  AllowRankNick: true
  BlockRankNames: true
  Blacklist:
    - Notch
    - Herobrine
    - Dinnerbone
    - Console
    - Server
    - Admin
    - Owner
 
PrefixSystem:
  NickOverheadName: false   # needs ProtocolLib

Key	Description
`AllowRankNick`	Master switch for `/nick <name> <rank>`.
`BlockRankNames`	Refuse nicknames that match a rank name.
`Blacklist`	Names that can never be used as a nickname.
`PrefixSystem.NickOverheadName`	Rewrite the name above the head too (needs ProtocolLib).

Commands

/nick <name> [rank] sets a nickname
/unnick (or /nick off) removes it

Permissions

Node	Grants
`muteessentials.nick`	Set or clear your own nickname
`muteessentials.nick.colors`	Use `&` color codes in nicknames
`muteessentials.nick.rank`	Use `/nick <name> <rank>`
`muteessentials.nick.bypass`	Bypass the name, blacklist and rank checks
`muteessentials.nick.see`	See `RealName (Nick)` behind nicknames (operators always have this)

Notes

If you already run a nickname or chat plugin, keep only one of them in charge to avoid two plugins fighting over the same name.
NickOverheadName needs ProtocolLib; without it, nicknames still apply everywhere except above the head.

Nick System

On this page