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.

🛡️ Lag/Crash Protection - Prevents "time loop" bugs and day counter corruption.

🛏️ 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

📥 Download the latest JAR file

📂 Place it in: Hytale/UserData/Mods/

▶️ Start your Hytale server

✅ 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" } 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

⌨️ 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.

/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:

Load your world.

Open ESC > World Settings.

Find Day / Night Cycle.

Set it to 1x (the Hytale default).

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! ☀️🌙