TimeTuner
A plugin for Paper servers (1.21+) offering granular control over world time progression and day/night cycles.
Автор: Summykai90111обновлён 9 апр. 2025 г.
Механики игрыУправлениеУтилиты
Описание
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: falselets 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 defaultday-speedandnight-speedmultipliers (1.0= vanilla;<1.0= slower/longer;>1.0= faster/shorter).sleep: Configure global sleep skipping (allow-skip),percentageor fixedrequired-playersneeded.worlds.<world_name>: Override global settings per world. Setenabled: falseto disable TimeTuner for a world. Customizeday-speed,night-speed,allow-bed-explosions, andallow-thunderstorm-sleep.safety: Toggleoverflow-protection.advanced: Adjusttick-frequency, enabledebug-mode, or enableauto-pause-emptyworlds.
(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]: Setday/night/bothspeed 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)
Галерея
Последние версии
Все версии →release
TimeTuner 1.2.0
1.2.09 апр. 2025 г.772Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5paper, purpur, spigot
Что нового
# TimeTuner Changelog
---
## Version 1.2.0 (2025-04-09)
### Features
- Added configurable (`allow-thunderstorm-sleep`) per-world option to allow sleeping during thunderstorms (defaults true).
- Added configurable (`allow-bed-explosions`) per-world option to prevent bed explosions (e.g., in Nether/End). Defaults to `true` (vanilla behavior).
- Weather automatically clears upon successful sleep skip (night or storm).
### Improvements
- Sleep Logic: Ignores sleeping-ignored players, uses 1-tick delayed skip check for robustness, refined single-player handling, improved debug logs.
- Time Management: Optimized time updates/caching; resuming paused worlds correctly syncs time to prevent jumps.
- Configuration: Added clarifying comments for `allow-bed-explosions` and `allow-thunderstorm-sleep` in `config.yml`.
### Fixes
- Improved reliability of removing players from the sleeping cache upon leave/quit/world change events.
### Compatibility
- Verified compatibility with Minecraft/Paper 1.21.5.
release
TimeTuner 1.1.0
1.1.017 мар. 2025 г.75Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4paper, purpur, spigot
Что нового
# TimeTuner Changelog
## Version 1.1.0
## Performance & Optimization
- **Time Management**: Cached time checks (50ms intervals) and configurable tick frequency (1-20 ticks) for efficiency.
- **Commands**: Centralized permission checks (60% fewer lookups) and cached tab completions (5s cache) for faster execution.
- **World Handling**: Thread-safe world management (`ConcurrentHashMap`) and optimized storage (`WorldConfig`).
- **Sleep System**: Cached player counts for reduced processing overhead; per-world tracking replaces global state.
- **Memory Efficiency**: LRU-cached messages (200 max) and differential config reloads (1s cooldown).
## New & Improved Features
- **Sleep Mechanics**:
- Configurable thresholds: percentage-based (default 50%) or fixed player count.
- Auto-skip for single players.
- Per-world sleep tracking for finer control.
- **Enhanced Status Command**: Displays day/night speeds, world time, and pause state.
- **Improved World Persistence**: Paused worlds retain state after reloads.
## Configuration Updates
- **Customizable Sleep Rules**: Night skip settings in `sleep` section.
- **Advanced Options**: Tick frequency, debug mode, and auto-pause settings.
## Commands & Permissions
- **plugin.yml Cleanup**: Removed unimplemented commands (`worlds`, `worldspeed`).
- **New Command**: `resume` command added.
- **Permissions**: Added `timetuner.resume`, removed `timetuner.worldspeed`.
```
release
TimeTuner 1.0.0
1.0.012 мар. 2025 г.54Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4paper
Что нового
# Initial release of the TimeTuner plugin for 1.21+ Paper Servers.