[管理|开源] CnUsername —— 支持中文名登录与自定义命名规则[1.13-1.21.x]
本帖最后由 千千 于 2025-4-28 23:41 编辑[#简介]
---
## 🔍 核心功能
- **开发者** 0XPYEX0 | 🏷️ **兼容版本** 1.13+ 全系服务端✨
- **CnUsername** — 打破Minecraft原版命名限制，解锁中文/特殊字符登录！
---
### 🚀 特性亮点
- ✅ **原生兼容**：支持 Bukkit/Spigot/Paper 等全系服务端
- 🛠️ **智能适配**：自动处理第三方插件兼容性问题
- 🔄 **双模部署**：插件模式快速集成 / JavaAgent模式解锁完整功能
---
### 🔗 资源导航
- [官方交流群](http://qm.qq.com/q/546338486)— 546338486！
- [技术交流群](http://qm.qq.com/q/946882957)— 946882957！
- ((https://github.com/0XPYEX0/CnUsername)) — 查看 GitHub 页面
---
[#安装]
## 安装教程
#### ① 以插件方式安装
1. 在 (https://github.com/0XPYEX0/CnUsername/releases) 页面下载插件，并将其放入服务器的Plugins文件夹中。
2. 支持 Bukkit、BungeeCord 及其所有分支，如 Spigot、Paper、WaterFall 等。
3. 以插件方式加载存在一定限制，例如：
- **实体选择器不支持特殊名字玩家**：例如无法使用 `/tp` 命令，请使用 `/tp "<username>"`，其中 `<username>` 替换为玩家名字。
- **在 1.20.5+ 及 Paper 分支服务端**，玩家名字长度不能超过 16，否则无法进入服务器（使用 JavaAgent 加载方式不受此限制）。
#### ② 以 JavaAgent 方式加载
1. 在 (https://github.com/0XPYEX0/CnUsername/releases) 页面下载插件。
2. JavaAgent模式可解锁所有功能，包括但不限于：
- 支持自定义玩家名字长度，通过修改正则表达式实现。
- 支持使用原版实体选择器选择特殊名字玩家。
3. 默认正则规则为：
```regex
^{3,16}|{2,10}$
```
4. 如需自定义正则，修改启动命令为：
```bash
-javaagent:CnUsername-<version>-all.jar=<正则表达式>
```
例如：
```bash
-javaagent:CnUsername-1.0.7-all.jar=^{3,16}|{2,10}$
```
[#下载]
**** Hidden Message *****
[#注意事项]
---
### 环境要求
- **Java版本**：必须使用 JDK 11 或更高版本
- **服务端核心**：Paper/Spigot 1.13+ 及其衍生版本
---
### 常见问题
- **无法登录**：检查Java版本是否符合要求（java -version）
- **命令异常**：在LuckPerms中开启无效用户名支持
- **默认正则**: ^{3,16}|{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"`
---
支持一下，试试好不好用 好插件不错 感谢大佬分享的插件，找了许久的哈哈哈 复活！！！！！！！！ 很好用的插件 服务器可以实现特殊符号进入服务器 真的很好 66666666666666666666666666666666666666 感谢大佬分享的插件 感谢大佬分享的插件 之前还在纠结中文名的这个问题，来这逛一圈还真看到了