- 版权类型
- 原创
- 插件中文名称
- 航式昵称
- 插件英文名称
- HangNick
- 原帖地址
- #
- 支持的核心(服务端)
- Spigot
- Paper
- Folia
- Purpur
- PufferFish
- SpongeVanilla
- Leaves
- 其他核心
- 语言支持
- 中文(简体)
- 前置组件
- PlaceholderAPI
- 适配版本(Java)
- 1.21
- 1.20
- 1.19
- 1.18
- 1.17
- 1.16
- 1.15
- 1.14
- 1.13
- 1.12
- 1.11
- 1.10
- 1.9
- 1.8
[MD]### 🎯 插件简介
**HangNick** 是一款功能完善的昵称管理插件,属于 **Hang系列插件** 之一。玩家可以自定义游戏内昵称,支持颜色代码,并提供改名卡系统,让服务器的昵称管理更加灵活有趣!
### ✨ 功能特性
- 🎨 **自定义昵称** - 玩家可设置个性化昵称,支持颜色代码(&颜色)和格式代码
- 🎫 **改名卡系统** - 独特的改名卡道具,手持使用可无视冷却时间
- ⏱️ **冷却机制** - 可配置的昵称更改冷却时间,防止滥用
- 🚫 **黑名单过滤** - 自定义违禁词汇列表,自动拦截不当昵称
- 📊 **PlaceholderAPI** - 提供 `%hangnick_nickname%` 变量,可在记分板、Tab等插件中显示
- 🔧 **高度可配置** - 昵称长度、冷却时间、消息等均可自定义
- 🌐 **多版本兼容** - 完美支持 **1.8 - 1.21.8** 全版本
### 📜 命令列表
| 命令 | 说明 | 权限 |
/nick <昵称> | 设置你的昵称 | hangnick.use
/nick reset | 重置昵称为游戏ID | hangnick.use
/nick card [玩家] [数量] | 给予改名卡 | hangnick.admin
/nick reload | 重载插件配置 | hangnick.admin
### 🔑 权限节点
| 权限 | 说明 | 默认 |
|------|------|------|
hangnick.use | 允许使用nick命令更改昵称 | OP
hangnick.admin | 管理员权限(重载配置、给予改名卡) | OP
hangnick.bypass.cooldown | 绕过昵称更改冷却时间 | OP
hangnick.bypass.blacklist | 绕过昵称黑名单限制 | OP
hangnick.bypass.length | 绕过昵称长度限制 | OP
### 🎫 改名卡系统
改名卡是一种特殊道具,玩家手持改名卡使用 `/nick` 命令时:
- ✅ 无视冷却时间限制
- ✅ 成功更改后自动消耗一张改名卡
- ✅ 管理员可通过 `/nick card` 命令发放
### 📊 PlaceholderAPI 变量
| 变量 | 说明 |
|------|------|
%hangnick_nickname% | 返回玩家昵称,若无昵称则返回游戏ID
可配合 TAB、记分板、聊天格式等插件使用!
---
### ⚙️ 配置文件预览
```yaml
# 昵称设置
nickname:
min-length: 2 # 最小长度
max-length: 16 # 最大长度
cooldown: 300 # 冷却时间(秒)
allow-colors: true # 允许颜色代码
allow-formats: true # 允许格式代码
# 黑名单词汇
blacklist:
enabled: true
words:
- "admin"
- "op"
- "管理员"
# ...更多自定义
[/MD]