Compatibility
Minecraft: Java Edition
Platforms
75% of ad revenue goes to creators
Support creators and Modrinth ad-free with Modrinth+Creators
Details
⚠️ 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.
💡 Summary
- Real Calculations, Not Just Tracking
Uses actual calendar formulas to compute the current date on the fly, not just by counting days. Prevents desync and ensures consistency. - Corruption-Resistant and Lag-Proof
If a lag occurs or scoreboards are modified, it self corrects overtime. The displayed information is generated from real time values instead of stored and added upon. - Leap Year & Weekday Accuracy
Includes proper Gregorian leap year logic and computes the weekday using real mathematical formulas. - Highly Stable for Long-Term Use
Built with scoreboard math and minimal function calls that won't drift for real years of gameplay in survival, modded, or multiplayer servers. - Low Resource Usage
Centalized and clean logic means minimal tick impact and zero NBT bloat, even with many players online. - Server & SMP Friendly
Designed to scale across long-term multiplayer worlds and integrate easily with events, lore, or custom commands.
📜 Features
- Real Calendar Replica:
- Tracks dates, months, and years (including leap years) exactly like a genuine calendar.
- For example, April 6th, 2025 in-game will fall on the same weekday as April 6th, 2025 in the real world.
- The system uses real formulas and direct calculations rather than relying on tracking days passing. This means it's highly stable—if anything goes wrong or commands like
/time set
are used, it automatically corrects itself. The current date is calculated on the spot, so the system is corrupt resistant even under heavy lag unless the files or critical scoreboard values themselves are edited.
- Holiday Accuracy:
- Calculates holidays like Easter with exact precision.
- In modern year settings, delivers correct weekdays and leap year details, matching real-world dates.
- Weather & Biome Information:
- Shows the current weather (clear, rain, or thunder).
- In single-player mode, indicates whether you’re in a cold (snowy) or warm (cloudy) biome.
- Daily Announcements:
- A message displays the current date, day count, year, and special events every morning and when you join.
- Features holiday icons and extra details for important dates.
- Display Options:
- Information is shown on a boss bar.
- An optional resource pack can hide the boss bar for a cleaner view.
- Shift and look down to check your current coordinates.
⚙️ Configuration
- For New Worlds:
- Use the config file located in
data/dash.date/function/config.mcfunction
to 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.year
and%display.year
for the year.%ani.month
and%display.month
for the month.%ani.date
and%display.date
for the day.
- After updating these values, run
/function dash.date:update
to 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