RealTimeSync - 逼真的昼夜循环

RealTimeSync - 逼真的昼夜循环

将您的Hytale世界时间与现实生活同步！

实用

RealTimeSync - 真实昼夜循环与天气 🌎

让你的 Hytale 世界时间与天气与现实同步！

是否曾希望你的游戏世界能与现实世界同步？RealTimeSync 通过自动将游戏内时间和天气与系统时钟或你设定的经纬度同步，实现这一愿望。

✨ 特性

  • 🕐 实时同步 - 游戏内时间与本地系统时钟保持同步
  • ☁️ 平滑移动 - 高频同步（每 tick）确保云朵完美平滑移动！
  • 🌍 时区与地理位置同步 - 唯一能根据你的精确坐标同步时间的模组！巴黎、东京或纽约 - 游戏内时钟与你配置的目标地点当地时间一致。
  • 🌦️ 实际本地天气同步 - 为你精确的纬度/经度获取真实世界天气数据！雨、雪、风暴和云朵与现实位置同步。包含自动重试逻辑和错误处理，确保天气更新可靠。
  • 🌅 精准太阳循环 - 日出和日落与现实时间或目标地理位置匹配。
  • 📅 现实日期同步 - 游戏内“天数”显示实际月中的日期（例如，30日 = Day 30）。这纯粹是美观效果，可增强沉浸感而不改变游戏机制。
  • 🛡️ 延迟/崩溃保护 - 防止“时间循环”错误和天数计数器损坏。
  • 🔒 注重隐私 - 你的地理位置坐标存储在配置文件的本地。它们绝不广播到聊天、记录到控制台或发送到任何外部服务器（匿名天气 API 请求除外）。
  • 🛏️ 安全睡眠 - 支持睡眠（之后会立即重新同步）。
  • ⚙️ 按世界配置 - 每个世界都有自己的配置，存储在 UserData/Saves/[WORLDNAME]/mods/RealTimeSync/。现有全局配置会自动迁移，并保持完全向后兼容。

🚀 路线图 / 计划功能

  • ✨ 更多环境特性 - 环境系统的重大更新正在开发中。
  • 🤐 绝密 - 我们计划了一些改变游戏规则的功能，但尚未准备好透露！👀

📦 安装

  1. 📥 下载 最新的 JAR 文件
  2. 📂 放置到: Hytale/UserData/Mods/
  3. ▶️ 启动 你的 Hytale 服务器
  4. ✅ 模组将在首次运行时自动配置！

⚙️ 配置

配置文件位置:
Hytale/UserData/Saves/[WORLDNAME]/mods/RealTimeSync/config.json

注意: 配置是按世界存储的，允许每个世界拥有独特设置。如果你在 Hytale/mods/RealTimeSync/config.json 有现有的全局配置，它将在首次加载时自动迁移到特定世界的位置，并保留你所有的设置。

{  
  "latitude": 40.7128,  
  "longitude": -74.006,  
  "timeSyncIntervalTicks": 1,  
  "enableTimeSync": true,
  "enableWeatherSync": true,  
  "enableGeolocationTime": false,
  "geolocUtcOffsetSeconds": -18000,
  "tempUnit": "FAHRENHEIT",
  "debugMode": false
}

选项:

  • latitude - 你所在位置的纬度（默认: 纽约 40.7128）
  • longitude - 你所在位置的经度（默认: 纽约 -74.006）
  • timeSyncIntervalTicks - 以游戏刻为单位的时间同步频率（1 tick = 50ms）。设置为 1 可获得最平滑的移动。
  • enableTimeSync - true/false，启用或禁用时间同步。
  • enableWeatherSync - true/false，启用或禁用天气同步功能。
  • enableGeolocationTime - true/false，如果启用，模组会将游戏内时间同步到你的坐标的当地时间，而非服务器的本地时间。
  • geolocUtcOffsetSeconds - （⚠️ 请勿编辑）此值存储你的坐标的时区偏移量。它由模组在每个同步周期自动计算和设置。
  • tempUnit - FAHRENHEIT 或 CELSIUS
  • debugMode - true/false。如果为 true，则启用详细控制台日志以进行故障排除。（默认: false）

⌨️ 指令

  • /realtimesync weather <id> - 手动设置天气（暂停同步 5 分钟）。
  • /realtimesync forecast - 显示现实世界和游戏内天气状态。
  • /realtimesync geoloc <on/off> - 切换基于地理位置的的时间同步。
  • /realtimesync toggle <time/weather> <on/off> - 切换特定同步类型。
  • /realtimesync restore - 手动将世界时长重置为 1.0x 默认值并停止时间同步（如果启用，则保留天气同步）。
  • /realtimesync setday <day> - 设置世界天数，同时保留当前时间。

🧪 手动恢复

如果你已卸载模组，但你的世界仍停留在 12 小时实时模式：

  1. 加载你的世界。
  2. 打开 ESC > 世界设置。
  3. 找到 白天/夜晚循环。
  4. 将其设置为 1x（Hytale 默认值）。
  5. 保存并退出。

专业提示: 在删除模组之前运行 /rts restore 以立即修复你的世界！

🎮 工作原理

该模组根据你的时区计算现实世界中的日出和日落时间，然后平滑地转换你的游戏内世界以匹配。时间更新在每个 tick 无缝进行。

示例映射:

现实时间 游戏内事件
6:00 AM 🌅 日出
12:00 PM ☀️ 正午（太阳在正上方）
6:00 PM 🌇 日落
12:00 AM 🌙 午夜

不再有抽象的游戏时间 - 现在你体验的是真实的、基于位置的昼夜循环！

💡 完美适用于

  • 🎭 想要真实时间的角色扮演服务器
  • 🏗️ 需要特定光照的建筑项目
  • 🎥 希望他们的世界与日程匹配的主播
  • ❤️ 任何喜欢沉浸式游戏体验的玩家！

📋 要求

  • Hytale（最新版本）
  • Java 17+

🐛 支持与问题

发现错误了？有建议吗？
请使用此 CurseForge 项目页面上的Issues选项卡！
报告问题

📜 许可

Copyright (c) 2026 HawkSlayer. 保留所有权利。

仅供个人使用免费。不允许修改或重新分发。

在你的 Hytale 冒险中享受真实时间！ ☀️🌙