[管理|开源] CnUsername —— 支持中文名登录与自定义命名规则[1.13-1.21.x]

千千

• 简介
• 安装
• 下载
• 注意事项

---

🔍 核心功能

• 开发者 0XPYEX0 | 🏷️ 兼容版本 1.13+ ✨
• CnUsername — 打破Minecraft原版命名限制，解锁中文/特殊字符登录！  

---

🚀 特性亮点

• ✅ 原生兼容：支持 Bukkit/Spigot/Paper 支持作为FabricMod加载
• 🛠️ 智能适配：自动处理第三方插件兼容性问题
• 🔄 双模部署：插件模式 / JavaAgent模式

---

🔗 资源导航

• 官方交流群  — 1060596957
• 技术交流群  — 946882957！
• GitHub — 查看 GitHub 页面

---

安装教程

① 以插件方式安装

1. 在 Github Releases 页面下载插件，并将其放入服务器的Plugins文件夹中。
2. 支持 Bukkit、BungeeCord 及其所有分支，如 Spigot、Paper、WaterFall 等。
3. 以插件方式加载存在一定限制，例如：
   • 实体选择器不支持特殊名字玩家：例如无法使用 /tp 命令，请使用 /tp "<username>"，其中 <username> 替换为玩家名字。
   • 在 1.20.5+ 及 Paper 分支服务端，玩家名字长度不能超过 16，否则无法进入服务器（使用 JavaAgent 加载方式不受此限制）。

② 以 JavaAgent 方式加载

1. 在 Github Releases 页面下载插件。

2. JavaAgent模式可解锁所有功能，包括但不限于：

   • 支持自定义玩家名字长度，通过修改正则表达式实现。
   • 支持使用原版实体选择器选择特殊名字玩家。

3. 默认正则规则为：

   ^[a-zA-Z0-9_]{3,16}|[a-zA-Z0-9_一-龥]{2,10}$
   

4. 如需自定义正则，修改启动命令为：

   -javaagent:CnUsername-<version>-all.jar=<正则表达式>

   例如：

   -javaagent:CnUsername-1.0.7-all.jar=^[a-zA-Z0-9_]{3,16}|[a-zA-Z0-9_一-龥]{2,10}$

③ 以 FabricMod 方式加载

1. 在 Github Releases 页面下载插件。

2.单人模式下直接装入mod文件夹即可
3.多人游戏（服务器） 直接装入服务端mod文件夹即可

游客，如果您要查看本帖隐藏内容请回复

---

环境要求

• Java版本：必须使用 JDK 11 或更高版本
• 服务端核心：Paper/Spigot 1.13+ 及其衍生版本

---

常见问题

• 无法登录：检查Java版本是否符合要求（java -version）
• 命令异常：在LuckPerms中开启无效用户名支持
• 默认正则: ^[a-zA-Z0-9_]{3,16}|[a-zA-Z0-9_一-龥]{2,10}$

---

必要配置项

• Paper系服务端：需设置perform-validate-username: false，否则玩家无法加入
• AuthMe：需配置allowedNicknameCharacters这代表被允许玩家名的正则表达式，否则玩家无法加入
• LuckPerms：需启用allow-invalid-usernames: true，否则权限系统异常
• Skript：需修改player name regex pattern限制，为正则表达式否则无法正常使用
• Docker环境：出现java.nio.file.InvalidPathException: Malformed input or input contains unmappable characters可通过设置Java环境参数来解决 : JAVA_TOOL_OPTIONS='-Dfile.encoding="UTF-8" -Dsun.jnu.encoding="UTF-8"

---

jkl8795462

支持一下，试试好不好用

3046260886

好插件不错

㊣China_L1B

感谢大佬分享的插件，找了许久的哈哈哈

ToTono

复活！！！！！！！！

Mr_Strin

很好用的插件 服务器可以实现特殊符号进入服务器 真的很好

风云极

66666666666666666666666666666666666666

BeiQ

感谢大佬分享的插件

BeiQ

感谢大佬分享的插件

1313513113

之前还在纠结中文名的这个问题，来这逛一圈还真看到了