CycleControl

Simple and flexible control over Minecraft’s day-night cycle.
Make days and nights shorter or longer using one straightforward in-game command.

---

CycleControl is a lightweight server plugin that lets administrators control how long a complete Minecraft day-night cycle lasts. Choose anything from fast-paced short cycles to long, immersive days without manually managing world time.

The selected duration is saved automatically and restored after server restarts.

✨ Features

• Change the complete day-night cycle duration in-game.
• Supports durations from 1 to 1,440 minutes.
• Accepts whole numbers and decimal values.
• Divides the selected duration equally between day and night.
• Applies automatically to every loaded world.
• Saves settings across server restarts.
• Restores the previous doDaylightCycle value when disabled.
• Lightweight design with no external dependencies.

⌨️ Commands

Command	Description
/cyclecontrol	Displays the current cycle duration.
/cyclecontrol <minutes>	Changes the complete day-night cycle duration.
/daycycle <minutes>	Alias for /cyclecontrol.

For example, /cyclecontrol 60 creates a complete 60-minute cycle consisting of approximately 30 minutes of day and 30 minutes of night.

🔐 Permissions

Permission	Description	Default
cyclecontrol.admin	Allows players to view and change the cycle duration.	OP

Commands can also be used through the server console.

📥 Installation

CycleControl requires a compatible Paper, Spigot, or Purpur 1.21.x server running Java 21 or newer.

1. Download CycleControl-1.1.0.jar.
2. Place the JAR inside your server’s plugins folder.
3. Restart the server.
4. Run /cyclecontrol 40 to use a 40-minute cycle.

The default cycle duration is 40 minutes: approximately 20 minutes of day and 20 minutes of night.

🧩 Compatibility

CycleControl supports:

• Paper 1.21–1.21.11
• Spigot 1.21–1.21.11
• Purpur and compatible Paper forks
• Java 21 or newer

CycleControl does not support:

• Fabric or Forge
• Sponge
• Folia
• BungeeCord or Waterfall
• Velocity

Proxy software does not control individual worlds. On proxy networks, install CycleControl separately on each compatible backend server where it should be active.

⚙️ Configuration

CycleControl creates a simple config.yml file:

cycle-minutes: 40.0

You can change this value manually while the server is stopped or use /cyclecontrol <minutes> in-game. Command changes are saved automatically.

🔧 Troubleshooting

If CycleControl does not load:

1. Confirm that the server is running Java 21 or newer.
2. Make sure the server uses Paper, Spigot, Purpur, or a compatible fork.
3. Remove older CycleControl or LongDays JAR files.
4. Restart the server instead of using a plugin reloader.
5. Check the server console for loading errors.

If another plugin controls world time or changes doDaylightCycle, the plugins may conflict.

---

License

Copyright © 2026 FezIsOut. All rights reserved.

Personal use of unmodified builds is permitted. Redistribution, modification, resale, and derivative works require prior written permission from the copyright holder.

_{CycleControl is an independent community project and is not affiliated with Mojang Studios or Microsoft.}