- 版权类型
- 原创
- 插件中文名称
- 牢李称号
- 插件英文名称
- LiTitle
- 原帖地址
- #
- 支持的核心(服务端)
- Spigot
- Paper
- Folia
- Purpur
- PufferFish
- SpongeVanilla
- Leaves
- 语言支持
- 中文(简体)
- 前置组件
- PlaceholderAPI(可选):https://www.minebbs.com/resources/8229
Vault(可选,作为金币经济前置):https://www.minebbs.com/resources/7869
PlayerPoints(可选,作为点券经济前置):https://www.minebbs.com/resources/9144
- 适配版本(Java)
- 1.21
- 1.20
- 1.19
作者QQ 2562661003
LiTitle 称号插件使用指南
腾讯文档-智能文档
docs.qq.com
插件简介
LiTitle 是一款面向生存服、群组服、RPG 服和综合服务器的称号与聊天插件。
插件不仅可以提供传统的称号商店、称号仓库、称号佩戴、自动发放称号,还内置了聊天频道系统。服务器可以直接做出类似:
代码:
全服 > 生存服 > [雷霆行者] Player: 大家好
本服 > [星光旅人] Player: 只在当前子服可见
管理 > 生存服 > Admin: 管理频道消息
称号支持普通颜色、HEX 颜色、渐变效果、动态帧展示;聊天支持本服频道、全服频道、管理频道、私聊、私聊监听、禁言、全员禁言、屏蔽玩家、@提醒、展示物品等常用功能。
核心特色
- 称号显示在玩家名字前方,适合聊天身份展示
- 支持称号商店,玩家可使用 Vault 金币、PlayerPoints 点券、权限或物品购买
- 默认附带 10 个商城购买称号,可直接开服使用
- 支持渐变称号和渐变聊天颜色
- 支持玩家聊天颜色菜单,普通颜色、彩虹、双色渐变均可选择
- 支持 SQLite / MySQL 存储,适合单服和多子服共用数据
- 预留 Redis 配置,便于后续扩展跨服通信
- 支持 Velocity 环境下的跨服聊天转发
- 支持 Folia,
plugin.yml 已声明 folia-supported: true
- 支持 PlaceholderAPI 变量扩展
- 支持 Vault 经济与 PlayerPoints 点券
- 支持从旧 PlayeerTitle 数据迁移
- 所有 GUI 可配置,商店、仓库、聊天颜色、统计称号、进阶称号均有独立配置
功能列表
称号系统
- 称号商店
- 称号仓库
- 称号佩戴 / 卸下
- 管理员发放称号
- 管理员回收称号
- 离线玩家发放称号
- 默认称号
- 权限自动发放称号
- 成就自动发放称号
- 统计类称号
- 进阶称号
- 自定义称号
- 动态称号
- 渐变称号
- 称号有效期
- 称号购买后自动放入仓库
- 可配置是否自动佩戴新获得称号
聊天系统
- 本服频道
- 全服频道
- 管理频道
- 跨服聊天
- 私聊
- 回复上一个私聊对象
- 私聊监听
- 玩家屏蔽
- 禁言玩家
- 全员禁言
- 聊天冷却
- 重复消息检测
- 聊天长度限制
- 敏感词拦截
- @玩家提醒
- @所有人提醒
- 展示手持物品
- 后台控制台同步显示玩家聊天
聊天颜色
- 权限控制聊天颜色菜单
- 普通颜色
- HEX 颜色
- 彩虹聊天
- 双端渐变聊天
- 渐变聊天不会显示
xFF0000 这类颜色符号
- 称号和聊天内容均支持颜色解析
跨服能力
- 支持 Velocity 环境
- 通过
bungeecord:main 插件消息通道转发全服频道
- 玩家在一个子服说话,其他子服玩家也能看到全服频道消息
- 管理频道可跨服沟通
- MySQL 可同步玩家称号、已拥有称号、当前佩戴称号、聊天颜色等数据
默认商城称号
插件会自动补齐以下 10 个默认商城称号,不覆盖已有同名配置:
| ID | 名称 | 默认价格 |
|---|
shop_starlight | 星光旅人 | 1000 金币 |
shop_sakura | 樱花恋歌 | 1200 金币 |
shop_thunder | 雷霆行者 | 1500 金币 |
shop_ocean | 沧海听风 | 1600 金币 |
shop_flame | 烈焰之心 | 1800 金币 |
shop_forest | 森林守望 | 1300 金币 |
shop_moon | 月影游侠 | 2000 金币 |
shop_gold | 黄金贵宾 | 2200 金币 |
shop_aurora | 极光旅者 | 2600 金币 |
shop_dragon | 龙吟传说 | 3000 金币 |
这些称号默认带有渐变展示效果,可作为服务器商城的基础商品。
安装方式
- 将插件 Jar 放入服务器
plugins 文件夹。
- 安装前置插件 Vault。
- 可选安装 PlaceholderAPI、PlayerPoints。
- 启动服务器生成配置文件。
- 根据需要修改
plugins/LiTitle/config.yml、chat.yml、titles/、shop_titles/。
- 使用
/lititle reload 重载配置,或重启服务器。
前置与软依赖
必需:
可选:
- PlaceholderAPI
- PlayerPoints
说明:
- 使用 Vault 金币购买称号时需要 Vault 和经济插件。
- 使用 PlayerPoints 点券购买称号时需要 PlayerPoints。
- 使用 PlaceholderAPI 时可以在称号、GUI、聊天中显示更多玩家变量。
常用指令
主指令:
玩家常用:
| 指令 | 用途 |
|---|
/lititle shop | 打开称号商店 |
/lititle open | 打开称号仓库 |
/lititle clear | 卸下当前称号 |
/lititle chatcolor | 打开聊天颜色菜单 |
| `/lititle channel <global | local |
/lititle msg <玩家> <内容> | 私聊玩家 |
/lititle reply <内容> | 回复上一个私聊对象 |
/lititle ignore <玩家> | 屏蔽或取消屏蔽玩家聊天 |
/lititle rename <新称号> | 设置自定义称号 |
/lititle rename clear | 清除自定义称号 |
管理员常用:
| 指令 | 用途 |
|---|
| `/lititle reload [all | lang |
/lititle give <玩家> <称号ID> | 给玩家发放称号 |
/lititle take <玩家> <称号ID> | 回收玩家称号 |
/lititle shop add <称号ID> [价格] [天数] | 上架商城称号 |
/lititle shop remove <称号ID> | 下架商城称号 |
/lititle ach complete <玩家> <成就ID> | 标记玩家完成称号成就 |
/lititle spy | 开启或关闭私聊监听 |
/lititle mutechat <玩家> <秒数> | 禁言玩家 |
/lititle muteall on/off | 开启或关闭全员禁言 |
数据迁移:
代码:
/lititle migrate playeetitle sqlite <db文件路径>
/lititle migrate playeetitle mysql <host> <port> <db> <user> <password> [params]
权限节点
| 权限 | 用途 | 默认 |
|---|
lititle.admin | 管理员权限 | OP |
lititle.use | 使用基础菜单 | OP |
lititle.chat.color | 使用聊天颜色菜单 | OP |
lititle.chat.local | 本服频道发言 / 收听 | 所有人 |
lititle.chat.global | 全服频道发言 / 收听 | 所有人 |
lititle.chat.admin | 管理频道 | OP |
lititle.chat.spy | 私聊监听 | OP |
lititle.chat.mute | 禁言玩家 | OP |
lititle.chat.muteall | 全员禁言 | OP |
lititle.chat.mute.bypass | 绕过个人禁言 | OP |
lititle.chat.muteall.bypass | 绕过全员禁言 | OP |
lititle.chat.cooldown.bypass | 绕过聊天冷却 | OP |
lititle.chat.repeat.bypass | 绕过重复消息检测 | OP |
lititle.chat.length.bypass | 绕过聊天长度限制 | OP |
lititle.chat.atall | 允许 @所有人 | OP |
lititle.rename.self | 允许设置自定义称号 | OP |
配置文件说明
插件启动后会在
plugins/LiTitle/ 下生成配置:
| 文件 / 目录 | 用途 |
|---|
config.yml | 核心配置、默认称号、存储、MySQL、Redis |
chat.yml | 聊天频道、聊天格式、跨服频道、冷却、敏感词 |
lang.yml | 插件提示消息 |
auto_grant.yml | 自动发放称号规则 |
titles.yml | 合并式称号配置 |
titles/ | 独立称号配置目录 |
shop_titles/ | 商城称号配置目录 |
gui/ | 菜单 GUI 配置目录 |
聊天格式示例
chat.yml 中可以配置频道格式:
代码:
channels:
global:
enabled: true
speak-permission: "lititle.chat.global"
listen-permission: "lititle.chat.global"
range: -1
format: "&b全服 &8> &e%server% &8> &7%title%&f%player%&8: &f%message%"
可用变量:
| 变量 | 说明 |
|---|
%server% | 当前子服显示名 |
%channel% | 当前频道 |
%player% | 玩家名 |
%displayname% | 玩家显示名 |
%world% | 玩家所在世界 |
%title% | 当前佩戴称号 |
%message% | 聊天内容 |
称号配置示例
在
plugins/LiTitle/titles/vip.yml 中创建一个称号:
代码:
id: "vip"
name: "VIP会员"
display: "&f[ &#FFD966V&#FFB347I&#FF8A3DP &f]"
dynamic:
enable: false
interval-ticks: 10
frames: []
lore:
- "&7VIP专属称号"
icon:
material: "NAME_TAG"
custom-model-data: 0
permission: "vip.title"
achievements: []
statistics: []
advance-from: []
cost:
vault: 1000
points: 0
actions:
on-buy: []
on-select: []
buffs: []
存储配置
单服推荐 SQLite,开箱即用
群组服推荐 MySQL,让多个子服共享称号数据
Redis 配置已预留在
config.yml 中,适合后续扩展跨服聊天通道。
适合服务器类型
- 生存服
- 群组服
- RPG 服
- 空岛服
- 养老服
- 需要称号商城和聊天身份展示的服务器
注意事项
- 已生成过的配置文件不会被新 Jar 自动覆盖。
- 如果更新后想使用新的默认聊天格式,需要手动修改
plugins/LiTitle/chat.yml,或删除旧文件后重启生成。
- 跨服聊天当前走 Velocity 可用的
bungeecord:main 插件消息通道。
- 使用 MySQL 才能让多个子服共享玩家称号数据。
- Vault 是必需依赖,请确保服务器已安装 Vault 和经济插件。
-
1773569900235.webp
1.2 KB
· 查看: 118
-
1773569946704.webp
612 字节
· 查看: 197
-
1773569991861.webp
910 字节
· 查看: 111
-
1773570042188.webp
1.8 KB
· 查看: 114
-
QQ_1773570168636.webp
76 KB
· 查看: 123
-
QQ_1773570186138.webp
10.9 KB
· 查看: 119
-
QQ_1773570192423.webp
7.4 KB
· 查看: 118
-
QQ_1773570214708.webp
18.2 KB
· 查看: 119
-
已生成图像 1.webp
230.2 KB
· 查看: 101