Mods & tools

MCRealTime

A server plugin that synchronizes Minecraft's day/night cycle with real-world time zones or solar time at real geographic coordinates.

MCRealTime

Overview

MCRealTime is a server-side plugin for Bukkit, Spigot, and Paper that synchronizes the Minecraft day and night cycle with real-world time. Created by Sapentiae, it allows survival worlds and multiplayer servers to match the lighting and atmosphere of a specific time zone or physical location on Earth. The project was extensively rewritten in version 4.8 to include an offline location database, two distinct time calculation modes, and improved configuration management. The subsequent 4.9 update refines solar-event date calculations for locations near the International Date Line.

Clock and Solar Synchronization Modes

Administrators can choose between two synchronization methods: Clock mode and Solar mode. Clock mode follows the standard civil time of a designated time zone, aligning 06:00 with in-game sunrise, 12:00 with noon, 18:00 with sunset, and 00:00 with midnight. Solar mode calculates the actual solar day using the geographical coordinates and time zone of a chosen place, mapping real sunrise, solar noon, and sunset directly to the game cycle. If a selected location experiences polar conditions where a standard solar cycle cannot be computed, the system automatically reverts to Clock mode.

Selecting a real-world place for Solar mode relies on an offline database derived from GeoNames geographical data. Server operators can search and set locations in-game using command tab completion without needing an internet connection for an external geocoding service. Switching between the two modes is handled via the /mcrt mode set clock and /mcrt mode set solar commands, while /mcrt location set assigns the desired geographical area.

World Management, Commands, and Configuration

The plugin can apply real-world time globally across the server or be restricted to a custom list of worlds. It safely handles time-related game rules across different Minecraft versions and automatically skips dimensions that lack a changeable world clock on modern Paper servers. Configuration options allow administrators to adjust the tick synchronization interval, prevent players from sleeping through the night, and disable insomnia mechanics. When the plugin stops or releases control of a world, it restores the original world state.

Access to in-game commands is divided into two permission nodes for regular players and server administrators. Players with the mcrealtime.use permission can check the active synchronization status, current time mode, and selected solar location using /mcrt status, /mcrt mode get, and /mcrt location get. Administrators holding the mcrealtime.admin permission can modify the active mode, pick new locations, reload the runtime configuration via /mcrt reload, and manage plugin updates. When upgrading from older releases, the system automatically archives the previous settings file before migrating to the current configuration format.

Technical Compatibility

The core synchronization code is compiled for Java 8 bytecode and operates without NMS or CraftBukkit dependencies. While it does not run on BungeeCord or Velocity proxies, it has been verified on server setups ranging from Spigot 1.8.8 on Java 8 and Paper 1.14.4 on OpenJDK 8 up to Paper 26.3 on Temurin 25.0.4. Because the plugin configuration intentionally leaves out the api-version tag to maintain backward compatibility with 1.8.8, modern Paper servers will display a standard legacy-plugin warning during startup.

How to install

  1. Stop your Paper/Spigot server.
  2. Put the .jar file into the plugins folder.
  3. Start the server and edit the config it creates.

Similar