⏰ ClockTimeDisplay — Elegant In-Game Time Display for Your Server!
ClockTimeDisplay is a lightweight and stylish plugin for Paper 1.21.1+ servers that shows the current in-game time directly in the action bar when a player holds a clock. Perfect for survival servers, roleplay, or any server where players need to track the day/night cycle!
✨ Features
Simple & Intuitive — just hold a clock in your main or off-hand, and the time appears!
Real-Time Updates — time refreshes every second, always accurate.
Clean Action Bar Display — beautiful gold-colored text with a clock emoji.
Auto-Hide — time display disappears instantly when you switch away from the clock.
12-Hour Format — displays time in AM/PM format (e.g., ⏰ 03:24 PM).
Zero Configuration — plug-and-play, no setup required!
🎮 How It Works
Holds the clock in either main hand or off-hand.
Action bar instantly shows the current Minecraft game time.
Switch to another item — the display disappears.
Switch back to the clock — time reappears!
🕒 Time Format
The plugin converts Minecraft ticks to real-world time:
Game Time Display Sunrise (6:00) ⏰ 06:00 AM Noon (12:00) ⏰ 12:00 PM Sunset (18:00) ⏰ 06:00 PM Midnight (0:00) ⏰ 12:00 AM Format: ⏰ HH:MM AM/PM
📦 Installation
Download ClockTimeDisplay-1.0.jar.
Place it in your server's plugins folder.
Restart your server (or run reload).
Done! Players can now see time by holding a clock.
❓ FAQ
Does it work with off-hand clocks?
Yes! Clocks in either main hand or off-hand will display the time.
What if a player has a clock in both hands?
No problem — the plugin detects it and shows the time once.
Does this affect performance?
The plugin is extremely lightweight. It only runs a check every second and only processes players holding clocks.
