🌎 SGLocalTime – Display local time, date, and day/month info for each player!

✨ SGLocalTime is a lightweight and powerful Minecraft plugin that lets you display each player’s real-world local time, date, day, and month directly in chat, the scoreboard, or GUIs using PlaceholderAPI!

No more confusion when scheduling events — your players will always know what time it is in their own timezone! 🕒🌍

🌟 Features

✅ Detects players’ local timezone automatically.
✅ Shows local time, date, day of the week, day number, or month using placeholders.
✅ Fully customizable time and date formats via config.yml.
✅ All messages are now in messages.yml for easier customization.
✅ Includes /sglocaltime command to show personal time, date, or reload the plugin.
✅ Lightweight ⚡ and optimized for high-performance servers.
✅ Fully compatible with PlaceholderAPI and plugins like TAB, DeluxeMenus, holograms, and more.
✅ Works out of the box — just drop it in your plugins folder and go!

📦 Placeholders

Use these placeholders anywhere that supports PlaceholderAPI:

Placeholder	Description
`%sglocaltime_time%`	Shows the player’s current local time.
`%sglocaltime_date%`	Shows the player’s local date.
`%sglocaltime_datetime%`	Shows both date and time in one placeholder.
`%sglocaltime_dayname%`	Shows the name of the day of the week.
`%sglocaltime_daynumber%`	Shows the number of the day of the month.
`%sglocaltime_monthname%`	Shows the name of the current month.

⚙️ Configuration (`config.yml`)

prefix: '&8[&6SGLocalTime&8] &r'

formats:
  time-format: 'HH:mm:ss'
  date-format: 'dd/MM/yyyy'
  datetime-format: 'dd/MM/yyyy HH:mm:ss'

placeholders:
  locale: 'es' # Change to en, fr, de, etc.

All messages like reload-success or invalid-usage are now located in messages.yml, which can be easily customized without touching config.yml.

📜 Commands & Permissions

Command	Description	Permission
`/sglocaltime time`	Shows your local time.	(none)
`/sglocaltime date`	Shows your local date.	(none)
`/sglocaltime dayname`	Shows the day of the week.	(none)
`/sglocaltime daynumber`	Shows the day of the month.	(none)
`/sglocaltime monthname`	Shows the current month.	(none)
`/sglocaltime reload`	Reloads the configuration.	`sglocaltime.reload`

⚡ Performance

SGLocalTime is designed to be fast and lightweight.
Time zone detection is optimized and cached to avoid unnecessary requests.
Perfect for small servers, large networks, or anything in between.

📥 Installation

Download the latest release of SGLocalTime.
Place it in your server’s plugins folder.
Make sure you have PlaceholderAPI installed.
Start or reload your server.
Customize config.yml for formats and messages.yml for messages.

💡 Tip: Use the placeholders in your scoreboard (like TAB), menus, holograms, or BossBars to display players’ local time dynamically!

🟩 Compatibility

🟢 Supported Server Versions: Paper / Spigot 1.17 – 1.21+
🔗 Works with PlaceholderAPI-based plugins like TAB, DeluxeMenus, Scoreboard plugins, holograms, BossBars, etc.

❤️ Support & Contribution

We’d love your feedback!
⭐ Leave a rating if you enjoy the plugin.
🐛 Report bugs or suggest new features in the discussion or issue tracker.

🔥 Why Use SGLocalTime?

✔ Helps players coordinate events across time zones.
✔ Enhances immersion for roleplay servers.
✔ Improves player experience with simple but powerful placeholders.
✔ 100% free and open to community feedback.

🌟 Bring your players closer together — show them the world’s time in one server!
Download SGLocalTime today and give your server a modern touch! 🚀

SGLocalTime

📖About SGLocalTime