Compatibility
Minecraft: Java Edition
Platforms
Creators
Details
🌎 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
pluginsfolder. - Make sure you have PlaceholderAPI installed.
- Start or reload your server.
- Customize
config.ymlfor formats andmessages.ymlfor 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! 🚀



