RealTime is a robust Spigot plugin designed to synchronize in-game time with real-world time on your Minecraft server. Perfect for role-playing, creating immersive experiences, or simply aligning the day-night cycle with reality, RealTime offers a seamless and customizable solution.
Important Note:This plugin is currently in beta. While it has been thoroughly tested, some bugs and issues may still occur. We appreciate your feedback to help us improve.
Key Features
Real-Time Synchronization: Automatically syncs your server's time with real-world time based on the specified time zone, offering an immersive, real-life experience.
Sunrise and Sunset Tracking: Get detailed information on the next and last sunrise and sunset times, enhancing realism in your gameplay.
Advanced Time Zone Management: Select from a wide range of time zones or use the automatic time zone feature (/realtime timezone auto) to sync with your server's system time. Supports tab completion for easy selection.
Dynamic Time Adjustments RealTime adjusts the in-game day and night cycle lengths based on real-world seasons:
Winter: Later sunrise and earlier sunset, shorter days.
Summer: Earlier sunrise and later sunset, longer days.
Spring/Autumn: Balanced sunrise and sunset times, with medium day lengths.
Update Checker: Automatically checks for plugin updates on server startup, ensuring you’re always up to date. Administrators will receive notifications about new versions and relevant download links.
Debug Mode: Activate detailed logging to help with troubleshooting and monitoring of the plugin’s behavior.
Commands /realtime enable: Enables real-time synchronization.
/realtime disable: Disables real-time synchronization.
/realtime reload: Reloads the plugin configuration.
/realtime timezone [zone|auto]: Sets the time zone manually or automatically syncs with the server’s time zone. Displays the current time zone if no argument is provided.
/realtime time: Displays the current real-world time according to the configured time zone.
/realtime debug: Toggles debug mode on or off.
/realtime sun: Provides information on the time until the next sunrise and sunset based on the selected time zone.
/realtime help: Displays the help menu.
Permissions realtime.admin: Grants access to all RealTime commands and update notifications.
Installation Instructions
1. Download the Plugin: Download the latest version of RealTime.
2. Install the Plugin: Place the downloaded .jar file into your server's plugins directory.
3. Start Your Server: Start or restart your Minecraft server. RealTime will automatically create a configuration file in the plugins/RealTime directory.
4. Configure the Plugin:
Open the config.yml file in the plugins/RealTime directory to adjust settings such as enabling time synchronization, setting your time zone, or activating debug mode.
You can easily select a valid time zone using the /realtime timezone command with tab completion.
For a full list of valid time zones, refer to the detailed list at the bottom.
# Enable real-time synchronization on server startup. enabled: true
# Default time zone for synchronization. # Use a valid ZoneId, e.g., Europe/Berlin # You can easily select a valid time zone using the /realtime timezone command with tab completion. timezone: Europe/Berlin
# Enable or disable the update checker. # When enabled, the plugin will check for updates on server startup and notify players with the specified permission. update-checker: true
# Permission Settings # -------------------
# Set the permission required to use admin commands related to the RealTime plugin. admin-permission: realtime.admin
# World Exclusions # ----------------
# List of worlds that should NOT be affected by the real-time synchronization. # Use the exact world names as they appear in your server. excluded-worlds: - world_nether
- world_the_end
# Logging Settings # ---------------- logging: # Enable or disable debug mode. # When enabled, detailed logs will be recorded in the server console. debug: false
enabled: Enables or disables the real-time synchronization on server startup.
timezone: Specifies the time zone for synchronization. Use a valid ZoneId (e.g., Europe/Berlin).
update-checker: Enables or disables the update checker. If enabled, the plugin will check for updates and notify players with the appropriate permissions.
admin-permission: Sets the permission required for admin commands related to the RealTime plugin.
excluded-worlds: Lists the worlds that should not be affected by the real-time synchronization.
logging.debug: Enables or disables debug mode, providing detailed logs in the console.
Available Time Zones:
Below is a list of all available time zones that you can use in the config.yml file or select using the /realtime timezone command: