EnderSync - ：跨服玩家数据同步插件

EnderSync 是一款能够跨多个服务器同步玩家数据的插件，操作简单，功能强大。它可以将玩家的背包、末影箱、生命值、经济等数据实时存储于数据库中，实现服务器间的无缝共享，并提供了简洁的 API 供开发者同步自定义数据。

💡重要提示

• 我们正在开发功能更丰富、性能更稳定的 5.0.0 版本，请加入我们的 Discord 以获取最新动态。
• 如果您在 4.0.0 版本之前使用过本插件，您的 BungeeCord 服务器中将没有 BungeeBridge 文件。插件运行需要此文件，请务必按照下方的“安装”部分进行操作。
• 感谢超过 300 次下载！如果您喜欢这个插件，欢迎留下评价。

🎮插件功能

EnderSync 可以同步多种玩家数据，包括

• 玩家状态：生命值、饥饿值、氧气值、经验值、游戏模式、药水效果、飞行状态。
• 物品与装备：背包物品、装备的盔甲、末影箱内容。
• 位置信息：世界与坐标（需配置）、床重生点。
• 经济系统：金钱（需 Vault 支持）。
• 时间戳：最后在线时间。
• 自定义数据：通过 API 同步任意自定义数据（如统计、计数、特效等）。
• 跨服聊天：全局聊天（即将推出）、与 Discord/IRC/Teamspeak 等互通（即将推出）。

支持的语言

• EN (英语)
• DE (德语)
• FR (法语)
• CN (中文)
• BR (葡萄牙语)

> 注：目前仅提供完整的英文和德文语言文件。如果您已完成或愿意协助翻译，请联系我们。

❓工作原理

• 玩家加入时，插件会从数据库读取并同步该玩家的数据（生命值、背包等）。
• 玩家离开时，插件会将当前玩家数据保存至数据库。
• 自动保存功能会定期保存数据，确保数据库中的数据近乎“实时”。

版本兼容性说明

• 建议所有需要同步的服务器保持相同的 Minecraft 版本，否则可能导致同步问题。
• 特别注意：1.13 版本由于内部改动，无法与其他版本正常同步。混合同步可能导致物品丢失等问题。

✨功能亮点

• 完全免费且开源。
• 支持 1.8 至 1.14 版本（注：1.13 需单独使用）。
• 通过简单的 API 支持同步任意自定义数据。
• 可随时安装，自动同步现有数据。
• 内置安全机制：加密网络通信、防物品复制。
• 轻量高效：仅约 200KB，全异步处理，不影响服务器 TPS。
• 高度可配置，支持多语言。
• 支持完整的物品 NBT 数据存储。
• 支持多种数据库后端（MySQL，MongoDB 即将推出）。
• 提供便捷的管理命令。
• 可自动清理不活跃玩家数据。
• 支持自动更新（可关闭）。

🔧依赖与要求

• MySQL 数据库（MongoDB 支持即将推出）。
• EnderSync 插件文件（服务端与 BungeeCord 端）。
• 如需同步经济数据，需要 Vault 及一个兼容的经济插件。

⭐安装步骤

• 备份您的服务器。
• 从本页面下载 EnderSync-xxx.jar 和 EnderSync-BungeeBridge.jar。
• 将 EnderSync-xxx.jar 放入所有需要同步的 Bukkit/Spigot 服务器的 plugins 文件夹。
• 将 EnderSync-BungeeBridge.jar 放入您的 BungeeCord 服务器的 plugins 文件夹。
• 启动所有服务器，生成配置文件。
• 打开每个服务器的 plugins/EnderSync/config.yml，填入正确的数据库连接信息。

> 您需要手动创建数据库，插件会自动创建所需表格。

• 打开 features.yml，将您希望启用的功能设置为 enabled: true。
• 重启所有服务器，插件即可生效。

🎮配置简介

配置文件主要分为 config.yml 和 features.yml。

主配置 (config.yml)

主要设置数据库连接、语言和聊天前缀。

• database：配置 MySQL 的主机、端口、用户名、密码和数据库名。
• lang：设置语言，如 "en"。
• chatPrefix：定义插件消息的前缀。{success} 占位符会根据操作结果显示 ✔ 或 ✘ 等符号，可按需移除。

功能开关 (features.yml)

在此文件中可以精细控制每个同步与保存功能的开关。

• sync：控制玩家加入时同步哪些数据。
• save：控制玩家退出时保存哪些数据。
• 每个模块（如 inventory, health, vault）都有独立的 enabled 选项。
• 部分功能（如 location 世界同步）需要确保所有服务器的世界名称一致。

🔧命令与权限

主命令为 /endersync 或简称 /es。

命令列表

• /es help – 显示帮助信息。
• /es reload – 重载配置文件。
• /es delete <玩家名> – 从数据库中删除指定玩家的数据。
• /es saveAndKick – 保存所有玩家数据并踢出全体玩家。
• /es inv <玩家名> – 查看/编辑玩家背包（即使离线）。
• /es end <玩家名> – 查看/编辑玩家末影箱（即使离线）。
• /es ecoBal <玩家名> – 查看玩家余额（需 Vault）。
• /es ecoSet <玩家名> <金额> – 设置玩家余额（需 Vault）。
• /sync [玩家名] – 手动同步自己或他人的数据。（不建议给予玩家此权限）
• /save [玩家名] – 手动保存自己或他人的数据。

权限节点

• endersync.* – 授予所有命令权限。
• endersync.admin.reload – 允许使用 /es reload。
• endersync.admin.delete – 允许使用 /es delete。
• endersync.admin.inv – 允许使用 /es inv。
• endersync.admin.end – 允许使用 /es end。
• endersync.admin.ecoBal – 允许使用 /es ecoBal。
• endersync.admin.ecoSet – 允许使用 /es ecoSet。
• endersync.admin.sync.self – 允许对自己使用 /sync。
• endersync.admin.sync.other – 允许对他人使用 /sync。
• endersync.admin.save.self – 允许对自己使用 /save。
• endersync.admin.save.other – 允许对他人使用 /save。

✨API 开发

EnderSync 提供了简单易用的 API，供开发者同步自定义的玩家数据。

• 快速开始：点击查看
• API 文档：点击查看
• 教程与示例：点击查看

> 文档仍在完善中。如果您有优秀的教程或示例愿意分享，请联系我们。

🔧常见问题与错误

• 错误信息：Could not connect to the MySQL Database!

- 此错误表示数据库连接失败。请检查 `config.yml` 中的数据库凭据（用户名、密码、数据库名）是否正确，并确保数据库已创建且可远程访问。

✨未来计划

• 备份功能 (/es backup) 及自动备份。
• 增加 MongoDB 数据库后端支持。
• 为 /sync 命令添加频率限制。
• 开发游戏内 GUI 管理界面。
• 开发网页管理工具。

如果您遇到任何问题或有功能建议，欢迎通过 Discord 或项目页面反馈。再次感谢您的使用！