NetworkNick
NetworkNick 是一款轻量级、支持网络感知的 Paper 和 Spigot 昵称插件,提供持久化且基于 Redis 的昵称功能,完全支持 PlaceholderAPI、LuckPerms 以及现代多服务器环境。
专为现代服务器和代理网络设计,NetworkNick 专注于正确性、时机和兼容性——确保昵称在加入消息之前生效、在所有服务器间即时同步,并尊重离线权限。
更新日志
1.0.1
- 通过 Redis 实现全服昵称
- 加入时的正确性(
%player_displayname% 可在加入消息中正常工作)
- 离线安全的昵称豁免(LuckPerms 集成)
- 隐藏/取消隐藏系统,支持恢复之前的昵称
- 强大的强制机制,防止插件延迟覆盖
- PlaceholderAPI 支持
- 干净的重新加载支持
- 兼容 Paper & Spigot(无需 NMS,无需 ProtocolLib)
概述
NetworkNick 允许玩家设置满足以下条件的昵称:
- 在重启和重连后保持持久
- 在多个后端服务器之间即时同步
- 在加入消息、聊天、TAB 列表和计分板中正确显示
- 尊重权限、格式化规则和离线豁免
该插件以 Redis 作为唯一事实来源,并精心处理加入时机,以确保 %player_displayname% 始终反映正确的昵称。
核心功能
昵称
- 使用
/nick 设置自定义昵称
- 支持旧版颜色代码(
&a)和十六进制颜色(&#RRGGBB)
- 可选的格式化权限(
&l、&o、&k 等)
- 安全长度限制(3–16 个可见字符)
隐藏 / 取消隐藏
/hide 使用 &k 混淆你的名称
/unhide 恢复你之前的昵称或真实姓名
- 之前的昵称被安全存储并正确恢复
网络同步
- 基于 Redis 的昵称存储
- 所有服务器间的实时更新
- 在加入、重新加载和重连时自动重新应用
豁免玩家
networknick.exempt 防止其他玩家更改或取消隐藏你的昵称
- 使用 LuckPerms API 检查权限,即使玩家离线也能生效
- 安全的异步处理(不阻塞主线程)
强制系统
- 可选的短期强制机制,以应对延迟的插件覆盖
- 保护免受那些在加入后重置显示名称的插件影响
占位符支持
- PlaceholderAPI 集成
- 用于网络感知名称处理的自定义占位符
依赖项
- Java 21
- Paper 或 Spigot 1.20+
- Redis 服务器(必需)
- 可选但推荐:LuckPerms
- 可选:PlaceholderAPI
安装
单服务器设置
- 下载
NetworkNick-1.0.0.jar
- 将其放入服务器的
plugins/ 目录
- 启动服务器
- 配置权限(推荐使用 LuckPerms)
- 重新启动服务器或运行
/networknick reload
多服务器设置
推荐用于 Velocity 或 BungeeCord 环境。
要求
- 共享 Redis 实例
- 所有后端服务器上的插件配置一致
步骤
- 配置 Redis 连接
- 确保所有后端服务器连接到同一个 Redis 实例
- 重新启动所有服务器
功能
Redis 作为唯一事实来源
本地缓存是临时的且安全的
命令
玩家命令
| 命令 |
描述 |
权限 |
/nick <name> |
设置你的昵称 |
networknick.nick |
/nick off |
清除你的昵称 |
networknick.nick.clear |
/hide |
隐藏你的名字 |
networknick.hide |
/unhide |
恢复你的名字 |
networknick.unhide |
管理员命令
| 命令 |
描述 |
权限 |
/nick <player> <name> |
设置其他玩家的昵称 |
networknick.nick.others |
/nick <player> off |
清除其他玩家的昵称 |
networknick.nick.others.clear |
/unhide <player> |
取消隐藏其他玩家 |
networknick.unhide.others |
/networknick reload |
重新加载配置和 Redis |
networknick.reload |
权限
核心
| 权限 |
描述 |
默认值 |
networknick.nick |
使用 /nick |
op |
networknick.nick.clear |
清除自己的昵称 |
op |
networknick.hide |
使用 /hide |
op |
networknick.unhide |
使用 /unhide |
op |
管理
| 权限 |
描述 |
networknick.nick.others |
设置他人的昵称 |
networknick.nick.others.clear |
清除他人的昵称 |
networknick.unhide.others |
取消隐藏他人 |
格式化
| 权限 |
描述 |
networknick.nick.colors |
颜色和十六进制代码 |
networknick.nick.format.k |
混淆 |
networknick.nick.format.l |
粗体 |
networknick.nick.format.m |
删除线 |
networknick.nick.format.n |
下划线 |
networknick.nick.format.o |
斜体 |
networknick.nick.format.r |
重置 |
保护
| 权限 |
描述 |
networknick.exempt |
防止他人更改或取消隐藏你的昵称 |
(PlaceholderAPI)
| 占位符 |
描述 |
%networknick_name% |
可见昵称(或真实姓名) |
%networknick_unhidden% |
真实姓名或之前的昵称 |
%networknick_hidden% |
true 或 false |
注意:%player_displayname% 也将反映昵称,因为 NetworkNick 在处理加入消息之前就会应用它。如果你使用的是 Essentials,请确保在其配置中将 change-displayname 设置为 false。
计划中的增强
许可证
根据 Apache License, Version 2.0 授权
详细信息请参阅 LICENSE。
致谢
由 Chumbucket 开发
为 Chumbucket Network 构建
© 2025 Chumbucket — Apache-2.0 License
NetworkNick
NetworkNick is a lightweight, network-aware nickname plugin for Paper and Spigot that provides persistent, Redis-backed nicknames with full support for PlaceholderAPI, LuckPerms, and modern multi-server environments.
Designed for modern servers and proxy networks, NetworkNick focuses on correctness, timing, and compatibility — ensuring nicknames apply before join messages, sync instantly across servers, and respect offline permissions.
Changelog
1.0.1
- Network-wide nicknames via Redis
- Join-time correctness (
%player_displayname% works in join messages)
- Offline-safe nickname exemption (LuckPerms integration)
- Hide / unhide system with prior nickname restoration
- Robust enforcement against late plugin overrides
- PlaceholderAPI support
- Clean reload support
- Paper & Spigot compatible (no NMS, no ProtocolLib)
Overview
NetworkNick allows players to set nicknames that:
- Persist across restarts and reconnects
- Synchronize instantly across multiple backend servers
- Appear correctly in join messages, chat, TAB, and scoreboards
- Respect permissions, formatting rules, and offline exemptions
The plugin is built around a Redis source of truth, with careful handling of join timing to ensure %player_displayname% always reflects the correct nickname.
Core Features
Nicknames
- Set custom nicknames with
/nick
- Supports legacy color codes (
&a) and hex colors (&#RRGGBB)
- Optional formatting permissions (
&l, &o, &k, etc.)
- Safe length enforcement (3–16 visible characters)
Hide / Unhide
/hide obfuscates your name using &k
/unhide restores your previous nickname or real name
- Prior nicknames are stored safely and restored correctly
Network Sync
- Redis-backed nickname storage
- Real-time updates across all servers
- Automatic re-application on join, reload, and reconnect
Exempt Players
networknick.exempt prevents other players from changing or unhiding your nickname
- Uses the LuckPerms API to check permissions even when the player is offline
- Safe asynchronous handling (no main-thread blocking)
Enforcement System
- Optional short-term enforcement to beat late plugin overrides
- Protects against plugins that reset display names after join
Placeholder Support
- PlaceholderAPI integration
- Custom placeholders for network-aware name handling
Requirements
- Java 21
- Paper or Spigot 1.20+
- Redis server (required)
- Optional but recommended: LuckPerms
- Optional: PlaceholderAPI
Installation
Single-Server Setup
- Download
NetworkNick-1.0.0.jar
- Place it in your server’s
plugins/ directory
- Start the server
- Configure permissions (LuckPerms recommended)
- Restart or run
/networknick reload
Multi-Server Setup
Recommended for Velocity or BungeeCord environments.
Requirements
- Shared Redis instance
- Identical plugin configuration across all backend servers
Steps
- Configure Redis connectivity
- Ensure all backend servers connect to the same Redis instance
- Restart all servers
Features
- Network-wide nicknames
- Instant synchronization across servers
- Consistent join messages everywhere
Redis acts as the source of truth
Local caches are ephemeral and safe
Commands
Player Commands
| Command |
Description |
Permission |
/nick <name> |
Set your nickname |
networknick.nick |
/nick off |
Clear your nickname |
networknick.nick.clear |
/hide |
Hide your name |
networknick.hide |
/unhide |
Restore your name |
networknick.unhide |
Admin Commands
| Command |
Description |
Permission |
/nick <player> <name> |
Set another player’s nickname |
networknick.nick.others |
/nick <player> off |
Clear another player’s nickname |
networknick.nick.others.clear |
/unhide <player> |
Unhide another player |
networknick.unhide.others |
/networknick reload |
Reload config and Redis |
networknick.reload |
Permissions
Core
| Permission |
Description |
Default |
networknick.nick |
Use /nick |
op |
networknick.nick.clear |
Clear own nickname |
op |
networknick.hide |
Use /hide |
op |
networknick.unhide |
Use /unhide |
op |
Moderation
| Permission |
Description |
networknick.nick.others |
Set others’ nicknames |
networknick.nick.others.clear |
Clear others’ nicknames |
networknick.unhide.others |
Unhide others |
Formatting
| Permission |
Description |
networknick.nick.colors |
Color and hex codes |
networknick.nick.format.k |
Obfuscated |
networknick.nick.format.l |
Bold |
networknick.nick.format.m |
Strikethrough |
networknick.nick.format.n |
Underline |
networknick.nick.format.o |
Italic |
networknick.nick.format.r |
Reset |
Protection
| Permission |
Description |
networknick.exempt |
Prevent others from changing or unhiding your nickname |
(PlaceholderAPI)
| Placeholder |
Description |
%networknick_name% |
Visible nickname (or real name) |
%networknick_unhidden% |
Real name or prior nickname |
%networknick_hidden% |
true or false |
Note: %player_displayname% will also reflect the nickname, as NetworkNick applies it before join messages are processed. Just make sure if you're using essentials you have change-displayname set to false in their config.
Planned Enhancements
- None currently. Open to suggestions
License
Licensed under the Apache License, Version 2.0
See LICENSE for details.
Credits
Developed by Chumbucket
Built for the Chumbucket Network
© 2025 Chumbucket — Apache-2.0 License
评论 0
登录后参与评分
还没有评论,来抢沙发吧