- 版权类型
- 原创
- 适用平台
- Java 版服务端（Fabric + Geyser + Floodgate）
- 语言支持
- 中文（简体）
- 前置组件
- Fabric API + https://modrinth.com/mod/fabric-api
Geyser + https://geysermc.org/download/
Floodgate + https://geysermc.org/download/?project=floodgate
Floodgate Local Linking + https://geysermc.org/wiki/floodgate/linking/
- 适配版本（互通）
- 首版只验证了 Java 1.21.1；基岩协议兼容由 Geyser 决定
| ## MineConflux 是什么？ |
| MineConflux 是给 Fabric + Geyser + Floodgate 互通服务器使用的服务端模组。 |
| 它让玩家分别验证 Java 版和基岩版账号，在网页中比较两边的背包、位置、经验、进度等数据，然后选择保留哪一边。绑定完成后，两端会使用同一个 Java 身份和同一份存档。 |
| ## 主要功能 |
| - Java 版和基岩版分别使用 /linkcode 获取一次性验证码 |
| - 网页并排查看两个角色的数据 |
| - 以游戏物品栏样式显示背包、装备、副手和末影箱 |
| - 可保留 Java 进度，或把基岩进度迁移到 Java UUID |
| - 迁移前自动备份玩家存档、进度、统计和计分板 |
| - 玩家未退出服务器时拒绝提交，不会强制踢人 |
| - 绑定后，手机端和电脑端共用同一个角色数据 |
| ## 安装教程 |
| 1. 准备 Minecraft Java 1.21.1 的 Fabric 服务端。 |
| 2. 安装 Fabric API、Geyser 和 Floodgate Fabric。 |
| 3. 按 Floodgate 官方文档启用 Local Linking，并安装 SQLite 或 MySQL 数据库扩展。 |
| 4. 下载 mineconflux-1.0.0.jar，放入服务端 mods 文件夹。 |
| 5. 启动服务器。首次启动会生成 config/mineconflux.json。 |
| 6. 网页默认监听 127.0.0.1:18080。局域网访问可修改 bindAddress；公网请使用 HTTPS 反向代理。 |
| 7. 启动日志出现 MineConflux portal listening 后，打开网页测试。 |
| ## 玩家使用教程 |
| 1. 用 Java 角色进入服务器，输入 /linkcode，记下“Java 版验证码”，然后退出。 |
| 2. 用基岩角色进入同一服务器，输入 /linkcode，记下“基岩版验证码”，然后退出。 |
| 3. 打开账号中心，把两个验证码填入对应输入框。 |
| 4. 检查双方的身份、位置、背包、末影箱、经验、进度和统计。 |
| 5. 选择保留 Java 进度，或保留基岩进度并迁移。 |
| 6. 提交成功后，用任意一端重新进入服务器。 |
| ## 会迁移的数据 |
| 选择保留基岩进度时，会迁移原版 playerdata、进度、统计和已有计分板分数。playerdata 中包含背包、末影箱、位置、维度、经验、生命、饥饿、状态效果和出生点等数据。 |
| 经济、领地、权限、任务、宠物归属等其他插件或模组的数据不会自动迁移。 |
| ## 环境要求 |
| - Minecraft Java 1.21.1 |
| - Fabric Loader 0.19.5 |
| - Fabric API 0.116.17+1.21.1 |
| - Java 21 或更高版本 |
| - Floodgate Fabric 2.2.4 系列 |
| - Geyser 使用 Floodgate 认证 |
| - Floodgate Local Linking 数据库扩展 |
| > 本模组会写入真实玩家存档。正式使用前请备份世界和 Floodgate 数据目录，并先在世界副本中测试。 |
