MC TimeManager

1.12.2 release, new commands, placeholder, bug fixes and more

Bug fix

• setTime / setFullTime calls in SyncHandler / SpeedHandler / SleepHandler are wrapped in SyncHandler.safeSetTime / safeSetFullTime. Paper builds with tick-rate-frozen worlds (datapack dimensions, /tick freeze, …) no longer spam the console or kill the scheduler task on first throw.

New per-world key: lock-time

Single-key shortcut for "freeze this world at X" or "follow real UTC time". Accepts named presets (noon/dawn/dusk/midnight/day/night), raw ticks (0–23999), HH:mm, or realtime. Plugin internally rewrites start / daySpeed / nightSpeed / firstStartTime.

New /tm subcommands

• /tm lock <world> [time|here|realtime] — write lock-time at runtime
• /tm unlock <world> — clear lock-time
• /tm animation <world> [on|off|toggle|instant] — flip nightSkipMode
• /tm placeholders — list every placeholder (PAPI + in-message form)
• /tm hud [on|off|toggle] — per-player ActionBar opt-in
• /tm nowitem [player] — give a Pocket Watch CLOCK item
• /tm help now renders a colored grouped list inside the plugin

New placeholder: %tm_serverday%

Server-wide elapsed days, persists across restarts via a new firstEverTickNb key (independent of resetOnStartup). Public MainTM.getInitialTick() / getFirstEverTick() getters added.

New features

• Refreshing signs — first line [tm], next 3 lines accept {tm_*} placeholders, plugin redraws on a configurable interval. Persisted to signs.yml. Permission: timemanager.signs.create.
• Pocket-watch /now item — custom CLOCK with PDC marker; right-click runs /now with a configurable cooldown. Permission: timemanager.now-item.use.
• ActionBar HUD — disabled by default. When enabled, broadcasts a configurable {tm_*} format. Players opt out with /tm hud off.
• Enhanced sleep particles — END_ROD / GLOW / FIREWORK layers on top of the existing dust transition. Toggle with sleep.enhanced-particles: false for the old look.
• New worlds default to nightSkipMode: animation. Existing worlds are not touched (admin override safety).

Compatibility

This version should work with recent versions of Minecraft up to 26.1.2 (except on Spigot servers which no longer recognize the DO_DAYLIGHT_CYCLE constant anymore).