MySQL Inventory Bridge - MySQL库存同步器

简介

这是一个轻量级插件，通过 MySQL 数据库在任意数量的服务器之间同步玩家的背包和盔甲数据。当玩家离开服务器时，插件会将其背包数据上传至数据库；当玩家加入服务器时，插件会从数据库读取并同步其数据。

💡功能特性

• 支持正版 UUID 和离线 UUID。
• 仅使用 MySQL 数据库。
• 同步玩家的背包物品。
• 同步玩家的盔甲（可在配置中禁用）。
• 支持模组物品。
• 提供数据库维护任务，可清理非活跃用户数据。

❓工作原理

插件通过监听服务器的加入和离开事件来实现数据同步。

• 当玩家离开服务器时，插件会将其背包数据上传至 MySQL 数据库。
• 当玩家加入服务器时，插件会从 MySQL 数据库中检查其账户数据，并同步到当前服务器。

✨依赖项

• 必需：一个 MySQL 数据库。
• 可选：ProtocolLib - 下载链接

- ProtocolLib 是支持模组物品所必需的。

🔧安装说明

• 将插件放入服务器的 plugins 文件夹。
• 启动服务器以生成配置文件，然后停止服务器。
• 打开配置文件 config.yml，设置数据库连接信息。你需要先创建数据库，插件会自动创建数据表。
• 启动服务器。完成！现在你可以在任意数量的服务器上同步玩家数据了。

注意：此插件没有命令或权限节点。

🎮配置示例

# MySQL 数据库详情
database:
  mysql:
    # MySQL 服务器地址
    host: 127.0.0.1
    # MySQL 服务器端口 (默认 3306)
    port: 3306
    # 数据库名称 (注意：你需要先创建数据库，插件会自动创建表。)
    databaseName: 'mydatabase'
    # 表名称 (插件会自动创建)
    tableName: 'meb_inventory'
    # 用户名
    user: 'admin'
    # 用户密码
    password: 'cheesecake'
    # SSL 连接
    sslEnabled: false

# 从数据库中移除非活跃用户。此维护任务将在每次服务器启动后延迟2分钟执行。
maintenance:
  # 启用或禁用数据库维护。 | (true 或 false)
  enabled: false
  # 非活跃天数。默认 60 天。
  inactivity: 60

# 其他可配置选项
General:
  # 保存在线玩家数据到数据库的任务。禁用此任务后，数据仅在玩家断开连接时保存。
  # 为避免服务器崩溃导致数据丢失，建议启用此保存任务。它以异步方式运行，不会造成卡顿。
  saveDataTask:
    # 启用或禁用数据保存任务。 | (true 或 false)
    enabled: true
    # 数据保存间隔时间（分钟）。 | 默认 3 分钟。
    interval: 3
    # 隐藏数据保存任务的日志信息。
    hideLogMessages: false

  # 登录时经济同步延迟（毫秒，默认 1000 毫秒 = 1 秒）
  # 在 BungeeCord 设置中需要此延迟，因为跨服移动时，退出和登录事件几乎同时发生。
  loginSyncDelay: 1000

  # 设置为 false 以禁用玩家盔甲同步。 | (true 或 false)
  syncArmorEnabled: true

  # 启用模组物品支持。这需要 ProtocolLib 依赖！ | (true 或 false)
  # 如果你的某些模组物品的 NBT 数据丢失，则需要启用此项。
  enableModdedItemsSupport: false

  # 禁用此插件产生的声音。例如同步完成的确认音效。 | (true 或 false)
  disableSounds: false

# 调试控制台信息
Debug:
  # 背包同步调试信息。
  InventorySync: false

# 聊天消息，支持完整的颜色和格式代码。通过设置为 '' 来禁用任何消息。
# 示例：syncComplete: ''
# Minecraft 颜色和格式代码：http://minecraft.gamepedia.com/Formatting_codes
ChatMessages:
  syncComplete: '&2[MIB] &a数据同步完成！'
  inventorySyncError: '&4[警告] &c加载你的背包时出错！请联系管理团队。'
  inventorySyncBackup: '&6[!] &e已恢复本地背包！断开连接时请不要将物品留在背包中！'

⭐相关插件推荐

• MySQL Player Data Bridge

- 你是否希望将玩家数据（背包、末影箱、金钱、生命值、经验等）保存到 MySQL 数据库？或者跨服同步玩家数据？请查看此插件。

• Essentials MySQL Storage Extension

- 你是否希望将 Essentials 数据保存到 MySQL 数据库？或者跨服同步 Essentials 数据？请考虑查看此插件。

🔧支持与致谢

如果你喜欢这个资源并想通过捐赠表示感谢，请使用 PayPal 按钮。谢谢！

此插件由 CraftersLand Minecraft 社区 制作。欢迎访问我们的网站：www.craftersland.net。