Mods & tools

Timesync

A Paper plugin that synchronizes Minecraft world time with real-world time zones using UTC offsets, city names, or geographic coordinates.

Timesync

Overview

Timesync is a Paper plugin designed to match Minecraft's in-game clock with real-world time. It operates independently of Atmosync or other plugins, taking complete control over the time progression of a chosen world. By referencing actual local time, the plugin adjusts the positions of the sun and moon to mirror the real sky and maintains support for the in-game day counter.

To avoid conflicts with standard game mechanics, the plugin automatically turns off the vanilla daylight cycle. Because real-world time serves as the sole reference point, sleeping in a bed will not fast-forward the game to morning if it is still nighttime in reality.

Time Zone Modes and Configuration

Server administrators can choose from three different methods to establish the local time zone in the configuration files. The UTC mode applies a static offset, such as setting the value to 3 for UTC+3 or -5 for UTC-5. Alternatively, the City mode finds the proper zone using a specified city and country name, while the Coordinates mode determines it through exact latitude and longitude values.

When utilizing either the City or Coordinates modes, Timesync relies on the Open-Meteo API to calculate the correct time zone. The server must have an active connection to reach this service, as temporary API outages will prevent the plugin from detecting the time zone in these two modes. Beyond location settings, users can also configure which specific world is affected and define the time refresh rate in seconds.

System Requirements

Running this tool requires Java 21 alongside a Paper server or a compatible server core. According to the documentation, the project is built for Minecraft 1.21.1.

How to install

  1. Install the loader shown in the table (Fabric, Forge or NeoForge) for the same Minecraft version.
  2. Put the .jar file into .minecraft/mods.
  3. Start Minecraft with that loader profile.

Similar