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](https://modrinth.com/mod/fabric-api) !!!** ## Usage Set your nickname with a simple command (Permission: `simplenicknames.nick`): ``` /nick /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](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 [Flashback](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 * **[Entity Culling](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 - 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](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!