离渊系列插件Wiki

配置说明 ​

配置文件：plugins/LyMySQLCore/config.yml

修改数据库连接信息后需要重启服务器。该插件没有独立重载指令，数据库连接在插件启动时初始化。

默认配置 ​

yaml
#数据库 填写后才可以支持后续插件操作
#本插件90%源代码来自萌芽99 感谢99的帮助
mysql:
  databasename: mc2
  username: mc2
  password: mc1234
  port: 3306
  ip: 127.0.0.1
  link: "useSSL=false&serverTimezone=UTC&characterEncoding=UTF-8"

#开发者只需要监听   MySQLSafePlayerLoadEvent / MySQLSafePlayerSaveEvent 即可进行安全数据读写
# [!] 警告: 在玩家未成功读取前禁止使用任何与你插件相关的操作 防止在数据加载前可以操作你的插件
# [!] 警告: 你需要在onDisable内进行全服玩家的数据储存 部分情况下会导致关服不保存玩家数据

#数据加载延迟 单位tick
join-load-delay: 20

数据库连接 ​

配置项说明
mysql.ip数据库地址
mysql.port数据库端口
mysql.databasename数据库名称
mysql.username数据库账号
mysql.password数据库密码
mysql.linkJDBC 连接参数

本机数据库示例：

yaml
mysql:
  databasename: minecraft
  username: root
  password: "123456"
  port: 3306
  ip: 127.0.0.1
  link: "useSSL=false&serverTimezone=UTC&characterEncoding=UTF-8"

远程数据库示例：

yaml
mysql:
  databasename: server_data
  username: mc_user
  password: "your_password"
  port: 3306
  ip: 192.168.1.100
  link: "useSSL=false&serverTimezone=Asia/Shanghai&characterEncoding=UTF-8"

警告

数据库账号必须有建表、查询、插入、更新权限。权限不足时，LyMySQLCore 可能启动失败，或其它插件无法保存玩家数据。

玩家加载延迟 ​

join-load-delay 控制玩家数据读取事件触发后的放行延迟，单位是 tick。

yaml
join-load-delay: 20

20 tick 约等于 1 秒。服务器插件较多、玩家进服时数据较复杂时，可以适当调高。

连接失败排查 ​

先看控制台中的 MySQLLink -> jdbc:mysql://...，确认地址、端口、库名是否正确。

常见原因：

现象处理
连接超时检查数据库地址、防火墙、端口开放
Access denied检查账号、密码、数据库授权
Unknown database先创建对应数据库
时区报错在 mysql.link 中设置 serverTimezone=UTC 或 serverTimezone=Asia/Shanghai