GYNickNameCard
Folia 1.21.1 高兼容改名卡插件
Folia 1.21.1 高兼容改名卡插件
插件简介
GYNickNameCard 是一款面向 Folia 1.21.1 服务端开发的高兼容改名卡插件,支持玩家通过“改名卡”自定义昵称,并将昵称数据、冷却时间、原始名称等信息统一存入 MySQL,满足多服环境下的统一管理需求。
插件支持 中文昵称、特殊符号、表情符号、& 颜色代码、MiniMessage 富文本格式,可用于生存服、RPG 服、社交服、活动服等多种场景。
同时插件注重稳定性与可维护性,针对 Folia 异步架构 进行适配,不使用传统阻塞式主线程调度逻辑。
核心功能
- MySQL 数据存储
存储玩家原版名称、自定义昵称、纯文本昵称、冷却时间等数据,支持自动建表,无需手动导入 SQL。 - 跨服同步昵称数据
多个服务器共用同一 MySQL 时,可共享改名数据与冷却数据,方便跨服统一昵称系统。 - 改名卡系统
玩家右键改名卡后进入改名流程,在聊天栏输入目标昵称即可完成改名。 - 高度自定义的改名卡物品
- 支持 MiniMessage 与传统颜色代码
- &a、&b、&l 等传统颜色格式
<red>昵称</red>[/code]
<gradient:#4BD3FF:#F5FF97>渐变昵称</gradient>
- &a、&b、&l 等传统颜色格式
- 昵称安全限制
支持敏感词检测、昵称长度限制、改名冷却时间限制,防止滥用。
命令系统
支持:- /gynick reload 重载配置
/gynick give <玩家> [数量]发放改名卡
/gynick reset <玩家>重置玩家昵称
- /gynick reload 重载配置
- PlaceholderAPI 支持
提供变量:
%gynick_name%
当玩家存在自定义昵称时返回自定义昵称,否则返回原版名称。 - 消息完全可配置
插件内所有提示消息均支持配置,自带颜色与 MiniMessage 解析支持。
改名流程演示
- 玩家右键使用改名卡
- 系统提示玩家在聊天栏输入新名字
- 输入 T 或 t 可取消改名
- 输入目标昵称后自动校验长度、敏感词、冷却时间
- 校验通过后立即改名并广播
插件特性
- 完全适配 Folia
- 异步 MySQL 查询与写入
- 支持中文、表情、特殊符号昵称
- 支持 MiniMessage 富文本昵称
- 高自由度改名卡配置
- 支持 PlaceholderAPI
- 自动建表,开箱即用
- 配置清晰,便于二次修改
为什么选择 GYNickNameCard?
- 不是传统只支持 Paper/Spigot 的同步旧方案,而是面向 Folia 设计
- 兼顾 功能性、稳定性、扩展性
- 支持现代服常用的 MiniMessage 文本格式
- 适合做商城改名卡、活动奖励、权限称号拓展等玩法
适用场景
- [生存服改名卡商城]
- [RPG / 剧情服角色名系统]
- [社交服彩色昵称系统]
- [多服联动昵称同步]
- [活动服限时昵称玩法]
依赖说明
- [MySQL]
- [PlaceholderAPI]
- MiniMessage 组件解析依赖已集成
注意事项
- 使用前请先正确配置 MySQL 连接信息
如需跨服共享,请确保多台服务器连接同一数据库
如需启用变量,请安装 PlaceholderAPI
敏感词词库基于database.json进行检测