Nick

Nick – 昵称模组 / Nickname Mod

中文 | English | 混合 mix

此模组由AI生成(opencode内的DeepSeek V4) / AI-generated (DeepSeek V4 via opencode)

一个 Fabric 服务端模组，允许玩家修改自己的显示名称（昵称），支持团队颜色、前缀/后缀，并可通过昵称查找玩家。

A Fabric server-side mod that allows players to change their display name (nickname), supports team colors, prefixes/suffixes, and allows player lookup by nickname.

命令 / Commands

设置昵称 / Set Nickname

| 命令 / Command | 权限 / Permission | 说明 / Description |
| ——————————————- | —————– | ———————————————- |
| /nick set <昵称/nickname> | 所有人 Everyone | 设置自己的昵称 Set your own nickname |
| /nick set <目标/target> <昵称/nickname> | OP | 设置他人的昵称 Set another player’s nickname |
| /nick reset | 所有人 Everyone | 重置自己的昵称 Reset your own nickname |
| /nick reset <目标/target> | OP | 重置他人的昵称 Reset another player’s nickname |

<目标/target> 支持玩家名、@p、@a、@r、@s 等选择器。Supports player names and selectors.

昵称查找 / Nickname Lookup

设置昵称后，所有命令皆可用昵称替代玩家名。Once a nickname is set, all commands can use the nickname in place of the player name:

• /tp 小明 /tp Xiaoming
• /msg 小明 /msg Xiaoming
• /kick 小明 /kick Xiaoming

注意 Note：若昵称与真实玩家名同时存在，玩家名优先匹配。If a nickname and a real player name are identical, the real name takes priority.

昵称格式 / Nickname Format

• 单个词直接写 Single word: /nick set 小明
• 带空格的昵称用引号 Nickname with spaces, use quotes: /nick set "小明 同学"
• 会显示队伍的团队颜色、前缀和后缀 Displays team color, prefix, and suffix when applicable

效果 / Features

| 功能 Feature | 状态 Status |
| ———————————————————————————————————————————- | ———– |
| 聊天消息显示昵称 Chat messages display nickname | ✅ |
| Tab 列表显示昵称（所有客户端，无需模组）Tab list displays nickname (all clients, no mod required) | ✅ |
| 头顶名签显示昵称（单人模式/需客户端装模组）Name tag shows nickname (singleplayer / requires client mod on server) | ✅ |
| 每位置客户端显示模式（默认/仅昵称/昵称+原名/隐藏）Per-location client display modes (default/nickname only/nickname+original/hide) | ✅ |
| 团队颜色生效 Team colors apply | ✅ |
| 昵称查找玩家 Lookup players by nickname | ✅ |
| 服务端日志显示原 MCID 以适配 MCDR Server logs show original MCID for MCDR | ✅ |

安装 / Installation

服务端 / Server

1. 将 nick-*.jar 放入 mods/ 目录 Place nick-*.jar into the mods/ directory
2. 重启服务器 Restart the server

客户端（可选）/ Client (Optional)

客户端安装后，头顶名签可在服务器模式下显示昵称，并可通过客户端配置调整每位置的显示方式。不装则仅聊天和 Tab 列表生效。

When installed on the client, name tags display nicknames in server mode, and the per-location client configuration screen is available. Without the mod, chat and tab list still work.

客户端配置 / Client Configuration

自动生成 config/nick-client.json，支持层级配置：全局默认模式 + 每位置覆盖。Auto-generated, supports hierarchical config: global default + per-location overrides.

显示模式 / Display Modes

| 值 Value | 效果 Effect | 示例 Example |
| ———————– | ———————————————– | ——————– |
| "nick_only" | 仅显示昵称（默认）Show nickname only | 脏小豆 |
| "nick_and_original" | 昵称+原名 Nickname + original | [脏小豆]zxdnb |
| "hide" | 隐藏昵称，显示原名 Hide nickname, show original | zxdnb |

位置 / Locations

| 位置 Location | 作用 Effect |
| ——————- | —————————— |
| NAMETAG | 头顶名签 Overhead name tag |
| CHAT | 聊天发送者 Chat sender display |
| TARGET_SELECTOR | 选择器 Selector display |
| TAB_LIST | Tab 列表 Tab list entry |

配置文件 / Server Config

config/nick.json:

{
  "zxdnb": {"nick": "脏小豆"},
  "dongchengqiao": {"nick": "董丞乔"}
}

技术信息 / Technical Info

• Minecraft 版本 Version: 26.1
• 框架 Framework: Fabric Loader 0.19.2 / Fabric API 0.149.0+26.1.2
• Maven 组 Group: com.dongchengqiao.nick
• 主类 Main class: com.dongchengqiao.nick.Nick