## Overview
BetterTimeFlow gives server administrators complete control over the speed of the Minecraft day-night cycle. By default, Minecraft's 20-minute cycle can feel rushed, leaving little time for immersive building, exploration, or complex survival mechanics.

BetterTimeFlow allows you to stretch the day and night smoothly and realistically, making your world feel larger and your adventures more meaningful without sacrificing server performance or breaking vanilla mechanics.

## Features
* **Customizable Time Multipliers:** Slow down time by any factor. Want a 40-minute day? Set it to 1x. Want a full hour? Set it to 2x. Support for up to 10x slowdown and beyond.
* **Ultra-Smooth Transitions:** Unlike other time plugins that "jump" time every few seconds, BetterTimeFlow uses a high-precision accumulator to ensure time moves smoothly tick-by-tick.
* **Multi-World Support:** Automatically detects and applies time flow changes across all loaded worlds.
* **Smart Overrides:** Automatically manages the `doDaylightCycle` gamerule to ensure there are no conflicts between vanilla time progression and the plugin's logic.
* **Lightweight & Efficient:** Optimized to run a single task that consumes negligible server resources.
* **Instant Reload:** Update your time flow settings on the fly without a server restart.

## Commands
*/timeflow reload* - Reloads the `config.yml` settings.
*Usage: /timeflow reload
*Permission: *bettertimeflow.admin* (or Server OP)

## Permissions
*bettertimeflow.admin* - Allows the use of the reload command.

## How to Install
1. Download the `BetterTimeFlow-1.0.0.jar`.
2. Place the JAR file into your server's `/plugins/` directory.
3. Restart your server.
4. Open `plugins/BetterTimeFlow/config.yml` and set your desired `slowdown-multiplier`.
5. Run `/timeflow reload` in-game or from the console.

## The Math (How it Works)
The plugin calculates time advancement based on your multiplier:
* **0.0** = Vanilla Speed (20 Minute Cycle)
* **1.0** = 2x Slower (40 Minute Cycle)
* **2.0** = 3x Slower (60 Minute Cycle)
* **Formula:** `1 / (Multiplier + 1)` ticks per server tick.

Example setting slowdown-multiplier in the plugins config.yml to 2.0 will set the cycle to 60 minutes, Meaning 30 minute day and 30 minute night totaling in a 60 Minute cycle. The config.yml gives a few examples but they are not limitations you can set it to whatever you want just follow the math so you know how long a cycle is going to take, You could in theory set it to following a real life day and night cycle.

Why my current approach is safe:
Game Ticks remain at 20 TPS: My onEnable starts a task that keeps the server's heartbeat at its natural speed.

Crops and Grass: These rely on "Random Tick Speed," which is independent of the daylight cycle. Since your server is still running at 20 ticks per second, crops will grow at the standard vanilla rate.

Redstone and Entities: Hoppers, pistons, and mobs will move at normal speeds. You won't see the "slow-motion" effect that changing the actual tick rate would cause.