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 required.

Make sure to install the mod on both sides for it to work properly.

!!! The Fabric version also requires the Fabric API and the Cloth Config API on both sides !!!

Usage

Set your nickname with a simple command:

/nick <nickname>

Example:

/nick Leo

To remove your nickname and return to your original name:

/unnick

Admins are able to set nicknames for other users or assign random nicks:

/setnick Donutello396 Leo
/randomnick @a

They can also unnick other users as well as list all nicked users:

/unnick all
/unnick username Donutello396
/unnick nickname Leo
/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.

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

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

Customization

Your nickname will still respect existing formatting, such as team colors set for members. Additionally, you can customize various aspects of the mod through the config file to suit your server's needs.

Known incompatibilities

Entity Culling - When viewing players through walls, sometimes their normal username appears as their nametag. To fix this, disable Entity Culling for minecraft:player in the 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

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 and the config file before reporting!

Please include as much detail as possible when reporting issues!