WorldGuard Time Flags: Control Time in Minecraft Regions

Mastering Time Control in Minecraft with WorldGuard Time Flags Time manipulation is one of the most powerful tools a Minecraft server administrator can wield. Whether you want to create an eternal sunset for a roleplay town, freeze midnight in a haunted forest, or offset the day-night cycle in a ...

Download WGTimeFlags for Minecraft 1.5.1

Original name: WGTimeFlags

Minecraft: 1.5.1

FileVersionLoaderSize
WGTimeFlags.jar1.5.1—11 КБDownload

Mastering Time Control in Minecraft with WorldGuard Time Flags

Time manipulation is one of the most powerful tools a Minecraft server administrator can wield. Whether you want to create an eternal sunset for a roleplay town, freeze midnight in a haunted forest, or offset the day-night cycle in a specific biome, the WorldGuard Time Flags plugin gives you precise control over player time within protected regions. This lightweight extension builds upon the popular WorldGuard protection plugin, adding a set of intuitive flags that alter how each player perceives time when they step into a defined area.

What Are WorldGuard Time Flags?

WorldGuard Time Flags is a Bukkit/Spigot plugin that expands the region flag system of WorldGuard. Normally, WorldGuard allows you to set flags like PvP, entry, and greeting messages. This plugin introduces four new flags—fix-time, delta-time, min-time, and max-time—that directly manipulate the in-game time for any player inside a region. The effect is seamless: as soon as a player crosses the region boundary, their client’s time display shifts accordingly, while the actual world time remains unchanged for everyone else. This makes it perfect for adventure maps, minigame arenas, or any build where atmosphere matters.

Key Time Flags Explained

The plugin’s power lies in its four distinct flags, each suited for a different scenario. Here’s how they work:

fix-time: Locking the Clock

The fix-time flag does exactly what its name suggests—it fixes the time inside the region to a specific value. For example, setting /region flag <region> fix-time 6000 will permanently keep the time at 6000 ticks (noon) for anyone inside. This is ideal for creating a perpetual daylight zone, like a marketplace that never sleeps, or a spooky dungeon stuck at midnight (18000 ticks). Players entering the region will instantly see the frozen time, and it won’t progress until they leave.

delta-time: Shifting the Day-Night Cycle

With delta-time, you can offset the time relative to the world’s actual time. The command /region flag <region> delta-time -3000 subtracts 3000 ticks from the current world time, so if it’s noon (6000 ticks) in the overworld, the region will display 3000 ticks (early morning). This flag maintains the natural progression of time but keeps a constant difference, which is perfect for simulating time zones or creating a region that’s always a few hours ahead or behind the main world.

min-time and max-time: A Time Window

Sometimes you don’t want to freeze time completely but need to keep it within a certain range. The min-time and max-time flags define a time interval that the player’s clock cannot escape. For instance, setting min-time to 6000 and max-time to 12000 ensures that time cycles between noon and dusk. If the world time reaches 12000, the player’s time resets back to 6000, effectively looping the daylight hours. This is excellent for survival servers that want to prevent night-time mob spawns in a safe zone without breaking immersion.

How to Use the Flags

Applying these flags is as simple as using WorldGuard’s standard region commands. First, make sure you have a region defined with WorldGuard. Then, use the following syntax:

  • Fix time: /region flag <region> fix-time 6000
  • Offset time: /region flag <region> delta-time -3000
  • Set time window: /region flag <region> min-time 6000 and /region flag <region> max-time 12000

To remove a flag, simply type the flag name without a value, like /region flag <region> fix-time. This resets the flag to its default state, allowing normal time progression again. Managing these flags across multiple regions can become complex, but modern launchers like foxygame.net simplify the process. With its intuitive interface, you can quickly install WorldGuard Time Flags from the built-in mod and plugin menu, making server customization feel effortless and streamlined.

Permissions and Configuration

The plugin includes a permission node, wgtimeflags.ignore, which exempts players from the time effects. This is useful for admins or moderators who need to see the real world time while testing regions. Additionally, the plugin generates a configuration file at <plugins folder>/WGTimeFlags/config.yml on first run. The only adjustable setting is time-check-interval, which controls how frequently the min-time and max-time flags are checked. A lower value (e.g., 20 ticks) provides a smoother experience but may increase server load; a higher value (e.g., 100 ticks) reduces lag but can cause a slight delay before the time resets. Tune this based on your server’s performance and the number of active regions.

Performance Considerations

Since the plugin only modifies the time packet sent to players, it’s extremely lightweight. However, if you use min-time and max-time extensively across many regions, the time-check-interval becomes crucial. The plugin checks each player’s region and adjusts time accordingly, so a very short interval could strain a busy server. Start with the default 20 ticks and increase it if you notice any TPS drops. For servers with hundreds of players, consider using fix-time or delta-time instead, as they require no periodic checks after the initial boundary crossing.

Conclusion

WorldGuard Time Flags unlocks a new layer of environmental storytelling and gameplay design in Minecraft. By giving server owners the ability to freeze, shift, or constrain time within regions, it empowers builders to craft immersive experiences that react to player presence. Whether you’re designing a vampire castle locked in eternal night or a serene village basking in perpetual dawn, these flags are simple to configure and highly effective. Experiment with the different flags, adjust the configuration to suit your hardware, and watch your world come alive with dynamic time zones.