
Nicked
支持更换皮肤、提供开发者 API 及 PlaceholderAPI 支持的包级昵称插件。
Nicked 将玩家的名字和皮肤替换为他人的。其他玩家只能看到新的身份。Nicked 在包级别重写数据,因此无需客户端模组。
功能
- 包级昵称。 Nicked 在任何数据包到达客户端之前,在
PLAYER_INFO_UPDATE 数据包内重写名字。无需客户端模组。兼容 Paper、Spigot、Purpur、Folia 和 Bukkit 1.20+。
- 更换皮肤。 Nicked 在主线程之外获取匹配的 Mojang 皮肤,并将其注入同一数据包中。被伪装的玩家也能在第一人称视角看到自己的新皮肤,此功能可关闭。
- 身份泄露防护。 Minecraft 会根据真实姓名生成死亡、加入/离开以及进度广播,这会暴露伪装玩家的真实身份。Nicked 可以重写这些广播以使用昵称,并在无法获取伪装皮肤时隐藏真实皮肤。每个开关都是独立的,且默认处于关闭状态。
- 随机昵称。 不带参数运行
/nick 即可从配置好的池中抽取一个名字。
- 持久化。 昵称在断开连接和服务器完全重启后依然保留。Nicked 将它们存储在
plugins/Nicked/nicks.yml 中,并在玩家加入时重新应用。
- 开发者 API。 其他插件可以读取昵称状态、应用或移除昵称,并监听五种昵称事件(
NickApplyEvent、NickRemoveEvent、NickChangeEvent、NickRandomSelectEvent、NickResolveEvent)。
- PlaceholderAPI 支持。 为任何读取 PlaceholderAPI 的聊天、记分板或标签页插件提供三个占位符:
%nicked_displayname%: 玩家当前的显示名称(昵称或真实姓名)
%nicked_is_nicked%: true / false
%nicked_real_name%: 玩家的实际用户名
- 自定义消息。 您可以在
messages.yml 中使用 MiniMessage 编辑每条消息。渐变、十六进制颜色和悬停事件均有效。
兼容性
| 平台 |
支持情况 |
| Paper 1.20+ |
✅ |
| Spigot 1.20+ |
✅ |
| Purpur 1.20+ |
✅ |
| Folia 1.20+ |
✅ |
| Bukkit 1.20+ |
✅ |
| Java |
需要 21+ |
可选软依赖: PlaceholderAPI 启用 %nicked_*% 占位符。
命令
| 命令 |
描述 |
权限 |
/nick [name] |
为自己设置昵称(若未提供名字则随机);若已设置昵称则取消 |
nicked.command.nick |
/unnick |
移除自己的昵称 |
nicked.command.unnick |
/nickother <player> <name> |
为其他玩家设置特定名字的昵称 |
nicked.command.nickother |
/nickall |
随机为所有在线玩家设置昵称 |
nicked.command.nickall |
/realname <name> |
揭示某个昵称背后的真实用户名 |
nicked.command.realname |
nicked.admin 权限涵盖所有命令,默认授予 OP。
快速开始
- 将
Nicked.jar 放入服务器的 plugins/ 文件夹。
- 重启服务器。Nicked 会生成
plugins/Nicked/config.yml 和 messages.yml。
- 将
nicked.admin 权限授予受信任的工作人员(OP 默认拥有该权限)。
- 运行
/nick Dream。你的名字和皮肤会立即改变。
- 再次运行
/nick(不带参数)或 /unnick 以恢复原状。
开发者 API
通过 JitPack 将 Nicked 添加为仅编译依赖项:
Gradle (Groovy)
repositories {
maven { url 'https://jitpack.io' }
}
dependencies {
compileOnly 'net.pharogames:Nicked:VERSION:api'
}
Maven
<repository>
<id>jitpack.io</id>
<url>https://jitpack.io</url>
</repository>
<dependency>
<groupId>net.pharogames</groupId>
<artifactId>Nicked</artifactId>
<version>VERSION</version>
<classifier>api</classifier>
<scope>provided</scope>
</dependency>
将 VERSION 替换为最新的发布标签(例如 v1.1.0)。请参阅 API 文档 获取完整参考。
链接
许可证
Nicked 采用 MIT License 授权。

