
tools · 作者:Vicuna
YuChat 聊天称呼与昵称插件
面向 1.8.x-1.26.x 与常见混合端的聊天显示插件,整合称呼、昵称、LuckPerms 前后缀、PAPI 变量、经济购买、悬浮消息和 TAB/头顶名同步。
聊天称呼昵称前后缀PlaceholderAPILuckPermsVaultPlayerPointsSQLiteMySQL跨版本混合端MohistArclightYouer工具
文档入口
YuChat 是面向 Minecraft 1.8.x-1.26.x 的跨版本聊天称呼与昵称插件,环境适配范围与 YuRandomTeleport 保持一致:Spigot、Paper、Paper 衍生端,以及 Mohist、Arclight、Youer 等 Bukkit API 混合端。它把玩家称呼、昵称、个性签名、自定义死亡消息、LuckPerms 前后缀、PlaceholderAPI 变量、经济购买、GUI 管理和 TAB/头顶名同步整合到一个聊天显示插件里,适合生存服、RPG 服、会员体系服务器和需要细致身份展示的社区服。
安装部署免费版获取、高级版赞助、放置 jar、首次启动、运行库下载和上线检查命令手册/yuchat、/yc、/chat 的 GUI、昵称、签名、死亡消息、管理和重载命令配置说明数据库、聊天格式、悬浮消息、经济、昵称、显示同步、声音和公告权限节点基础使用、颜色解析、格式权限、称呼权限、管理员与重载权限PlaceholderAPI%yuchat_*% 变量、TAB/菜单/计分板接入和 LuckPerms meta 读取插件联动LuckPerms、Vault、PlayerPoints、PlaceholderAPI、TAB、EasyBot 和文件结构常见问题聊天不显示、PAPI 没值、经济扣费、TAB 覆盖、依赖下载和混合端排查
版本获取
YuChat 提供免费版和高级版。免费版 1.0.6 可在 Yu 插件交流群 获取;需要高级版、持续更新或更完整功能时,请在 爱发电赞助获取。
核心能力
| 能力 | 说明 |
|---|---|
| 广版本与混合端适配 | 面向 1.8.x-1.26.x,覆盖 Spigot、Paper、Paper 衍生端,并兼顾 Mohist、Arclight、Youer 等混合端运行环境。 |
| 称呼系统 | 支持内置称呼和 custom_titles.yml 自定义称呼,玩家可同时激活多个称呼并按激活顺序显示。 |
| 昵称与格式 | 支持昵称唯一校验、黑名单、正则、长度、冷却、昵称颜色、昵称格式和普通玩家颜色权限限制。 |
| LuckPerms 显示 | 可通过 LuckPerms API 读取 prefix、suffix、meta,也可在接口不可用时按配置用 PlaceholderAPI 兜底。 |
| 聊天与悬浮 | 支持聊天格式、聊天内容颜色、MiniMessage/Hex 降级、前缀/后缀/昵称/称呼悬浮文本。 |
| 显示同步 | 可同步 Bukkit displayName、TAB 列表、scoreboard-team 头顶名,必要时可切换 hologram 头顶名模式。 |
| 个性签名和死亡消息 | 玩家可设置个性签名和自定义死亡消息,死亡原因、击杀者和悬浮内容均可配置。 |
| 经济购买 | 支持 Vault 金币、PlayerPoints 点券、两者都扣或二选一,用于昵称、签名、死亡消息、颜色和称呼。 |
| SQLite/MySQL 存储 | 单服默认 SQLite;跨服或多子服共享可切换 MySQL,并统一使用表名前缀。 |
| GUI 管理 | 玩家可用 GUI 切换称呼、颜色和显示开关;管理员可在 GUI 中创建称呼、调整经济和 LuckPerms 显示。 |
| 运行时依赖加载 | 首次启动会缓存 HikariCP、SQLite JDBC、MySQL JDBC、SLF4J 等依赖到插件目录并校验哈希。 |
| 统计接入 | 内置 bStats Bukkit 统计,插件 ID 为 31412。 |
快速开始
- 在 Yu 插件交流群获取免费版
1.0.6,或通过爱发电赞助获取高级版。 - 将 jar 放入服务端
plugins/目录并启动一次服务器。 - 打开
plugins/YuChat/config.yml,确认storage.type、chat-format.format、prefix-suffix和display配置。 - 给普通玩家分配
yuchat.use、yuchat.gui、yuchat.nickname.use,按需要分配称呼、颜色和格式权限。 - 玩家使用
/yc、/chat或/yuchat打开主界面,使用/yc nick <昵称>快速修改昵称。 - 修改配置后执行
/yc reload重载配置、消息和 GUI。
适合的服务器
| 场景 | 推荐用法 |
|---|---|
| 生存服 | 作为统一聊天格式与昵称插件,配合 LuckPerms 展示权限组前后缀。 |
| RPG 服 | 使用称呼、称呼颜色和个性签名表达职业、阵营、声望或活动身份。 |
| 会员服 | 将称呼、昵称颜色、聊天颜色和死亡消息接入 Vault 或 PlayerPoints。 |
| 多子服网络 | 使用 MySQL 存储,让大厅、生存、资源服共享玩家聊天显示数据。 |
| 社区服 | 通过 GUI 降低玩家自助配置门槛,同时保留管理员后台配置能力。 |
当前版本定位
- 版本获取:免费版
1.0.6可在 Yu 插件交流群获取;高级版通过爱发电赞助获取 - 主类:
org.yutay.yuchat.YuChat - 主命令:
/yuchat - 别名:
/yc、/chat - Java 目标版本:Java 8
- 编译 API:Spigot API
1.8.8-R0.1-SNAPSHOT - 兼容定位:Minecraft
1.8.x-1.26.x,Spigot、Paper、Paper 衍生端、Mohist、Arclight、Youer 等混合端 - 存储方式:SQLite、MySQL
- bStats 插件 ID:
31412 - 默认配置版本:
config-version: 30 - 默认消息版本:
messages-version: 10 - 默认 GUI 版本:
gui-version: 9 - 默认称呼版本:
titles-version: 4 - 默认效果版本:
effects-version: 3