对不起,您提供的文本“HorizonSync”似乎不完整或不属于需要翻译的游戏内容。请提供完整的游戏文本段落或文件内容,以便我按您的要求逐行翻译,保留格式、标记符、占位符、序号、换行符等所有特殊元素。

对不起,您提供的文本“HorizonSync”似乎不完整或不属于需要翻译的游戏内容。请提供完整的游戏文本段落或文件内容,以便我按您的要求逐行翻译,保留格式、标记符、占位符、序号、换行符等所有特殊元素。

一个服务端模组,允许在不同Fabric服务器之间同步玩家数据。

技术

HorizonSync

HorizonSync 是一款高性能的 Fabric 1.21.1 模组,旨在通过 MongoDB 保持玩家数据的同步与安全。无论你是运行单服务器以实现数据冗余,还是构建一个玩家进度必须统一的多服务器网络,HorizonSync 都能确保无缝体验。

功能特性

背包与装备同步:完全同步主背包、盔甲、副手物品及末影箱。

经验与属性:你的经验等级、经验条进度、生命值、饥饿值及饱和度保持原样。

药水效果:玩家加入服务器时,激活的状态效果会自动恢复。

高性能持久化:采用 3 分钟异步自动保存系统,并在服务器关闭时执行同步“强制保存”,防止数据丢失。

模组支持

HorizonSync 深度集成以下必备的 Fabric 1.21.1 API 与模组:

Accessories API:完全同步饰品槽位与外观。

Trinkets API:完全支持所有 Trinkets 槽位。

Sophisticated Backpacks(非官方 Fabric 移植版):所有背包内容均被序列化并保持同步。

工作原理

与传统方法不同,HorizonSync 利用 MongoDB(NoSQL),可实现极快且灵活的数据写入:

  • 加入游戏时:从云端检索数据,并通过同步网络数据包注入到玩家。
  • 游戏过程中:异步计时器每 3 分钟保存一次更改,不影响服务器 TPS(每秒滴答数)。
  • 离开/关闭时:执行最终保存,确保记录每一次移动和物品。

快速开始
安装:将 HorizonSync .jar 文件放入你的 Fabric 1.21.1 服务器的 mods 文件夹。

MongoDB 配置:首次启动时,/config 文件夹会生成一个配置文件。在其中编辑你的 MongoDB 连接字符串(本地或 Atlas)。

连接:确保你的服务器 IP 已在数据库防火墙中列入白名单。

准备就绪:HorizonSync 会自动创建必要的集合,并开始保护你的数据。

配置选项
所有设置均通过 /config 目录中的配置文件管理。

  • Database Settings
    • uri:你的 MongoDB 连接字符串(例如 mongodb+srv://user:pass@cluster.mongodb.net/)。
    • database:数据库名称(默认:horizonsync)。
    • collection:用于玩家数据的特定集合(默认:playerdata)。

常见问题

问:为什么使用 MongoDB 而不是 MySQL?
答:MongoDB 能更高效地保存复杂对象(例如物品 NBT),减少处理大型或模组背包时的延迟。

问:如果服务器崩溃了会怎样?
答:得益于 3 分钟自动保存系统,数据损失被降至最低。玩家最多只会丢失最近几分钟的进度。

问:是否兼容单人游戏?
答:HorizonSync 针对专用服务器环境进行优化,不建议用于本地单人世界。

问:是否支持其他模组的物品?
答:是的。只要模组将数据存储在标准 Minecraft NBT 中,HorizonSync 就会正确序列化并同步。

HorizonSync – 你的数据,总在地平线上,始终安全。