Nicked
Packet-level nickname plugin with skin changing, a developer API, and PlaceholderAPI support.
Nicked replaces a player's name and skin with someone else's. Other players see only the new identity. Nicked rewrites it at the packet level, so nobody needs a client mod.
Features
- Packet-level nicking. Nicked rewrites names inside
PLAYER_INFO_UPDATE packets before they reach any client. No client mods needed. Runs on Paper, Spigot, Purpur, Folia, and Bukkit 1.20+.
- Skin changing. Nicked fetches the matching Mojang skin off the main thread and injects it into the same packet. The nicked player sees their own new skin in first-person too, which you can turn off.
- Identity leak protection. Minecraft builds death, join/leave, and advancement broadcasts from the real name, which gives a nicked player away. Nicked can rewrite each of those to use the nick, and can hide the real skin when a nick's skin fails to fetch. Every toggle is separate and starts off.
- Random nicking. Run
/nick with no arguments to draw a name from your configured pool.
- Persistence. Nicks survive disconnects and full server restarts. Nicked stores them in
plugins/Nicked/nicks.yml and reapplies them when the player joins.
- Developer API. Other plugins can read nick state, apply or remove nicks, and listen to five nick events (
NickApplyEvent, NickRemoveEvent, NickChangeEvent, NickRandomSelectEvent, NickResolveEvent).
- PlaceholderAPI support. Three placeholders for any chat, scoreboard, or tab-list plugin that reads PlaceholderAPI:
%nicked_displayname%: the player's current display name (nick or real name)
%nicked_is_nicked%: true / false
%nicked_real_name%: the player's actual username
- Customisable messages. You edit every message in
messages.yml using MiniMessage. Gradients, hex colours, and hover events all work.
Compatibility
| Platform |
Supported |
| Paper 1.20+ |
✅ |
| Spigot 1.20+ |
✅ |
| Purpur 1.20+ |
✅ |
| Folia 1.20+ |
✅ |
| Bukkit 1.20+ |
✅ |
| Java |
21+ required |
Optional soft dependency: PlaceholderAPI enables the %nicked_*% placeholders.
Commands
| Command |
Description |
Permission |
/nick [name] |
Nick yourself (random if no name given); toggle off if already nicked |
nicked.command.nick |
/unnick |
Remove your own nick |
nicked.command.unnick |
/nickother <player> <name> |
Nick another player to a specific name |
nicked.command.nickother |
/nickall |
Randomly nick all online players |
nicked.command.nickall |
/realname <name> |
Reveal the real username behind a nick |
nicked.command.realname |
The nicked.admin permission covers every command and goes to OPs by default.
Quick Start
- Drop
Nicked.jar into your server's plugins/ folder.
- Restart the server. Nicked generates
plugins/Nicked/config.yml and messages.yml.
- Grant
nicked.admin to trusted staff (OPs already have it).
- Run
/nick Dream. Your name and skin change on the spot.
- Run
/nick again with no arguments, or /unnick, to revert.
Developer API
Add Nicked as a compile-only dependency via JitPack:
Gradle (Groovy)
repositories {
maven { url 'https://jitpack.io' }
}
dependencies {
compileOnly 'net.pharogames:Nicked:VERSION:api'
}
Maven
<repository>
<id>jitpack.io</id>
<url>https://jitpack.io</url>
</repository>
<dependency>
<groupId>net.pharogames</groupId>
<artifactId>Nicked</artifactId>
<version>VERSION</version>
<classifier>api</classifier>
<scope>provided</scope>
</dependency>
Replace VERSION with the latest release tag (e.g. v1.1.0). See the API documentation for the full reference.
Links
License
Nicked is licensed under the MIT License.
评论 0
登录后参与评分
还没有评论,来抢沙发吧