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 required.** Make sure to install the mod on both sides for it to work properly. **!!! The Fabric version also requires (https://modrinth.com/mod/fabric-api) on both sides !!!** ## Usage Set your nickname with a simple command: ``` /nick <nickname> ``` 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. ### Colored Names Simple Nicknames supports (https://docs.papermc.io/adventure/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 (https://modrinth.com/mod/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 * **(https://modrinth.com/mod/entityculling)** - 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 ## Support Found a bug or have a feature request? You can reach out through: * CurseForge (https://www.curseforge.com/minecraft/mc-mods/simple-nicknames/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!