NetworkNick

插件

· 作者 Sorekill

基于 REDIS 的网络轻量级昵称插件 /nick & /hide

0 本站下载 0 关注 更新于 10 个月前

最新 1.0.1 · 1.21.11 · Paper / Spigot

一键开服(送7天)

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

安装

单服务器设置

  1. 下载 NetworkNick-1.0.0.jar
  2. 将其放入服务器的 plugins/ 目录
  3. 启动服务器
  4. 配置权限(推荐使用 LuckPerms)
  5. 重新启动服务器或运行 /networknick reload

多服务器设置

推荐用于 Velocity 或 BungeeCord 环境。

要求

  • 共享 Redis 实例
  • 所有后端服务器上的插件配置一致

步骤

  1. 配置 Redis 连接
  2. 确保所有后端服务器连接到同一个 Redis 实例
  3. 重新启动所有服务器

功能

  • 全服昵称
  • 服务器间即时同步
  • 各处一致的加入消息

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

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源