RealTimeSync - Realistic Day/Night Cycles and Weather

RealTimeSync - Realistic Day/Night Cycles and Weather 🌎

Sync your Hytale world time and weather to real life!

Ever wanted your game world to match the real world? RealTimeSync makes it happen by automatically synchronizing your in-game time and weather with your system clock or your set latitude and longitude.

✨ Features

• 🕐 Real-Time Synchronization - In-game time stays in sync with your local system clock
• ☁️ Smoothed Movement - High-frequency sync (every tick) ensures clouds move perfectly smoothly!
• 🌍 Timezone & Geolocation Sync - The ONLY mod that can sync time to your exact coordinates! Paris, Tokyo, or New York - the in-game clock matches the local time of your configured destination.
• 🌦️ Actual Local Weather Sync - Fetches real-world weather data for your exact Latitude/Longitude! Rain, Snow, Storms, and Clouds sync to your real location. Includes automatic retry logic and error handling for reliable weather updates.
• 🌅 Accurate Sun Cycles - Sunrise and sunset match your real-world time or your target geolocation.
• � Real-World Date Sync - The in-game "Day Count" displays the actual day of the month (e.g., 30th = Day 30). This is purely aesthetic and adds to the immersion without changing game mechanics.
• �🛡️ Lag/Crash Protection - Prevents "time loop" bugs and day counter corruption.
• 🔒 Privacy Focused - Your geolocation coordinates are stored locally in your config file. They are NEVER broadcast to chat, logged to the console, or sent to any external server (other than the anonymous weather API request).
• 🛏️ Safe Sleep - Sleeping is supported (resyncs immediately after).
• ⚙️ Per-World Configuration - Each world has its own configuration stored in UserData/Saves/[WORLDNAME]/mods/RealTimeSync/. Existing global configs are automatically migrated with full backward compatibility.

🚀 Roadmap / Planned Features

• ✨ More Environmental Features - Major updates to the environment systems are in development.
• 🤐 Top Secret - We have some game-changing features planned that we aren't ready to reveal yet! 👀

📦 Installation

1. 📥 Download the latest JAR file
2. 📂 Place it in: Hytale/UserData/Mods/
3. ▶️ Start your Hytale server
4. ✅ The mod will auto-configure on first run!

⚙️ Configuration

Config file location:
Hytale/UserData/Saves/[WORLDNAME]/mods/RealTimeSync/config.json

Note: Configuration is stored per-world, allowing unique settings for each world. If you have an existing global config in Hytale/mods/RealTimeSync/config.json, it will be automatically migrated to the world-specific location on first load, preserving all your settings.

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

Options:

• latitude - Latitude for your location (default: NYC 40.7128)
• longitude - Longitude for your location (default: NYC -74.006)
• timeSyncIntervalTicks - How often to sync time in Game Ticks (1 tick = 50ms). Set to 1 for smoothest movement.
• enableTimeSync - true/false, enables or disables time synchronization.
• enableWeatherSync - true/false, enables or disables the weather sync functionality.
• enableGeolocationTime - true/false, if enabled, the mod syncs in-game time to the local time of your coordinates rather than the server's local time.
• geolocUtcOffsetSeconds - (⚠️ DO NOT EDIT) This value stores the timezone offset for your coordinates. It is calculated and set automatically by the mod every sync cycle.
• tempUnit - FAHRENHEIT or CELSIUS
• debugMode - true/false. If true, enables detailed console logs for troubleshooting. (Default: false)

⌨️ Commands

• /realtimesync weather <id> - Manually set weather (pauses sync for 5 mins).
• /realtimesync forecast - Shows real-world and in-game weather status.
• /realtimesync geoloc <on/off> - Toggle geolocation-based time sync.
• /realtimesync toggle <time/weather> <on/off> - Toggle specific synchronization types.
• /realtimesync restore - Manually reset world durations to 1.0x defaults and stop time sync (leaves Weather Sync active if enabled).
• /realtimesync setday <day> - Set the world's day count while preserving the current time of day.

🧪 Manual Recovery

If you have uninstalled the mod and your world is still stuck in 12-hour real-time mode:

1. Load your world.
2. Open ESC > World Settings.
3. Find Day / Night Cycle.
4. Set it to 1x (the Hytale default).
5. Save and exit.

Pro-tip: Run /rts restore before deleting the mod to fix your world instantly!

🎮 How It Works

The mod calculates your real-world sunrise and sunset times based on your timezone, then smoothly transitions your in-game world to match. Time updates happen seamlessly every tick.

Example Mapping:

Real Time	In-Game Event
6:00 AM	🌅 Sunrise
12:00 PM	☀️ Noon (sun directly overhead)
6:00 PM	🌇 Sunset
12:00 AM	🌙 Midnight

No more abstract game time - now you experience realistic, location-based day/night cycles!

💡 Perfect For

• 🎭 Roleplay servers wanting realistic time
• 🏗️ Building projects that need specific lighting
• 🎥 Streamers who want their world to match their schedule
• ❤️ Anyone who enjoys immersive gameplay!

📋 Requirements

• Hytale (Latest Version)
• Java 17+

🐛 Support & Issues

Found a bug? Have a suggestion?
Use the Issues tab on this CurseForge project page!
Report an Issue

📜 License

Copyright (c) 2026 HawkSlayer. All Rights Reserved.

Free for personal use only. No modifications or redistribution permitted.

---

Enjoy realistic time in your Hytale adventures! ☀️🌙