自定义称号
玩家点主菜单(或仓库、商店)的「定制称号」,或输入 /clt custom:
- 在聊天栏输入称号文字(这条消息不会发到公屏,也不会被聊天插件转发)
- 文字不合规时会提示原因,可以直接重新输入;输入
cancel或取消退出 - 打开确认界面,预览称号与价格
- 确认后扣费,获得专属称号并自动佩戴
自定义称号是文字称号,只属于创建它的玩家:出现在他自己的仓库里,别人看不到「未拥有」的条目。 玩家在仓库里 Shift + 右键 自己的自定义称号可以删除(会先打开确认界面,删除不退款)。
配置
config.yml
custom-title:
enabled: true
price:
money: 50000
points: 0
items: []
duration: permanent
min-length: 1
max-length: 8
format: '&f[{text}&f]' # 外框,{text} = 玩家输入的文字
allow-colors: permission # true / false / permission
allow-minimessage: permission
forbidden-formats: [k] # 禁止乱码字
max-per-player: 3
input-timeout-seconds: 60
cancel-word: cancel
equip-after-create: true
pattern: '' # 例如只允许中英文与数字:'[一-龥A-Za-z0-9]+'
blacklist: ['服主', '管理', 'admin', 'owner']
category: custom
icon:
material: NAME_TAG
lore:
- '&7玩家 &f{player} &7的专属称号'
- '&8创建于 {date}'
| 字段 | 说明 |
|---|---|
price | 金币、点券、物品可任意组合,写了的都要付 |
min-length / max-length | 文字长度,不含颜色代码 |
format | 统一的外框,让玩家称号风格一致 |
allow-colors | &a、&#RRGGBB 颜色:true 所有人、false 不允许、permission 需要 cloudtitle.custom.color |
allow-minimessage | <gradient> 等标签,permission 时需要 cloudtitle.custom.gradient |
forbidden-formats | 禁止的格式代码,默认禁止 k(乱码字) |
max-per-player | 每人最多几个自定义称号,0 = 不限;cloudtitle.custom.unlimited 不受限制 |
pattern | 去掉颜色后的文字必须完全符合这个正则 |
blacklist | 含有这些字的称号会被拒绝(不分大小写,原文和去色后的文字都会检查) |
安全
- 不允许颜色时,玩家输入的颜色代码会被去掉;
§一律不保留,避免绕过检查。 - 即使开放 MiniMessage,也只保留颜色与格式类标签(渐变、彩虹、粗体…),
<click>、<hover>、<insert>等会被移除。 - 先检查黑名单,再检查长度和正则。
管理
| 指令 | 说明 |
|---|---|
/clt customs list [玩家] | 列出全部(或某位玩家的)自定义称号与 ID |
/clt customs remove <称号ID> | 删除一个自定义称号(佩戴中会自动卸下) |
自定义称号保存在数据库的 clt_custom 表。多个分流共用 MySQL 时,在一台服务器上创建或删除,其他服务器会自动同步。