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 背包编辑器及直接数值编辑)
- 自动同步任务,定期保存数据。
- 错误处理,提供结构化日志和数据备份(存储于插件文件夹下)。
安装
- 下载并安装 NBTAPI。
- 用于背包、护甲、末影箱和副手的序列化支持。
- 将
MySqlPlayerBridge放入服务器的plugins/文件夹中。 - 启动服务器一次以生成配置文件。
- 在
plugins/MySqlPlayerBridge/mysql.yml中配置 MySQL。 - 在
plugins/MySqlPlayerBridge/config.yml中启用所需的模块。 - 重启服务器。
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
你是这个资源的作者?登录后可认领此资源。
相似资源
数据包事件PacketEvents
retrooper
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
前置科技
27
ExyliaLib
ExyliaServices
ExyliaPlugins 的库。
前置实用
26
ProAuthMeLogin
3623813757
通过对话框或铁砧界面帮助你的 Anthme
实用
16
Vessel
muhdfdeen
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
生物存储
13
Vivecraft Spigot Extension
fayer3
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
前置实用
12
旅行地图
mysticdrew
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
冒险实用
12
评论 0
登录后参与评分
还没有评论,来抢沙发吧