原创 娱乐 CyuTitles | 自定义称号系统 | 玩家工作室/动态计价 | 贴图/Shader资源包构建 | 商店/仓库 | 支持Folia [1.13-26.x] 1.1.2

CyuTitles | 自定义称号系统 | 商店/仓库/玩家工作室 | 动态贴图/Shader
一套可以真正拿来长期运营的服务器称号系统
CyuTitles 支持官方称号商店、玩家仓库、成就解锁、限时称号、身份称号链、动态动画、资源包贴图和 Shader 文字效果
除了服主制作的官方称号，也可以给玩家开放自定义称号
让玩家按档位选择样式、提交文字、进入网页工作室编辑，再由管理员审核后使用
称号可以显示在聊天、TAB 和玩家头顶
也可以把称号、玩家名、聊天正文拆开，分别设置不同样式
适合生存服、RPG服、会员服、活动服和需要长期运营内容的服务器

---

主要功能
● 官方称号商店与玩家仓库
● 免费、权限、金币、点券、物品等获取方式
● 在线、挖掘、击杀、合成等成就称号
● 默认称号与自动回退
● 限时称号与固定日期过期
● 身份替代链与成长进阶链
● 称号兑换券
● 玩家自定义称号
● 自定义称号档位和动态计价
● 玩家自定义称号仓库与权限扩容
● 自定义称号文字审核与贴图审核
● 玩家网页工作室
● 服主称号工坊
● 传统颜色、HEX、渐变和彩虹文字
● 逐帧动态文字称号
● PNG 贴图和图片帧动画
● Shader 文字效果
● 聊天、TAB、头顶独立显示
● 七个独立显示槽位与组合体系
● PlaceholderAPI 与 TAB 原生变量
● SQLite / MySQL 存储
● 配置体检与接入示例
● 支持 Folia

---

为什么写这个插件
很多称号插件只解决了一件事
给玩家名字前面放一段文字
但服务器真正用起来以后，往往还会需要很多东西
会员称号要跟着权限自动发放
活动称号要在规定时间过期
成就称号要根据玩家进度自动解锁
玩家想拥有不止一个称号，还需要仓库、预览和切换
再往后，还会出现动态称号、图片称号、自定义称号、TAB显示、头顶显示这些需求
如果每块都用一个不同插件去拼，配置和数据很容易乱
CyuTitles 就是把这些整理到同一套称号系统里
简单服可以只用普通文字称号
需要长期运营的服务器，也可以继续往商店、成就、自定义、贴图和 Shader 方向扩展

---

称号中心、商店与仓库
玩家输入：
/titles
即可打开称号中心
默认菜单分为称号商店和玩家仓库
称号商店
展示玩家还没有获得的称号，并显示获取条件和当前进度
称号仓库
展示玩家已经拥有的称号，可以查看详情、预览效果和正式佩戴
预览只会发给玩家自己查看
不会修改当前称号，也不会出现在聊天、TAB 或头顶
确认佩戴后才会正式生效

---

称号获取方式
每个官方称号都可以单独设置获取方式
支持：
● 免费领取
● 权限解锁
● Vault 金币
● PlayerPoints 点券
● 第三方货币
● 消耗指定物品
● 多条件组合
● 称号兑换券
● 管理员直接发放
第三方货币也可以接入
只要能通过 PlaceholderAPI 读取余额，并提供扣款和退款命令，就可以作为新的称号货币使用

---

成就称号
称号可以根据玩家行为自动解锁
支持的常用条件包括：
● 在线时长
● 挖掘方块
● 击杀生物
● 击杀玩家
● 合成物品
● 钓鱼数量
● 行走距离
● 死亡次数
● 原版统计数据
● PlaceholderAPI 数值
比如：
挖掘一万块石头，解锁“老矿工”
在线一百小时，解锁“常驻玩家”
击杀五百只僵尸，解锁“僵尸猎人”
菜单里可以直接显示当前进度
条件完成后，称号可以自动放进玩家仓库

---

默认称号与限时称号
服务器可以设置一个默认称号
玩家第一次进服时自动获得
当前没有称号，或者原称号已经过期失效时，会自动切回默认称号
权限称号也可以定时同步
玩家获得 VIP、月卡或身份组权限后，配套称号会自动进入仓库
权限发生变化时，也可以配合称号链自动回退
限时称号支持两种方式：
DURATION
从玩家获得称号开始计时，比如 1 天、7 天、30 天
END_AT
在指定日期统一过期，适合赛季称号和节日称号
还可以设置月度、赛季、节日或自定义周期标签
用于商店展示和变量调用

