昵称
一款 Minecraft 模组/插件,添加了简单的昵称系统。玩家可更改一次显示名称;服务器管理员可自由管理昵称。
支持 Forge (1.20.1)、Fabric (1.21.1) 以及 Bukkit/Paper/Purpur (1.21.1)。
功能
/nick <name> — 设置自己的昵称(每位玩家限用一次)
/nick set <player> <name> — 管理员:设置玩家的昵称
/nick reset <player> — 管理员:重置玩家的昵称
/nick list — 管理员:列出所有昵称及其状态
- 昵称会显示在聊天、TAB 列表及玩家头顶上方
- 昵称同步至客户端以正确渲染名字牌
- 该模组在客户端为可选安装——服务端可独立运行,客户端仅用于接收名字牌同步数据
- 支持本地化(英语、俄语)
- 昵称数据持久化存储于
config/nicknames/nicknames.json(Forge/Fabric)或 plugins/Nicknames/nicknames.json(Bukkit)
客户端 - 服务端架构
该模组使用自定义频道 nicknames:sync 来同步服务端与客户端之间的昵称信息。
服务端存储所有昵称,是数据的唯一来源。当昵称发生变更或有玩家加入时,服务端会将完整的昵称映射表(UUID -> 显示名称)发送给所有已连接的客户端。
客户端(可选)接收同步数据包并在本地缓存昵称。此缓存用于在玩家头顶上方渲染昵称(即名字牌)。若无客户端模组,玩家仍能在聊天和 TAB 列表中看到昵称——这些内容由服务端处理。
该方案跨平台兼容:Bukkit/Purpur 服务端可通过 Plugin Messaging 向 Forge 或 Fabric 客户端同步昵称。
| 服务端 |
客户端 |
聊天 |
TAB |
名字牌 |
| Forge |
Forge |
是 |
是 |
是 |
| Fabric |
Fabric |
是 |
是 |
是 |
| Bukkit |
Forge/Fabric |
是 |
是 |
是 |
| 任意 |
Vanilla |
是 |
是 |
否 |
项目结构
nicknames-mod/
common/ — 共享代码(NicknameStore, NicknameProtocol, NicknameEntry)
forge/ — Forge 1.20.1 模组(含客户端与服务端)
fabric/ — Fabric 1.21.1 模组(含客户端与服务端)
bukkit/ — Bukkit/Paper/Purpur 1.21.1 插件(仅服务端)
安装
Forge (1.20.1)
将 forge/build/libs/ 目录下的 nicknames-mod-x.x.x.jar 放入 mods/ 文件夹(服务端及可选的客户端均需放置)。
Fabric (1.21.1)
将 fabric/build/libs/ 目录下的 fabric-x.x.x.jar 放入 mods/ 文件夹。需要 Fabric API。
Bukkit/Paper/Purpur (1.21.1)
将 bukkit/build/libs/ 目录下的 nicknames-bukkit-x.x.x.jar 放入 plugins/ 文件夹。
构建
./gradlew build
一次性构建所有模块,或针对特定模块进行构建:
./gradlew :forge:build
./gradlew :fabric:build
./gradlew :bukkit:build
需要 Java 21。
许可证
MIT
Nicknames
A Minecraft mod/plugin that adds a simple nickname system. Players can change their display name once; server admins can manage nicknames freely.
Supports Forge (1.20.1), Fabric (1.21.1), and Bukkit/Paper/Purpur (1.21.1).
Features
/nick <name> — set your own nickname (one-time use per player)
/nick set <player> <name> — admin: set a player's nickname
/nick reset <player> — admin: reset a player's nickname
/nick list — admin: list all nicknames with status
- Nicknames appear in chat, TAB list, and above player heads
- Nicknames sync to clients for proper nameplate rendering
- Mod is optional on the client — server works standalone, client just gets nameplate sync
- Localization support (English, Russian)
- Nickname data persists in
config/nicknames/nicknames.json (Forge/Fabric) or plugins/Nicknames/nicknames.json (Bukkit)
Client-Server Architecture
The mod uses a custom nicknames:sync channel to synchronize nicknames between server and clients.
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.
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 — those are handled server-side.
This works across platforms: a Bukkit/Purpur server can sync nicknames to Forge or Fabric clients via Plugin Messaging.
| Server |
Client |
Chat |
TAB |
Nameplates |
| Forge |
Forge |
yes |
yes |
yes |
| Fabric |
Fabric |
yes |
yes |
yes |
| Bukkit |
Forge/Fabric |
yes |
yes |
yes |
| Any |
Vanilla |
yes |
yes |
no |
Project Structure
nicknames-mod/
common/ — shared code (NicknameStore, NicknameProtocol, NicknameEntry)
forge/ — Forge 1.20.1 mod (client+server)
fabric/ — Fabric 1.21.1 mod (client+server)
bukkit/ — Bukkit/Paper/Purpur 1.21.1 plugin (server-only)
Installation
Forge (1.20.1)
Drop nicknames-mod-x.x.x.jar from forge/build/libs/ into the mods/ folder (server and optionally client).
Fabric (1.21.1)
Drop fabric-x.x.x.jar from fabric/build/libs/ into the mods/ folder. Requires Fabric API.
Bukkit/Paper/Purpur (1.21.1)
Drop nicknames-bukkit-x.x.x.jar from bukkit/build/libs/ into the plugins/ folder.
Building
./gradlew build
Build all modules at once, or target a specific one:
./gradlew :forge:build
./gradlew :fabric:build
./gradlew :bukkit:build
Requires Java 21.
License
MIT
评论 0
登录后参与评分
还没有评论,来抢沙发吧