⏰ 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.