MCBBS纪念版

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

---

作者: 千千    时间: 2024-9-5 22:03
标题: [管理|开源] CnUsername —— 支持中文名登录与自定义命名规则[1.13-1.21.x]


[tabcard]
[#简介]

---

🔍 核心功能

• 开发者 0XPYEX0 | 🏷️ 兼容版本 1.13+ 全系服务端  ✨


• CnUsername — 打破Minecraft原版命名限制，解锁中文/特殊字符登录！  

---

🚀 特性亮点

• ✅ 原生兼容：支持 Bukkit/Spigot/Paper 等全系服务端


• 🛠️ 智能适配：自动处理第三方插件兼容性问题


• 🔄 双模部署：插件模式快速集成 / JavaAgent模式解锁完整功能

---

🔗 资源导航

• 官方交流群  — 546338486！


• 技术交流群  — 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}$

   
   

[#下载]



[#注意事项]

---

环境要求

• 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"

---

[/tabcard]

---

作者: jkl8795462    时间: 2024-9-21 02:39
支持一下，试试好不好用

---

作者: 3046260886    时间: 2024-10-5 20:55
好插件不错

---

作者: ㊣China_L1B    时间: 2024-10-28 10:48
感谢大佬分享的插件，找了许久的哈哈哈

---

作者: ToTono    时间: 2024-11-3 04:19
复活！！！！！！！！

---

作者: Mr_Strin    时间: 2024-11-8 22:17
很好用的插件 服务器可以实现特殊符号进入服务器 真的很好

---

作者: 风云极    时间: 2024-11-17 13:18
66666666666666666666666666666666666666

---

作者: BeiQ    时间: 2024-12-1 00:02
感谢大佬分享的插件

---

作者: BeiQ    时间: 2024-12-10 18:58
感谢大佬分享的插件

---

作者: 1313513113    时间: 2024-12-20 05:00
之前还在纠结中文名的这个问题，来这逛一圈还真看到了

---

作者: 二狗子    时间: 2024-12-27 16:49
支持一下服务器安装刚刚好

---

作者: SOYU    时间: 2025-1-3 21:40
插件不错，感谢大佬的分享

---

作者: 风旅    时间: 2025-1-4 05:20
感谢大佬分享插件

---

作者: sh_syl    时间: 2025-1-5 14:32
真是个好插件

---

作者: perpekura    时间: 2025-1-9 22:20
66666666正好需要

---

作者: pafyumu621    时间: 2025-1-12 00:33
感谢分享

---

作者: YiQingKong    时间: 2025-1-13 17:46
这个看起来还挺有用的

---

作者: grrgdg    时间: 2025-1-19 07:44
gfybyngbfdfdf

---

作者: linhq    时间: 2025-1-19 08:45

支持一下，试试好不好用

---

作者: 绯红鸢尾花    时间: 2025-1-19 15:19
感谢楼主！！！！！！！

---

作者: cnwbhw    时间: 2025-1-22 16:19
可以的，支持一下大佬牛逼

---

作者: JingYi    时间: 2025-1-23 19:41
很好的插件!

---

作者: 1632131200    时间: 2025-1-26 12:17
好插件，谢谢分享

---

作者: BrAeRd    时间: 2025-1-26 19:19
感谢楼主分享，拿走了

---

作者: xiaobu1234    时间: 2025-1-29 19:47
6666666666666666666

---

作者: mp1254    时间: 2025-2-8 20:34
感谢分享

---

作者: s262290447400    时间: 2025-2-9 12:50
666666666666666

---

作者: UncleMan_    时间: 2025-2-12 13:51
很好用的插件 服务器可以实现特殊符号进入服务器 真的很好

---

作者: 永不磨灭的爱    时间: 2025-2-19 08:26

---

作者: chaohongyan    时间: 2025-2-19 22:46
真的很好啊 这个插件喜欢

---

作者: 童子菌    时间: 2025-2-19 23:03
泰裤辣

---

作者: wtw666    时间: 2025-2-22 08:39
nb6666666666666

---

作者: gudu    时间: 2025-2-22 08:54
好找了半天终于找到了

---

作者: ljjyyds13    时间: 2025-2-24 18:30
找了好久哈哈哈

---

作者: dddfly    时间: 2025-2-27 12:18
感谢大佬的分享

---

作者: 1808732262    时间: 2025-3-8 22:49
可以的好用爱用多用

---

作者: 天羽啊_    时间: 2025-3-11 14:16
感谢楼主分享

---

作者: w2848721593    时间: 2025-3-14 11:26
正好需要

---

作者: yishengbeili    时间: 2025-3-17 09:29
12345678910

---

作者: ftcpear    时间: 2025-3-22 14:26
感谢大佬分享

---

作者: zhanshenhu    时间: 2025-3-22 22:28
6666666666666666666666666666666666

---

作者: chenbolin    时间: 2025-3-29 17:11

支持一下，试试好不好用

---

作者: beizhiloji    时间: 2025-4-1 20:07
试试一直都不能中文敲敲敲

---

作者: cc120747    时间: 2025-4-3 12:32
我测试一下能不能使用！！！！

---

作者: aema19    时间: 2025-4-13 16:19
111111111114

---

作者: Yevah    时间: 2025-4-15 01:16
好用吗？111111111

---

作者: 蹦野迪    时间: 2025-4-15 18:55
感谢大佬分享！

---

作者: 1008611    时间: 2025-4-16 18:06
哈哈哈哈哈哈太好了

---

作者: 奇怪的艺术    时间: 2025-4-16 23:09
这个模组 比如给与权限是给中文名字还是原版id

---

作者: shiyushui    时间: 2025-4-19 06:59
感谢大佬

---

作者: 李光六    时间: 2025-4-20 17:37
1111111111

---

作者: MaoYuNa133    时间: 2025-4-29 19:08
喵喵喵喵喵喵喵喵喵

---

作者: 718972547    时间: 2025-4-30 19:11
66666666666666666666666666666

---

作者: 718972547    时间: 2025-4-30 19:12
喵喵喵喵喵喵喵喵喵喵喵喵喵喵

---

作者: Luoluoi    时间: 2025-5-1 17:26
棒棒的支持支持

---

作者: bxwll    时间: 5 天前
很好的插件使我的中文名进入

---

作者: 2430871184    时间: 4 天前
1111111111111111111111

---

欢迎光临 MCBBS纪念版 (https://mcbbs.win/)

Powered by Discuz! X3.5