我的世界1.12.2艾尔丽雅[数据同步]PlayerSync

PlayerSync 插件配置详解

一、数据库配置

MySQL_IP: 127.0.0.1        # MySQL服务器IP（本地）
MySQL_port: 3306           # 数据库端口（默认）
MySQL_database: database   # 数据库名称
MySQL_table: table         # 数据存储表名
MySQL_user: user           # 数据库用户名
MySQL_password: password   # 数据库密码

CREATE TABLE IF NOT EXISTS `table` (
    `player_uuid` CHAR(36) PRIMARY KEY,
    `inventory` TEXT NOT NULL,
    `health` FLOAT NOT NULL,
    `food` INT NOT NULL,
    `potion_effects` TEXT NOT NULL,
    `experience` INT NOT NULL,
    `vitality` INT NOT NULL,
    `game_mode` TINYINT NOT NULL
);

二、数据同步项配置

Inventory: true    # 同步背包物品
Health: true       # 同步生命值
Food: true         # 同步饥饿值
Potion: true       # 同步药水效果
Exp: true          # 同步经验值
Vitality: true     # 同步自定义活力值（若有）

• 关闭非必要同步项可减少数据库压力（如无需同步药水效果时设为false）
• Vitality需配合其他插件使用，若未启用可设为false

三、同步机制配置

SyncDelay: 20       # 延迟加载背包的tick（1秒=20 tick）

• 若服务器卡顿可增大此值（如40即延迟 2 秒），避免同步与玩家操作冲突
• 高频率同步可能导致数据库负载过高，建议保持默认值

四、游戏模式强制设置

gameMode: 0         # 强制游戏模式（0=生存，1=创造，2=冒险）

• 仅允许设置为0或2（创造模式可能导致数据不同步）
• 玩家加入时会强制切换至指定模式，需配合权限系统使用

五、使用建议

1. 数据安全：
   • 定期备份数据库，避免因同步异常导致数据丢失
   • 启用 SSL 连接（若数据库支持）：
     yaml

     # 添加到数据库配置中
     useSSL: true
     
2. 性能优化：
   yaml

   # 减少同步频率（如每分钟同步一次）
   SyncDelay: 1200  # 60秒
   
3. 冲突处理：
   • 若与其他数据存储插件（如 PlayerData）冲突，建议统一使用单一数据源
   • 确保插件版本与服务器核心兼容，避免因 NMS 差异导致同步失败

六、常见问题排查

1. 数据不同步：
   • 检查对应同步项是否开启（如Inventory: true）
   • 查看服务器日志，确认插件是否正确连接数据库
2. 游戏模式强制失效：
   • 确认gameMode值为0或2
   • 检查是否有其他插件（如 Essentials）覆盖游戏模式设置
3. 数据库连接失败：
   • 确保 MySQL 服务运行且 IP / 端口正确
   • 测试数据库连接：
     bash

     mysql -h 127.0.0.1 -u user -p -D database