Description
Gallery
Changelog
Versions
⚠️ IMPORTANT: USAGE GUIDELINES If you're planning to use this on a server or modpack, please refer to: https://gamedash43.github.io/dash-mcl-licenses/#usage
This add-on displays in-game time, weather conditions, weekdays, and dates using a day tracker that accurately mirrors real-world dates.
📜 Features
- Real Calendar Replica:
- Tracks days, months, years, leap years, and weekdays exactly like the real world.
- April 6 2025 in-game lands on the same weekday as April 6 2025 IRL.
- The date is recalculated every tick, so
/time setor lag can’t throw it off.
- Holiday Accuracy:
- Calculates movable holidays like Easter, Lunar New Year, and Thanksgiving with the same formulas used in astronomy software.
- Ready-made hooks let addon packs fire events on any holiday.
- Dimension-Aware Bossbars:
- Overworld: standard date + weather summary.
- Nether: distance from entrance portal.
- End: live Elytra flight-time estimate until next repair (Unbreaking factored in).
- Every bar is per-player, so what you see never collides with what your friends see.
- Clock+Sneak Toggle:
- Sneak while looking straight down with a clock to show/hide your bossbar instantly—no commands needed.
- Live Weather, Biome & Light Checks:
- Shows clear/rain/thunder, biome temperature class.
- Daily Announcements:
- At dawn (and on join) you’ll get a one-liner with the full date, total day count, and any holiday emoji.
- Display Options:
- An optional resource-pack skin hides the bossbar frame for players who prefer a minimalist look.
⚙️ Configuration
- For New Worlds:
- Use the config file located in
data/dash.date/function/config.mcfunctionto set your initial dates. Follow the instructions in the file carefully before starting a new world.
- Use the config file located in
- For Existing Worlds:
- Set the dates using the following scoreboard variables (all in the scoreboard
dash.date_arc):%start.yearand%display.yearfor the year.%ani.monthand%display.monthfor the month.%ani.dateand%display.datefor the day.
- After updating these values, run
/function dash.date:updateto let the system self-correct.
- Set the dates using the following scoreboard variables (all in the scoreboard
- Note: Read the instructions in the config file carefully before creating a new world if you plan on modifying it.
- Player Birthday Event:
- Set your birthday for a special event using:
/scoreboard players set @s dash.date_bd.month [birthday month]/scoreboard players set @s dash.date_bd.date [birthday date]
- Set your birthday for a special event using:
🌟 Planned Details
- This add-on was designed as an extremely accurate calendar system base with no extra items added to the game.
- In development is an additional add-on for this pack that will add a placable calender block that displays the current month, date, and upcoming holidays in a vanilla style.
- Future plans include events such as Christmas presents, dynamic Easter egg hunts, and other holiday-themed activities within the add-on for this pack.
❓ FAQ
Explained in nerd terms.
Using division and modulo operations, the datapack converts game ticks into a 12-hour clock while computing the day-of-year by summing monthly offsets and adjusting for leap years using the standard 4-100-400 rule. Weekdays are determined with a variant of Zeller’s Congruence, and the daycounter algorithm calculates an absolute day value by summing full-year contributions (with leap day adjustments) and the current day-of-year before subtracting a defined start date. In addition, Easter is determined using a classical algorithm that applies modulo and floor division operations to compute the correct month and day, and the lunar new year is approximated by offsetting the year from 1900, taking the remainder modulo 19, and mapping that result to a specific day-of-year.
What special events are available?
Special events include:
-
New Year's Eve: Chat message and firework show at midnight (if outdoors).
-
Lunar New Year: Fireflies appear on join and wake up.
-
Valentine's Day: Hearts appear when you join and wake up.
-
St Patrick's Day: Green particles appear when you join and wake up.
-
Easter: Green and White particles appear when you join and wake up.
-
Thanksgiving: Autumn leaves appear on join and wake up.
-
Winter Holidays: Snow appears when you join/wake up.
-
Birthday: Happy birthday song and message to all players.
-
World Anniversary: Firework show and commemorative message on the world's creation date. Other events, like New Year's Day and April Fools, are planned for future updates.
Spoiler
- Halloween: A random jumpscare during the day.
Does this add-on track real-world time?
No, it uses an in-game day tracker based on real-world calendar logic.Can I hide the boss bar?
Yes, you can use the optional resource pack to hide the boss bar and display text at the top of the screen.How do I set up the birthday event? 🎂
Use the commands provided to set your birthday:
- Set the month:
/scoreboard players set @s dash.date_bd.month [birthday month] - Set the date:
/scoreboard players set @s dash.date_bd.date [birthday date]
Each player will then receive a special birthday event.
How do I uninstall this add-on?
Just run the command /function dash.date:uninstall.
I'm updating from an old version. What do I need to do?
If you're updating from a previous version, you must set the start year with this command:
/scoreboard players set %start.year 0 and /function dash.date:update
How to Install Date Time Display (Datapack)
Date Time Display by okdashi is verified for Datapack, Fabric, Forge, Neoforge, Quilt across Minecraft versions 1.21.11, 1.21.5, 1.21.9, 26.1 (latest release: 3.4+mod, file size: 704 KB). Follow the steps below to install it safely from ModCraft.tv:
- Click the Download button above and select your Minecraft version (1.21.11, 1.21.5, 1.21.9, 26.1) and platform (Datapack, Fabric, Forge, Neoforge, Quilt).
- Make sure you have the compatible loader or environment installed for Datapack, Fabric, Forge, Neoforge, Quilt.
- Move the downloaded Date Time Display file into your Minecraft
.minecraft/saves/<world>/datapacksfolder and launch the game.
All Versions
+ Add Version
[3.4+mod] Date Time Display 3.4
by okdashi on Mar 25, 2026
Download
Updated to 26.1
[3.4] Date Time Display 3.4
by okdashi on Mar 25, 2026
Download
Updated to 26.1
[3.3+mod] Date Time Display 3.3
by okdashi on Jan 19, 2026
Download
### Update 3.3
#### Updated
- Updated to 1.21.11
- Changed nether and end bars to appear cleaner (you can look at it in the gallery)
- Both use icons now
- 🎨 Big thanks to [FoxPlane on YouTube](https://www.youtube.com/channel/UCEwj6ZW1LCkujOBG7lvTHIg) for the textures!
#### Required
- Resource pack is now required
[3.3] Date Time Display 3.3
by okdashi on Jan 19, 2026
Download
### Update 3.3
#### Updated
- Updated to 1.21.11
- Changed nether and end bars to appear cleaner (you can look at it in the gallery)
- Both use icons now
- 🎨 Big thanks to [FoxPlane on YouTube](https://www.youtube.com/channel/UCEwj6ZW1LCkujOBG7lvTHIg) for the textures!
#### Required
- Resource pack is now required
[3.2+mod] Version 3.2
by okdashi on Oct 01, 2025
Download
# Updated to 1.21.9
[3.2] Version 3.2
by okdashi on Oct 01, 2025
Download
# Updated to 1.21.9
[3.1+mod] Version 3.1
by okdashi on May 11, 2025
Download
# 🌙 Update 3.1 Changelog
## ✨ New Features
## 🛠️ Fixes
## 🔮 Upcoming
## ✨ New Features
- Moon phase display now shows at night.
- Automatic minor updates no longer require running
/function dash.date:update. That function is now reserved for major version transitions. - New function tag for addon developers and server owners, with compatibility for a future official addon.
- Firework events now use **truly random fireworks** instead of a preset list — resulting in over **2 million** visually unique combinations.
- New emoji textures available when using the resource pack.
## 🛠️ Fixes
- Fixed all holidays not occurring, except for Thanksgiving.
- Fixed Nether portal coordinates only saving the first portal entered.
- Fixed old bossbars persisting after updates if
/function dash.date:updatewasn't run. - Fixed ghost bossbars when usernames change — now only valid ones remain.
## 🔮 Upcoming
- Lunar New Year calculations will be reworked to be less realistic and more immersive.
[3.1] Version 3.1
by okdashi on May 11, 2025
Download
# 🌙 Update 3.1 Changelog
## ✨ New Features
## 🛠️ Fixes
## 🔮 Upcoming
## ✨ New Features
- Moon phase display now shows at night.
- Automatic minor updates no longer require running
/function dash.date:update. That function is now reserved for major version transitions. - New function tag for addon developers and server owners, with compatibility for a future official addon.
- Firework events now use **truly random fireworks** instead of a preset list — resulting in over **2 million** visually unique combinations.
- New emoji textures available when using the resource pack.
## 🛠️ Fixes
- Fixed all holidays not occurring, except for Thanksgiving.
- Fixed Nether portal coordinates only saving the first portal entered.
- Fixed old bossbars persisting after updates if
/function dash.date:updatewasn't run. - Fixed ghost bossbars when usernames change — now only valid ones remain.
## 🔮 Upcoming
- Lunar New Year calculations will be reworked to be less realistic and more immersive.
[3.0+mod] The Real Full Release - Version 3.0
by okdashi on Apr 28, 2025
Download
## ⚠️ Disclaimer
This version has **two known major issues** and **one known minor issue**:
Fixes for all of these are in progress.
<details>
<summary>Changelog</summary>
## [3.0] - 🎉 Major Overhaul 🎉
✨ **New Features & Improvements**
1. 🆕 **Per-Player Bossbars**: Switched from a single global bar to individual
2. 🕹️ **Bossbar Toggle**: Sneak-looking down while holding a clock will hide your personal bossbar.
3. 🌋 **Unique Nether Display**: In the Nether, see your current XYZ coords, distance from your entrance portal, and the Day Count—all in one neat bossbar.
4. 🪐 **Dynamic End Display**: In the End, view your coords + Day Count by default. If you’re wearing an Elytra, it auto-switches to show remaining flight time (in seconds)!
5. 🌧️ **Accurate Weather**: Condition checks are now per-player—so you’ll get real-time snow, rain, or overcast indicators even on busy multiplayer servers.
6. 🧹 **Rock-Solid Uninstall**: The
7. 🔌 **Addon Compatibility**: Fully namespaced
</details>
This version has **two known major issues** and **one known minor issue**:
- Nether portals** only save the initial entrance point.
- Updating** from an old version does not immediately remove the old bossbar — players must run
/function dash.date:updateonce after updating. - Minor issue**: Extra bossbars may appear if a player **changes their username**.
Fixes for all of these are in progress.
<details>
<summary>Changelog</summary>
## [3.0] - 🎉 Major Overhaul 🎉
✨ **New Features & Improvements**
1. 🆕 **Per-Player Bossbars**: Switched from a single global bar to individual
dash.date_$(bossbar_id) bars—unlocking all the powerful new display logic below.2. 🕹️ **Bossbar Toggle**: Sneak-looking down while holding a clock will hide your personal bossbar.
3. 🌋 **Unique Nether Display**: In the Nether, see your current XYZ coords, distance from your entrance portal, and the Day Count—all in one neat bossbar.
4. 🪐 **Dynamic End Display**: In the End, view your coords + Day Count by default. If you’re wearing an Elytra, it auto-switches to show remaining flight time (in seconds)!
5. 🌧️ **Accurate Weather**: Condition checks are now per-player—so you’ll get real-time snow, rain, or overcast indicators even on busy multiplayer servers.
6. 🧹 **Rock-Solid Uninstall**: The
uninstall function now wipes every bossbar, tag, storage entry, and scoreboard objective—leaving zero trace of the datapack.7. 🔌 **Addon Compatibility**: Fully namespaced
dash.date/tags/function hooks (e.g. day_change, valentines) and an installation flag (dash.date_installed) enable seamless integration with official or third-party addons.</details>
[3.0] The Real Full Release - Version 3.0
by okdashi on Apr 28, 2025
Download
## ⚠️ Disclaimer
This version has **two known major issues** and **one known minor issue**:
Fixes for all of these are in progress.
<details>
<summary>Changelog</summary>
## [3.0] - 🎉 Major Overhaul 🎉
✨ **New Features & Improvements**
1. 🆕 **Per-Player Bossbars**: Switched from a single global bar to individual
2. 🕹️ **Bossbar Toggle**: Sneak-looking down while holding a clock will hide your personal bossbar.
3. 🌋 **Unique Nether Display**: In the Nether, see your current XYZ coords, distance from your entrance portal, and the Day Count—all in one neat bossbar.
4. 🪐 **Dynamic End Display**: In the End, view your coords + Day Count by default. If you’re wearing an Elytra, it auto-switches to show remaining flight time (in seconds)!
5. 🌧️ **Accurate Weather**: Condition checks are now per-player—so you’ll get real-time snow, rain, or overcast indicators even on busy multiplayer servers.
6. 🧹 **Rock-Solid Uninstall**: The
7. 🔌 **Addon Compatibility**: Fully namespaced
</details>
This version has **two known major issues** and **one known minor issue**:
- Nether portals** only save the initial entrance point.
- Updating** from an old version does not immediately remove the old bossbar — players must run
/function dash.date:updateonce after updating. - Minor issue**: Extra bossbars may appear if a player **changes their username**.
Fixes for all of these are in progress.
<details>
<summary>Changelog</summary>
## [3.0] - 🎉 Major Overhaul 🎉
✨ **New Features & Improvements**
1. 🆕 **Per-Player Bossbars**: Switched from a single global bar to individual
dash.date_$(bossbar_id) bars—unlocking all the powerful new display logic below.2. 🕹️ **Bossbar Toggle**: Sneak-looking down while holding a clock will hide your personal bossbar.
3. 🌋 **Unique Nether Display**: In the Nether, see your current XYZ coords, distance from your entrance portal, and the Day Count—all in one neat bossbar.
4. 🪐 **Dynamic End Display**: In the End, view your coords + Day Count by default. If you’re wearing an Elytra, it auto-switches to show remaining flight time (in seconds)!
5. 🌧️ **Accurate Weather**: Condition checks are now per-player—so you’ll get real-time snow, rain, or overcast indicators even on busy multiplayer servers.
6. 🧹 **Rock-Solid Uninstall**: The
uninstall function now wipes every bossbar, tag, storage entry, and scoreboard objective—leaving zero trace of the datapack.7. 🔌 **Addon Compatibility**: Fully namespaced
dash.date/tags/function hooks (e.g. day_change, valentines) and an installation flag (dash.date_installed) enable seamless integration with official or third-party addons.</details>
[2.0+mod] Version 2.0 (Full Release)
by okdashi on Apr 08, 2025
Download
# Full Release V2.0
## 1. Math Functions Overhaul
## 2. New Config System
## 3. New Holidays
## 4. Time Formula Optimization
## 5. License Change
## 1. Math Functions Overhaul
- Switched from unstable subsequent calculations to a cumulative/direct method for day, weekday, and leap year calculations.
- Weekday calculations now use a modern system; dates after 1800 won't match historical calendars. Use the new config file for accurate date counting by setting the year to a modern year.
- Important:** **If updating from an old version, you must set the start year with
/scoreboard players set %start.year dash.date_arc [year (likely 0)].** (Join Discord for support.)
## 2. New Config System
- Added a config system in
data/dash.date/function/config.mcfunction. - Set the start date using scoreboard variables:
%start.yearand%display.yearfor the year.%ani.monthand%display.monthfor the month.%ani.dateand%display.datefor the day.- After configuration, run
/function dash.date:updateto let the system self-correct.
## 3. New Holidays
- Added Lunar New Year, Easter, and St. Patrick's Day.
- Easter is calculated exactly (accurate for years after 1800). Lunar New Year is approximated (accurate within 0–3 days, more precise near 1900).
- Each holiday features unique tunes and particle effects.
## 4. Time Formula Optimization
- Updated the time calculation formulas to be more modern, easier to understand, and more efficient.
## 5. License Change
- Changed the license from **Dash MCL Open 1.0** to **Dash MCL ND 1.0** due to the implementation of novel algorithms.
- (Old versions remain under the previous license.)
[2.0] Version 2.0 (Full Release)
by okdashi on Apr 08, 2025
Download
# Full Release V2.0
## 1. Math Functions Overhaul
## 2. New Config System
## 3. New Holidays
## 4. Time Formula Optimization
## 5. License Change
## 1. Math Functions Overhaul
- Switched from unstable subsequent calculations to a cumulative/direct method for day, weekday, and leap year calculations.
- Weekday calculations now use a modern system; dates after 1800 won't match historical calendars. Use the new config file for accurate date counting by setting the year to a modern year.
- Important:** **If updating from an old version, you must set the start year with
/scoreboard players set %start.year dash.date_arc [year (likely 0)].** (Join Discord for support.)
## 2. New Config System
- Added a config system in
data/dash.date/function/config.mcfunction. - Set the start date using scoreboard variables:
%start.yearand%display.yearfor the year.%ani.monthand%display.monthfor the month.%ani.dateand%display.datefor the day.- After configuration, run
/function dash.date:updateto let the system self-correct.
## 3. New Holidays
- Added Lunar New Year, Easter, and St. Patrick's Day.
- Easter is calculated exactly (accurate for years after 1800). Lunar New Year is approximated (accurate within 0–3 days, more precise near 1900).
- Each holiday features unique tunes and particle effects.
## 4. Time Formula Optimization
- Updated the time calculation formulas to be more modern, easier to understand, and more efficient.
## 5. License Change
- Changed the license from **Dash MCL Open 1.0** to **Dash MCL ND 1.0** due to the implementation of novel algorithms.
- (Old versions remain under the previous license.)
[1.2+mod] Beta Release 1.2
by okdashi on Apr 07, 2025
Download
## 🚀 Features
- Stability Improvements:**
- Cleanup Command:**
/function dash.date:update to remove unnecessary forceloaded chunks and markers.- Upcoming Release:**
## 🐞 Bug Fixes
- Anniversary Date Fix:**
[1.2] Beta Release 1.2
by okdashi on Apr 07, 2025
Download
## 🚀 Features
- Stability Improvements:**
- Cleanup Command:**
/function dash.date:update to remove unnecessary forceloaded chunks and markers.- Upcoming Release:**
## 🐞 Bug Fixes
- Anniversary Date Fix:**
[1.1+mod] Beta Release 1.1
by okdashi on Apr 05, 2025
Download
# 📝 Beta Release 1.1
## 🚀 New Features
## 🐞 Bug Fixes
## 🚀 New Features
- Thanksgiving Event:** Added a special event for Thanksgiving.
- Holiday Tunes:** Introduced new tunes/songs for Winter Holidays, Valentine's Day, Thanksgiving, and New Year's Eve.
- Message Cleanup:** Removed line separator messages for holidays to improve clarity.
- Code Refinement:** Eliminated redundancies.
## 🐞 Bug Fixes
- Command Stability:** Improved the stability of setting world spawn (still not recommended for regular use).
