YuChat 安装部署

环境要求

项目	要求
Java	Java 8 及以上。源码以 `sourceCompatibility/targetCompatibility = 1.8` 构建。
服务端	Spigot、Paper、Paper 衍生端，以及 Mohist、Arclight、Youer 等兼容 Bukkit API 的混合端。
Minecraft	目标适配 `1.8.x-1.26.x`。源码使用 Spigot API `1.8.8-R0.1-SNAPSHOT` 编译，建议在正式服同版本测试后上线。
数据库	默认 SQLite；跨服共享或多端同步建议使用 MySQL。
可选依赖	PlaceholderAPI、LuckPerms、Vault、PlayerPoints。
网络访问	首次启动会从 Maven Central 下载运行时依赖；bStats 统计也会尝试访问统计服务。

兼容范围

YuChat 的环境适配范围与 YuRandomTeleport 保持一致。

兼容范围	说明
Minecraft 版本	目标适配 `1.8.x-1.26.x`。
Bukkit 系服务端	Spigot、Paper、Paper 衍生端。
混合端	Mohist、Arclight、Youer 等 Bukkit API 混合端。
Java 运行时	Java 8 及以上。Java 9+ 如果遇到类加载器反射限制，可按控制台提示添加 `--add-opens java.base/java.net=ALL-UNNAMED`。
存储后端	SQLite 单服文件库；MySQL 跨服共享。

版本获取

YuChat 提供免费版和高级版：

版本	获取方式
免费版 `1.0.6`	在 Yu 插件交流群获取。
高级版	需要高级功能、持续更新或完整支持时，请在爱发电赞助获取。

部署到服务端

停止服务端。
将获取到的 YuChat jar 放入服务端 plugins/ 目录。
按需安装 PlaceholderAPI、LuckPerms、Vault、PlayerPoints。
启动服务端，等待插件生成 plugins/YuChat/ 下的配置文件。
首次启动时确认运行时依赖下载完成，控制台应出现 YuChat 已启用。。
进入游戏执行 /yc help、/chat help 或 /yuchat help 检查命令是否注册成功。

运行时依赖

YuChat 在启动阶段会把这些依赖下载到 plugins/YuChat/libs/，发布版还会把隔离 core 解压到 plugins/YuChat/runtime/。

依赖	版本	用途
HikariCP	`4.0.3`	MySQL/SQLite 连接池。
sqlite-jdbc	`3.51.3.0`	SQLite 文件数据库驱动。
mysql-connector-j	`9.6.0`	MySQL 数据库驱动。
slf4j-api / slf4j-nop	`2.0.17`	HikariCP 日志依赖。

默认会校验远程仓库提供的 SHA-256 或 SHA-1。若服务器无法访问 Maven Central，可手动下载对应 jar 放入 plugins/YuChat/libs/ 后重启。

首次配置检查

配置	默认值	建议
`storage.type`	`sqlite`	单服保持默认；多子服共享改为 `mysql`。
`storage.table-prefix`	`yuchat_`	多插件共库时保持独立前缀。
`chat-format.component-broadcast.enabled`	`false`	需要聊天内悬浮时再开启，默认更兼容聊天记录和群组互联。
`chat-format.format`	`{prefix} {title} {nickname} &8>>> &f{message} {suffix}`	按服务器聊天样式调整。
`placeholder.expansion.enabled`	`true`	需要 TAB、菜单、计分板读取 `%yuchat_*%` 时保持开启。
`prefix-suffix.enabled`	`true`	安装 LuckPerms 后检查 prefix/suffix/meta 组合。
`display.tab.enabled`	配置文件内控制	若 TAB 插件接管列表名，建议改在 TAB 插件中使用 YuChat PAPI 变量。
`library.verify-checksum`	`true`	推荐保持开启，避免损坏或被替换的依赖 jar 被加载。

MySQL 跨服共享

将 storage.type 改为 mysql，并填写数据库连接参数：

yaml

storage:
  type: mysql
  table-prefix: yuchat_
  mysql:
    host: localhost
    port: 3306
    database: yuchat
    username: root
    password: ""
    jdbc-params: "useSSL=false&allowPublicKeyRetrieval=true&autoReconnect=true&useUnicode=true&characterEncoding=utf8"

上线前建议：

给 YuChat 单独创建数据库账号。
确认所有子服使用同一套插件版本与配置版本。
在测试服修改昵称、称呼、颜色、签名和死亡消息，确认数据会同步。
对玩家数据表、授权表和购买日志表做定期备份。

升级已有版本

YuChat 会读取各配置文件的版本号，版本落后时自动合并缺失节点并保留已有值。

文件	当前版本	说明
`config.yml`	`30`	主配置、数据库、聊天格式、显示同步、经济和声音。
`messages.yml`	`10`	命令、GUI、购买、输入和状态提示。
`gui.yml`	`9`	玩家 GUI 与管理员 GUI。
`titles.yml`	`4`	内置称呼。
`custom_titles.yml`	`1`	管理员 GUI 新建称呼。
`effects.yml`	`3`	颜色、渐变、彩虹和动态效果。

升级建议：

停服备份 plugins/YuChat/，MySQL 模式下同时备份数据库。
替换 jar。
启动一次服务端，让插件自动合并新配置。
检查控制台是否有依赖加载、数据库连接或配置格式错误。
执行 /yc、/yc nick 测试昵称、/yc admin、/yc reload 和一次聊天显示测试。

卸载

停止服务端。
删除 plugins/ 中的 YuChat jar。
如不再需要数据，删除 plugins/YuChat/ 目录。
MySQL 模式下按需删除 yuchat_ 前缀相关数据表。

YuChat 安装部署 ​

环境要求 ​

兼容范围 ​

版本获取 ​

部署到服务端 ​

运行时依赖 ​

首次配置检查 ​

MySQL 跨服共享 ​

升级已有版本 ​

卸载 ​