# Nicknames<\/p>\n
A Minecraft mod\/plugin that adds a simple nickname system. Players can change their display name once; server admins can manage nicknames freely.<\/p>\n
Supports Forge (1.20.1), Fabric (1.21.1), and Bukkit\/Paper\/Purpur (1.21.1).<\/p>\n
## Features<\/p>\n
– `\/nick ## Client-Server Architecture<\/p>\n The mod uses a custom `nicknames:sync` channel to synchronize nicknames between server and clients.<\/p>\n **Server** stores all nicknames and is the source of truth. When a nickname changes or a player joins, the server sends a full nickname map (UUID -> display name) to all connected clients.<\/p>\n **Client** (optional) receives the sync packet and caches nicknames locally. This cache is used to render nicknames above player heads (nameplates). Without the client mod, players still see nicknames in chat and TAB list \u2014 those are handled server-side.<\/p>\n This works across platforms: a Bukkit\/Purpur server can sync nicknames to Forge or Fabric clients via Plugin Messaging.<\/p>\n | Server | Client | Chat | TAB | Nameplates | ## Project Structure<\/p>\n “` ## Installation<\/p>\n ### Forge (1.20.1) ### Fabric (1.21.1) ### Bukkit\/Paper\/Purpur (1.21.1) ## Building<\/p>\n “` Build all modules at once, or target a specific one:<\/p>\n “` Requires Java 21.<\/p>\n ## License<\/p>\n MIT<\/p>\n","protected":false},"excerpt":{"rendered":" Simple nickname system with cross-platform sync<\/p>\n","protected":false},"featured_media":110866,"template":"","meta":{"_minecraft_slug":"nicknames","_minecraft_project_id":"HKgCPKRq","_minecraft_author":"gen1nya","_minecraft_license":"MIT","_minecraft_downloads":786,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"nicknames.zip","_minecraft_size_bytes":49504,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-15T21:58:01.283597Z","_minecraft_date_created":"2026-03-22T22:30:10.553058Z","_minecraft_date_modified":"2026-03-07T21:01:41.782076Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/nicknames","_minecraft_icon_attachment_id":110866,"_minecraft_imported_at":"2026-06-06T12:27:43+00:00","_minecraft_import_hash":"9d43bab767bee18f66ed6f31f3665e23","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,894,156,97,104,127,128,867,129,92],"mod_loader":[99],"minecraft_version":[36,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-110865","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-bungeecord","mod_category-decoration","mod_category-fabric","mod_category-forge","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_category-utility","mod_loader-fabric","minecraft_version-1-20-1","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– `\/nick set
\n– `\/nick reset
\n– `\/nick list` \u2014 admin: list all nicknames with status
\n– Nicknames appear in chat, TAB list, and above player heads
\n– Nicknames sync to clients for proper nameplate rendering
\n– Mod is **optional on the client** \u2014 server works standalone, client just gets nameplate sync
\n– Localization support (English, Russian)
\n– Nickname data persists in `config\/nicknames\/nicknames.json` (Forge\/Fabric) or `plugins\/Nicknames\/nicknames.json` (Bukkit)<\/p>\n
\n|——–|——–|——|—–|————|
\n| Forge | Forge | yes | yes | yes |
\n| Fabric | Fabric | yes | yes | yes |
\n| Bukkit | Forge\/Fabric | yes | yes | yes |
\n| Any | Vanilla | yes | yes | no |<\/p>\n
\nnicknames-mod\/
\n common\/ \u2014 shared code (NicknameStore, NicknameProtocol, NicknameEntry)
\n forge\/ \u2014 Forge 1.20.1 mod (client+server)
\n fabric\/ \u2014 Fabric 1.21.1 mod (client+server)
\n bukkit\/ \u2014 Bukkit\/Paper\/Purpur 1.21.1 plugin (server-only)
\n“`<\/p>\n
\nDrop `nicknames-mod-x.x.x.jar` from `forge\/build\/libs\/` into the `mods\/` folder (server and optionally client).<\/p>\n
\nDrop `fabric-x.x.x.jar` from `fabric\/build\/libs\/` into the `mods\/` folder. Requires Fabric API.<\/p>\n
\nDrop `nicknames-bukkit-x.x.x.jar` from `bukkit\/build\/libs\/` into the `plugins\/` folder.<\/p>\n
\n.\/gradlew build
\n“`<\/p>\n
\n.\/gradlew :forge:build
\n.\/gradlew :fabric:build
\n.\/gradlew :bukkit:build
\n“`<\/p>\n