- 版权类型
- 原创
- 插件中文名称
- 中文改名卡
- 插件英文名称
- InkNickName
- 原帖地址
- #
- 支持的核心(服务端)
- 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]
### 🎯 插件简介
InkNickName(墨迹改名卡)是一款面向生存服/玩法服的改名卡插件。
支持改名卡校验、名称长度限制、禁用字符过滤、PlaceholderAPI 变量读取,以及多存储后端(Yml / MySQL / SQLite)。
---
### ✨ 功能特性
- 🎫 **改名卡校验** : 支持按物品 `name` / `lore`(可单独或组合)识别并消耗改名卡
- 📏 **长度控制** : 支持 `10` 或 `2-10` 这类长度规则
- 🚫 **禁用字符** : 支持动态添加禁用文字或符号
- 🧩 **PlaceholderAPI** : 提供改名占位符,便于记分板/聊天格式调用
- 🗃 **多存储模式** : `Yml` / `Mysql` / `QLite`
- ⚙ **热重载** : `/nickname reload`
---
### 📌 变量说明
- PlaceholderAPI 标识符:`RenameCard`
- 可用占位符:`%RenameCard_name%`
- 当玩家未设置自定义名称时,返回玩家原名。
---
### 📦 命令列表
| 命令 | 说明 | 权限 |
|---|---|---|
| `/nickname raname <名称>` | 使用改名卡修改名称 | `ink.nickname.command.use` |
| `/nickname addsymbol <字符/文字>` | 添加禁用字符 | `ink.nickname.command.addsymbol` |
| `/nickname setlength <10/2-10>` | 设置名称长度规则 | `ink.nickname.command.setlength` |
| `/nickname reload` | 重载配置与语言文件 | `ink.nickname.command.reload` |
> 别名:`/rc`、`/rcn`、`/renamecard`
---
### 🔑 权限节点
| 权限 | 说明 | 默认 |
|---|---|---|
| `ink.nickname.command.use` | 使用改名卡命令 | true |
| `ink.nickname.command.reload` | 重载插件配置 | op |
| `ink.nickname.command.setlength` | 修改长度限制 | op |
| `ink.nickname.command.addsymbol` | 添加禁用字符 | op |
---
### 🧾 配置示例(config.yml)
```yml
config-version: 1
# 名称长度,支持 10 或 2-10
limit: "2-10"
# 改名卡匹配条件,lore 和 name 可单独使用,也可同时使用
item:
lore: ""
name: ""
# 禁用字符列表
blocked-symbols: []
database:
# 存储方式 Yml,Mysql,QLite
type: Yml
host: localhost
port: '3306'
database: yj_dominion
username: root
password: '123456'
connection-pool-size: 10
```
---
[/MD]