[管理|开源] CnUsername —— 允许玩家使用中文名甚至特殊字符进入服务器[1.13.x]
本帖最后由 千千 于 2024-9-6 01:09 编辑# CnUsername
- **开发者** 0XPYEX0
- **CnUsername** 是一款支持 Minecraft 1.13+ 版本的插件，允许玩家使用中文名甚至特殊字符进入服务器。
---
### 安装教程
#### ① 以插件方式安装
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 *****
---
### 注意事项
- **Paper 及其分支服务端**：需在配置文件中将 `perform-validate-username` 设置为 `false`，否则无法进入服务器。
- **AuthMe 插件**：需在 `config.yml` 中修改 `allowedNicknameCharacters`，以允许符合正则表达式的玩家名，否则玩家无法进入服务器。
- **LuckPerms 插件**：需在 `config.yml` 中将 `allow-invalid-usernames` 设置为 `true`，以正常处理权限。
- **Skript 插件**：需在 `config.sk` 中修改 `player name regex pattern` 正则表达式，否则玩家功能无法正常使用。
---
### 有用的链接：
- (0XPYEX0/CnUsername: Allow player to use Chinese chars in username of Minecraft (github.com)) — 查看 GitHub 页面！
- [交流群](http://qm.qq.com/cgi-bin/qm/qr?_ ... roup_code=946882957)— 946882957！
- [官方交流群](http://qm.qq.com/cgi-bin/qm/qr?_ ... roup_code=546338486)— 546338486！
---
[](http://qm.qq.com/cgi-bin/qm/qr?_ ... roup_code=946882957)
---
页:
[1]