MySqlPlayerBridge

插件

· 作者 Lostes-Burger

使用 MySQL 数据库跨服务器同步玩家数据,免费的现代替代方案

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

最新 4.1.0 · 26.3 · Folia / Paper

一键开服(送7天)

MySqlPlayerBridge

MySqlPlayerBridge

适用于 Minecraft 服务器的现代玩家数据同步方案,基于 MySQL。专为当前 Paper/Bukkit 和 Folia 服务器构建,采用模块化同步与管理工具设计。旨在为多服务器架构提供支持,确保单一数据库作为唯一数据源(Source of Truth)。

GitHub

亮点

  • 兼容 Folia 与 Bukkit/Paper,采用异步优先的设计。
  • 基于模块的同步,仅启用所需功能。
  • 管理员编辑工具,允许直接在数据库中检查和修改玩家数据,包括用于背包的 GUI 编辑器。
  • 安全日志记录与本地错误快照,便于故障排查和数据恢复。
  • 防冲突保护,避免从错误的服务器覆盖数据。

功能

  • 跨服务器同步,使用共享 MySQL 数据库。每个模块拥有独立的表以确保隔离与安全。
  • 可选模块(按需启用):
    • 背包 (Inventory)
    • 副手 (Offhand)
    • 末影箱 (Ender Chest)
    • 护甲 (Armor)
    • 位置 (Location)
    • 游戏模式 (Gamemode)
    • 经验值 (Experience)
    • 生命值 (Health)
    • 饱和度 (Saturation)
    • 经济系统 (Vault)
    • 药水效果 (Potion Effects)
    • 进度/成就 (Advancements)
    • 统计数据 (Statistics)
    • 快捷栏槽位选择
  • 管理员命令,用于操作与恢复:
    • /mpb sync 手动同步
    • /mpb clear 清除玩家数据
    • /mpb edit 编辑玩家数据(包含 GUI 背包编辑器及直接数值编辑)
  • 自动同步任务,定期保存数据。
  • 错误处理,提供结构化日志和数据备份(存储于插件文件夹下)。

安装

  1. 下载并安装 NBTAPI。
    • 用于背包、护甲、末影箱和副手的序列化支持。
  2. 将 MySqlPlayerBridge 放入服务器的 plugins/ 文件夹中。
  3. 启动服务器一次以生成配置文件。
  4. 在 plugins/MySqlPlayerBridge/mysql.yml 中配置 MySQL。
  5. 在 plugins/MySqlPlayerBridge/config.yml 中启用所需的模块。
  6. 重启服务器。

MySQL 设置(原生服务器)

创建具有最小权限的数据库和用户。以下是本地 MySQL 服务器的示例:

CREATE DATABASE mpb;
CREATE USER 'mpb_user'@'%' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON mpb.* TO 'mpb_user'@'%';
FLUSH PRIVILEGES;

然后配置 mysql.yml:

host: "127.0.0.1"
port: 3306
database: "mpb"
user: "mpb_user"
password: "your_password"
main-table-name: "player_data"

管理员编辑功能

编辑系统设计用于实际运维场景:

  • 直接在数据库中编辑任何受支持模块的值。
  • 背包、护甲、末影箱和副手通过 GUI 进行编辑。
  • 数值字段在保存前会验证输入。
  • 支持通过数据库条目编辑离线玩家。

示例:

/mpb edit <player> inventory
/mpb edit <player> offhand
/mpb edit <player> location <world> <x> <y> <z> [yaw] [pitch]
/mpb edit <player> exp <value>
/mpb edit <player> exp_level <value>

要求

  • MySQL 或 MariaDB
  • Java 21
  • NBTAPI(用于背包序列化必需)
  • Vault(可选,用于经济同步)

语言

内置翻译:

  • English: src/main/resources/lang/en-us.yml
  • German: src/main/resources/lang/de-de.yml
  • Chinese: src/main/resources/lang/zh-cn.yml

您可以通过 PR 随时提交新的翻译。请保持键结构格式与现有文件一致。

注意

  • 不同 Minecraft 版本之间的跨版本同步不保证完全兼容。
  • 对 Folia 和 Bukkit/Paper 的支持仍是核心重点。

许可证

请参阅 LICENSE

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源