Simple Nicknames

Simple Nicknames

A straightforward nickname system for your Minecraft server that allows players to customize their display names across the game.

Beta Notice

This mod is currently in beta. While it’s functional, you may encounter bugs or unexpected behavior. Please report any issues you find so I can continue improving the mod!

Installation

Both client and server installations are recommended.

You can alternatively configure the mod to be server side only, with decreased features.

!!! The Fabric version also requires Fabric API !!!

Usage

Set your nickname with a simple command (Permission: simplenicknames.nick):

/nick <nickname>
/randomnick

/randomnick can be configured to assign (former) names of random Minecraft users or generate names using the NATO phonetic alphabet.

To remove your nickname and return to your original name:

/unnick

Moderators are able to manage nicknames for other users or assign random nicks (Permission: simplenicknames.nick.any):

/setnick Donutello396 Leo
/randomnick @a
/unnick all
/unnick username Donutello396
/unnick nickname Leo

They can also list all usernames and nicknames of nicked users (Permission: simplenicknames.list):

/listnicknames

Features

Display Name Changes

Simple Nicknames changes your display name in the following locations:

• Nametag – The name displayed above your character
• Chat – Your name in chat messages
• Tab List – The player list accessible via Tab key
• Scoreboard – Your name on any scoreboards

You can configure how and where your name appears in the config file.

Colored Names

Simple Nicknames supports MiniMessage formatting. If enabled, players will be able to color/format their nickname (disabled by default).

Even without MiniMessage, your nickname will still respect existing formatting, such as team colors set for members.

Flashback

Simple Nicknames can be used with the Flashback mod on supported Fabric versions.

If you notice your nickname not appearing somewhere it should, please report it so I can add support!

Known incompatibilities

• Entity Culling – When viewing players through walls, sometimes their normal username appears as their nametag. To fix this, blacklist minecraft:player in the Entity Culling configs.

Third-party libraries

The mod files bundle third-party libraries using jar-in-jar:

• Kyori Adventure / MiniMessage / Option, licensed under the MIT License
• JetBrains Annotations, licensed under the Apache License 2.0
• JSpecify, licensed under the Apache License 2.0
• Konfig, licensed under the MIT License
• Fabric Permissions API (Fabric only), licensed under the MIT License

Support

Found a bug or have a feature request? You can reach out through:

• CurseForge mod page comments
• Discord: donutello_

Please make sure you have read this page, changelogs and the config file before reporting!

Please include as much detail as possible when reporting issues!