TimeManager

Start here

Install the plugin first. Edit config.yml after the first server start. Use commands, time formats, and permissions to change personal time, freeze the view, and set permissions.

Behavior

TimeManager sets client-side time for the player who uses it. It does not change the server world time. Other players follow the server day-night cycle. A player’s command does not change crops, mobs, redstone, weather, or scheduled events.

Use it to photograph builds, check a scene under different lighting, or freeze a personal view. It does not control time for the whole server. It does not permanently set the world to day or night.

Installation and first start

1. Stop the server and back up the worlds, plugins/, and server logs.
2. Get a JAR from the TimeManager GitHub repository. If the repository has no pre-built file, run mvn clean package with the project’s build toolchain. Choose the artifact from target/.
3. Put the JAR in the server’s plugins/ directory. Keep only one TimeManager JAR there.
4. Start the server and check the console for a successful plugin enable message.
5. On first enable, the plugin generates plugins/TimeManager/config.yml. Restart the server after editing it. The plugin has no configuration reload command.
6. Use a normal player account to run /ptime info and /ptime set day. Confirm that only that account’s view changes. Then use /ptime reset to clean up the test.

If the plugin does not load, check Java, API, and dependency errors in the server log. Do not use the JAR filename to decide if the plugin can load.

Configuration

TimeManager creates its configuration from the source configuration class on first start. The default fields are:

Key	Default	Purpose
debug	false	Enable debug logging.
enable-time-command	true	Register the /ptime command. When disabled, the plugin does not register its command executor.
show-welcome-message	true	Try to show a welcome message when a player joins.
welcome-message	&aTimeManager is enabled! Use &e/ptime help &afor commands.	Join message; Bukkit & color codes are supported.

The join listener checks the timeessence.use permission. The plugin.yml file declares only ptime.set and ptime.freeze. The welcome message may not appear even when show-welcome-message is true. Use the server log and a command to check the plugin.

Next step

Continue with Commands, time formats, and permissions. Use a non-OP test account to verify the result before opening the feature to players.