Player Sync

插件

· 作者 Harukoto

一个 Bukkit/Spigot/Paper 插件,用于在多个 Minecraft 服务器之间同步玩家物品栏和末影箱数据。

0 本站下载 0 关注 更新于 1 年前

最新 1.0.0 · 1.21.10 · Bukkit / Paper

一键开服(送7天)

PlayerSync

一个适用于 Bukkit/Spigot/Paper 的插件,用于在多个 Minecraft 服务器之间同步玩家的物品栏和末影箱数据。

概述

PlayerSync 使用 MySQL 数据库在多个服务器之间同步玩家的物品栏和末影箱数据。当玩家加入服务器时自动加载数据,离开时保存数据。

支持版本

  • Minecraft: 1.21.x
  • 服务端: Bukkit, Spigot, Paper
  • Java: Java 21 或更高版本

安装

  1. 从发布页面下载最新的 PlayerSync-X.X.X.jar
  2. 将其放入服务端的 plugins 文件夹中
  3. 启动服务器以加载插件
  4. 编辑 plugins/PlayerSync/config.yml 以配置数据库
  5. 重启服务器

数据库设置

PlayerSync 需要一个 MySQL 数据库。

创建 MySQL 数据库

CREATE DATABASE player_sync CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

配置文件

config.yml

编辑 plugins/PlayerSync/config.yml 以配置相关设置。

mysql:
  # MySQL 服务器主机名
  host: localhost
  
  # MySQL 服务器端口号
  port: 3306
  
  # MySQL 用户名
  username: root
  
  # MySQL 密码
  password: password
  
  # 要使用的数据库名称
  database: player_sync
  
  # 使用 SSL 连接
  useSSL: false

settings:
  # 只读模式 (true: 仅读取数据, false: 读写均可)
  read-only: false
  
  # 服务器标识 UUID(留空则自动生成)
  uuid: “”
  
  # 自动同步间隔(秒)
  # 按指定间隔自动保存所有在线玩家的数据
  auto-sync-interval: 60

settings

read-only(默认值:false)

  • true: 仅从数据库读取(不保存)
  • false: 对数据库执行读取和写入操作
  • 在使用多个服务器时,可以将其中一个服务器设置为 false,其余保持为 true

uuid(可选)

  • 服务器标识 UUID
  • 如果留空,将自动生成
  • 生成后,会保存在 config.yml 中

auto-sync-interval(推荐:60)

  • 自动同步间隔(秒)
  • 按指定间隔自动保存所有在线玩家的数据
  • 玩家离开时始终会保存数据,因此此设置用于定期备份
  • 将此值设置为 0 或更低可禁用自动同步

消息文件

plugins/PlayerSync/messages.yml 包含插件输出的日志消息。你可以通过编辑此文件来自定义这些消息。

用法

基本用法

  1. 设置数据库
  2. 在 config.yml 中配置数据库连接详情
  3. 启动服务器
  4. 当玩家加入时,其物品栏和末影箱数据会自动加载
  5. 当玩家离开时,其数据会自动保存

使用多个服务器

  1. 将所有服务器配置为使用同一个数据库
  2. 为每个服务器的 uuid 设置唯一的值(可以使用自动生成)
  3. 通常将所有服务器的 read-only 设置为 false
  4. 如果只有一个服务器保存数据,请将其他服务器设置为 read-only: true

故障排除

数据库连接错误

  • 验证 MySQL 服务器是否正在运行
  • 确认主机名、端口、用户名和密码正确无误
  • 验证防火墙中已开放 MySQL 端口

数据不同步

  • 确认所有服务器使用相同的数据库
  • 检查 read-only 设置
  • 验证数据库权限

性能问题

  • 增加 auto-sync-interval 的值(例如 120 秒)
  • 调整 MySQL 连接池设置

许可证

本项目基于 Apache License 2.0 发布。

详情请参阅 LICENSE 文件。

支持

如果遇到任何问题,请通过 GitHub Issues 报告。

链接

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源