---

称号链
称号链用于处理同一系列称号之间的替代和进阶
支持两种模式
overlay 身份替代
适合：
玩家 → VIP → SVIP → 至尊会员
菜单只显示当前最高身份
权限降级后也可以自动回退到仍然有效的称号
progression 成长进阶
适合：
猎人 → 不死猎人 → 不死克星
低级称号仍然保留在仓库中
玩家正在使用这一组称号时，可以自动切换到已经满足的最高阶段
玩家手动佩戴活动称号或其它特殊称号时
称号链不会强行把它换掉

---

独立显示槽位与组合体系
新版不再只有一个通用称号位置
现在可以把显示拆成七个独立槽位：
● 聊天称号
● 聊天玩家名
● 聊天正文
● TAB 称号
● TAB 玩家名
● 头顶称号
● 头顶玩家名
玩家可以只替换其中一个位置
比如只改聊天名字颜色
只在 TAB 使用动态称号
或者只给玩家头顶加一个贴图徽章
没有单独选择的位置，会继续使用通用称号
清除其中一个位置，也不会影响其它位置
还可以把多个独立部件组成一套“显示体系”
玩家拥有全部部件后，可以一键装备整套搭配

---

玩家自定义称号
服主可以开放玩家自定义称号
每个档位可以分别设置：
● 档位名称和说明
● 基础价格和货币
● 固定价格或动态价格
● 最大文字长度
● 称号描述行数
● 传统颜色权限
● HEX 和渐变权限
● 动画权限
● Shader 权限
● 图标和图片动画权限
● 有效期
● 提交冷却
● 是否需要审核
玩家自定义称号和官方称号分开保存
不会把玩家内容写进官方的 titles.yml
服主可以设置默认仓库容量，也可以通过权限增加栏位
玩家失去扩容权限时，超出的称号只会变成锁定状态
不会删除已经创建的内容

---

动态计价
自定义称号可以使用固定价格
也可以按玩家真正使用的内容计算价格
例如：
基础称号一个价格
增加可见字数继续加价
使用 HEX、渐变、动态动画、Shader、图标或图片帧后再分别加价
最终价格会限制在服主设置的最低价和最高价之间
所有报价和扣费都由服务器重新计算
网页显示的价格不能直接决定最终扣款
这样可以把简单称号和复杂称号分成不同成本
不需要给每种组合单独做一个档位

---

玩家工作室
玩家可以在游戏内输入：
/titles custom studio
获取一次性工作室链接
进入网页后可以编辑：
● 称号文字
● 多段称号描述
● 传统色、HEX 和渐变
● 文字动画
● Shader 效果
● 聊天、TAB、头顶的独立样式
● 已登记的贴图和图片动画
● 玩家自己审核通过的贴图
玩家也可以上传 PNG 或 GIF
上传后的素材先进入审核队列
管理员通过后，才会写进资源包源和视觉配置
工作室会话有过期、限流和大小限制
公网开放时可以强制玩家回到游戏内输入确认码

---

称号工坊
服主可以使用：
/cyutitles editor
启动本地称号工坊
工坊会读取当前 titles.yml 和 visuals.yml
可以直接选择已有称号继续修改
支持：
● 普通文字称号
● 渐变称号
● 动态逐帧称号
● 贴图称号
● 图片帧动画
● GIF 拆帧
● Shader 参数
● 称号链
● TAB 和聊天接入配置
工坊可以保存本地草稿和最近版本
也可以查看差异、恢复旧版本、导入导出草稿
修改完成后，页面会生成一次性写回指令
管理员回到游戏执行：
/cyutitles editor apply
插件会先校验配置，再备份原文件
校验失败时不会覆盖原配置

---

动态文字称号
动态称号使用逐帧列表播放
可以制作：
● 渐变流动
● 彩虹文字
● 颜色轮换
● 闪烁称号
● 权限组动态文字
● 活动和节日动画
Birdflop AnimTAB 和 TAB 的动画配置也是类似的逐帧结构
已有动画可以直接迁移到 CyuTitles
不需要再把相同动画复制进 TAB

---

