TimeTuner - Precision Time Control for Minecraft Servers

Transform your server's day/night cycle with TimeTuner, a powerful Paper plugin giving you complete control over time progression and related world mechanics. Perfect for survival servers, creative worlds, adventure maps, or any server needing customized time and world rule management.

Why TimeTuner?

• Custom Time Speeds: Make days longer and nights shorter (or vice versa) globally or per world.
• Per-World Control: Apply different speeds and rules (sleep, explosions, thunderstorms) to different worlds.
• Smart Sleep & World System: Highly configurable sleep skipping, thunderstorm sleeping control, bed explosion prevention, and weather clearing.
• No Restart Required: Reload configuration changes instantly using /timetuner reload.
• Performance Friendly: Optimized with optional auto-pause for empty worlds and efficient updates.
• Reliable: Includes time overflow protection & time sync on resume ensuring smooth operation.

Standout Features

🌍 World-Specific Control

• Set unique day/night speed multipliers for each world.
• Enable/disable TimeTuner management per world (enabled: false lets vanilla rules apply).
• NEW: Configure specific rules per world: allow-bed-explosions, allow-thunderstorm-sleep.
• Pause/Resume time globally or for specific worlds.

🛏️ Enhanced Sleep & World Mechanics

• Choose between player percentage or fixed player count to skip the night/storm.
• NEW: Configurable Thunderstorm Sleeping: Per-world toggle (allow-thunderstorm-sleep) for vanilla thunderstorm sleep behavior.
• NEW: Configurable Bed Explosions: Per-world toggle (allow-bed-explosions) to prevent beds exploding (e.g., in Nether/End).
• NEW: Weather Clearing: Automatically clears rain/thunder when sleep successfully skips time.
• Robust logic ignores sleeping-ignored players and uses delayed checks for stability.
• Automatic skip for single players (who aren't ignoring sleep).

⚡ Performance & Reliability

• Auto-pause time in empty worlds to save resources (configurable via auto-pause-empty).
• Built-in protection against time value overflow (overflow-protection).
• Automatic cleanup for unloaded worlds.
• IMPROVED: Resuming from pause correctly syncs time to prevent jumps if time was changed externally.

Configuration Overview

TimeTuner's config.yml allows detailed customization:

• global-speeds: Set default day-speed and night-speed multipliers (1.0 = vanilla; <1.0 = slower/longer; >1.0 = faster/shorter).
• sleep: Configure global sleep skipping (allow-skip), percentage or fixed required-players needed.
• worlds.<world_name>: Override global settings per world. Set enabled: false to disable TimeTuner for a world. Customize day-speed, night-speed, allow-bed-explosions, and allow-thunderstorm-sleep.
• safety: Toggle overflow-protection.
• advanced: Adjust tick-frequency, enable debug-mode, or enable auto-pause-empty worlds.

(Refer to the full README.md or config comments for detailed explanations of each option.)

Commands

• /timetuner help: Show help message.
• /timetuner reload: Reload configurations (config.yml & messages.yml).
• /timetuner pause [world]: Pause time globally or in a specific world.
• /timetuner resume [world]: Resume time globally or in a specific world.
• /timetuner speed <type> <speed> [world]: Set day/night/both speed multiplier globally or per world.
• /timetuner reset [world]: Skip to day (time 0) globally or per world (clears weather if applicable).
• /timetuner status: Show current status for managed worlds.

(Alias: /tt)