实时（时间管理器）

RealtimeSync

RealtimeSync 可将 Minecraft 游戏内时间与服务器的真实系统时间或可配置的自定义昼夜时长同步。

这是一个轻量级的服务端 Minecraft 模组。它禁用原版的昼夜循环，并手动控制世界时间，使游戏内的白天遵循真实的服务器时钟或您自己的自定义时间规则。

---

为什么使用 RealtimeSync？

• 实时昼夜循环 — Minecraft 时间可以跟随服务器的实际时钟。
• 自定义昼夜时长 — 让 Minecraft 的一整天持续您想要的任意时长。
• 仅服务端 — 玩家无需在客户端安装此模组。
• 多加载器支持 — 为 Fabric、Quilt、Forge 和 NeoForge 提供独立版本。
• 无 Mixin — 与其他服务端模组具有更安全的兼容性。
• 简单配置 — 不依赖 Cloth Config、AutoConfig 或客户端 UI。
• 多维度支持 — 同步所有已加载世界或仅同步主世界。
• 热重载配置 — 大多数配置更改会自动生效。

---

支持的加载器

RealtimeSync 采用多加载器项目结构。请勿将一个 jar 文件用于所有加载器。 请为您的 Minecraft 版本和模组加载器下载正确的文件。

加载器	所需文件	备注
Fabric	realtime-sync-fabric-<mc-version>-<mod-version>.jar	需要 Fabric API。
Quilt	realtime-sync-fabric-<mc-version>-<mod-version>.jar	使用与 Fabric 兼容的 jar 文件。
Forge	realtime-sync-forge-<mc-version>-<mod-version>.jar	原生 Forge 版本。
NeoForge	realtime-sync-neoforge-<mc-version>-<mod-version>.jar	原生 NeoForge 版本。

---

兼容性

每个上传的文件都是为特定的 Minecraft 版本和加载器构建的。下载前请始终检查文件名和 CurseForge 文件对应的游戏版本。

• Minecraft 1.21.x — 在 1.21.x 发布系列中支持。
• Minecraft 26.1.x — 在独立的 26.1.x 发布系列中支持。
• Java — 使用您的 Minecraft 版本所需的 Java 版本。
• Fabric / Quilt — 需要 Fabric API。
• Forge — 仅在 Forge 上使用 Forge jar 文件。
• NeoForge — 仅在 NeoForge 上使用 NeoForge jar 文件。

重要提示： 请勿在不同加载器之间混用文件。Fabric 的 jar 文件无法在 Forge 或 NeoForge 上运行，NeoForge 的 jar 文件也无法在 Fabric 上运行。

---

安装

Fabric

1. 安装 Fabric 服务端或 Fabric 客户端配置。
2. 为相同的 Minecraft 版本安装 Fabric API。
3. 为您 Minecraft 版本下载 RealtimeSync 的 Fabric jar 文件。
4. 将两个 jar 文件都放入 mods 文件夹。
5. 启动服务器一次以生成配置文件。

Quilt

1. 安装 Quilt 服务端或 Quilt 客户端配置。
2. 安装您的 Quilt 实例所需的 Fabric API / QFAPI 设置。
3. 为您 Minecraft 版本下载与 Fabric 兼容的 RealtimeSync jar 文件。
4. 将其放入 mods 文件夹。
5. 启动服务器一次以生成配置文件。

Forge

1. 安装 Forge 服务端或 Forge 客户端配置。
2. 为您 Minecraft 版本下载 RealtimeSync 的 Forge jar 文件。
3. 将其放入 mods 文件夹。
4. 启动服务器一次以生成配置文件。

NeoForge

1. 安装 NeoForge 服务端或 NeoForge 客户端配置。
2. 为您 Minecraft 版本下载 RealtimeSync 的 NeoForge jar 文件。
3. 将其放入 mods 文件夹。
4. 启动服务器一次以生成配置文件。

---

配置

RealtimeSync 为所有加载器使用一个共享配置文件：

config/realtime.properties

默认配置示例：

enabled=true
forceDaylightCycleOff=true
syncAllWorlds=true
updateInterval=60
offsetHours=0
customDayLengthMinutes=0
debugLogging=false

enabled

启用或禁用 RealtimeSync，无需移除模组。

forceDaylightCycleOff

保持原版 doDaylightCycle 游戏规则处于禁用状态，防止 Minecraft 与模组的手动时间控制冲突。

syncAllWorlds

同步所有已加载世界和维度的时间。如果您只想同步主世界，请将此设置为 false。

updateInterval

控制模组更新世界时间的频率，单位为服务器刻（tick）。20 刻 = 1 秒。

offsetHours

将实时同步向前或向后移动指定的小时数。例如：offsetHours=2 将使游戏内时间比服务器时钟快 2 小时。

customDayLengthMinutes

控制自定义昼夜时长。使用 0 与真实服务器时钟同步。使用大于 0 的值可使 Minecraft 的一整天持续该时长的真实世界分钟数。

debugLogging

启用详细的日志消息以进行故障排除。在正常游戏期间请保持禁用状态。

---

旧版配置迁移

旧版本使用：

config/realtime.toml

新版本使用：

config/realtime.properties

如果 realtime.properties 尚不存在，RealtimeSync 将尝试读取一次旧的 realtime.toml 文件，并自动创建新配置。

---

常见问题

游戏提示模组在入口点加载期间失败

这通常意味着为当前加载器安装了错误的 jar 文件、使用了错误的 Minecraft 版本，或者在 Fabric/Quilt 上缺少 Fabric API。

• Fabric 需要 Fabric jar 文件和 Fabric API。
• Quilt 使用与 Fabric 兼容的 jar 文件。
• Forge 需要 Forge jar 文件。
• NeoForge 需要 NeoForge jar 文件。
• 请勿同时安装多个不同加载器的 RealtimeSync jar 文件。

时间不断被改回去

确保启用了 forceDaylightCycleOff=true。RealtimeSync 手动控制时间，因此原版的昼夜循环应保持禁用状态。

配置更改未立即生效

配置每隔几秒会自动检查一次。如果某个值仍未生效，请重启服务器并检查日志中是否有无效的配置值。

---

备注

• 此模组仅限服务端。
• 加入服务器的玩家无需在客户端安装。
• 该模组默认禁用 doDaylightCycle。
• 使用 customDayLengthMinutes=0 进行真实服务器时钟同步。
• 使用 customDayLengthMinutes>0 自定义 Minecraft 白天的长度。

---

许可证

RealtimeSync 使用 CC0-1.0 许可证授权。