贴图与图片动画
贴图称号通过资源包字体实现
支持：
● 单张 PNG 图标
● 纯贴图称号
● 贴图叠加文字
● 多张 PNG 图片帧
● GIF 拆帧动画
● 无资源包时的 fallback 文字
插件带有资源包准备、构建和状态检查命令
执行 build 后会生成发布包，并写回 SHA1
可以由 CyuTitles 自己发包
也可以交给 ItemsAdder、Oraxen、CraftEngine 或服务器原有资源包系统
多版本服务器还可以给不同协议版本配置不同资源包

---

Shader 文字效果
CyuTitles 支持 Shader 文字效果
它不是一种新的称号类型
而是叠加在普通文字、动态文字或其它称号上的视觉效果
可以分别作用于：
● 称号文字
● 玩家名称
● 聊天正文
聊天、TAB 和头顶可以使用不同效果
比如：
聊天称号使用霓虹
玩家名字使用彩虹
聊天正文使用冰流
TAB 保持普通文字
头顶使用星光效果
内置效果按律动、流彩、光效、纹理、立体、液态和组合分类
目前提供 100 个预设 ID
预设参数可以在工坊里调整颜色、速度、强度、透明度和振幅
Shader 需要客户端加载对应资源包
协议不匹配或资源包未加载时，会显示普通回退颜色

---

聊天、TAB 与头顶接入
CyuTitles 可以自己接管聊天、玩家列表和头顶显示
也可以自动避让 TAB、TrChat 等插件
只提供对应变量交给它们显示
常用变量包括：
%cyutitles_prefix%　聊天称号前缀
%cyutitles_suffix%　聊天称号后缀
%cyutitles_name%　聊天玩家名
%cyutitles_prefix_tab%　TAB 称号前缀
%cyutitles_name_tab%　TAB 玩家名
%cyutitles_prefix_scoreboard%　玩家头顶前缀
%cyutitles_suffix_scoreboard%　玩家头顶后缀
TAB 可以直接读取 CyuTitles 注册的原生变量
只使用 TAB 时，不强制安装 PlaceholderAPI
外部聊天、菜单或计分板插件需要读取 PAPI 变量时，再安装 PlaceholderAPI
插件也会生成 TAB、通用聊天和 TrChat 的接入示例

---

数据存储与跨服
CyuTitles 支持 SQLite 和 MySQL
SQLite
适合普通单服使用
MySQL
适合群组服、跨服称号数据或需要集中存储的服务器
存储方式写在单独的 storage.yml
修改 SQLite / MySQL 设置后需要重启服务器

---

配置体检
修改称号、菜单、资源包或工作室后，可以执行：
/cyutitles doctor
体检内容包括：
● 插件依赖
● 菜单文件
● 官方称号
● 自定义称号模块
● 显示接管状态
● 资源包配置
● 图标与字符冲突
● Shader 协议设置
● 工作室状态
● 配置格式校验
建议正式开放前先跑一次
更新配置后再跑一次

---

常用玩家命令
/titles　打开称号中心
/titles shop　打开称号商店
/titles warehouse　打开称号仓库
/titles search <关键词>　搜索称号
/titles unlock <称号ID>　尝试解锁称号
/titles apply <称号ID>　佩戴称号
/titles clear　卸下称号
/titles preview <称号ID>　预览称号
/titles custom　打开自定义称号菜单
/titles custom studio　打开玩家工作室

---

常用管理命令
/cyutitles reload　重载配置、菜单和称号
/cyutitles doctor　检查插件状态
/cyutitles create　创建称号草稿
/cyutitles edit　编辑称号字段
/cyutitles publish　发布并上架称号
/cyutitles give　发放称号
/cyutitles take　回收称号
/cyutitles voucher　发放称号兑换券
/cyutitles chain　管理称号链
/cyutitles workbench　打开游戏内工作台
/cyutitles editor　打开称号工坊
/cyutitles custom review　打开自定义称号审核
/cyutitles custom media menu　打开玩家贴图审核
/cyutitles resourcepack　管理资源包视觉
完整命令、变量和权限请查看使用文档

---

插件信息
作者：HansOffice
插件名：CyuTitles
支持核心：Bukkit / Paper / Folia
数据存储：SQLite / MySQL
可选依赖：PlaceholderAPI / TAB / Vault / PlayerPoints
资源包接入：服务器发包 / ItemsAdder / Oraxen / CraftEngine
交流群：331910315

---

获取方式
外链下载即可获取
使用中遇到问题、需要查看更新内容或反馈建议，可以加入交流群
交流群：331910315