\u26a0\ufe0f IMPORTANT: USAGE GUIDELINES
\nIf you’re planning to use this on a server or modpack,
\nplease refer to:
\nhttps:\/\/gamedash43.github.io\/dash-mcl-licenses\/#usage<\/p>\n
<\/p>\n
This add-on displays in-game time, weather conditions, weekdays, and dates using a day tracker that accurately mirrors real-world dates.<\/p>\n
## \ud83d\udcdc Features<\/p>\n
– **Real Calendar Replica:**
\n – Tracks days, months, years, leap years, and weekdays exactly like the real world.
\n – April 6 2025 in-game lands on the same weekday as April 6 2025 IRL.
\n – The date is recalculated every tick, so `\/time set` or lag can\u2019t throw it off.
\n– **Holiday Accuracy:**
\n – Calculates movable holidays like Easter, Lunar New Year, and Thanksgiving with the same formulas used in astronomy software.
\n – Ready-made hooks let addon packs fire events on any holiday.
\n– **Dimension-Aware Bossbars:**
\n – **Overworld:** standard date + weather summary.
\n – **Nether:** distance from entrance portal.
\n – **End:** live Elytra flight-time estimate until next repair (Unbreaking factored in).
\n – Every bar is per-player, so what you see never collides with what your friends see.
\n– **Clock+Sneak Toggle:**
\n – Sneak while looking straight down with a clock to show\/hide your bossbar instantly\u2014no commands needed.
\n– **Live Weather, Biome & Light Checks:**
\n – Shows clear\/rain\/thunder, biome temperature class.
\n– **Daily Announcements:**
\n – At dawn (and on join) you\u2019ll get a one-liner with the full date, total day count, and any holiday emoji.
\n– **Display Options:**
\n – An optional resource-pack skin hides the bossbar frame for players who prefer a minimalist look. <\/p>\n
## \u2699\ufe0f Configuration
\n– **For New Worlds:**
\n – 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.
\n– **For Existing Worlds:**
\n – Set the dates using the following scoreboard variables (all in the scoreboard `dash.date_arc`):
\n – `%start.year` and `%display.year` for the year.
\n – `%ani.month` and `%display.month` for the month.
\n – `%ani.date` and `%display.date` for the day.
\n – After updating these values, run `\/function dash.date:update` to let the system self-correct.
\n– **Note:** Read the instructions in the config file carefully before creating a new world if you plan on modifying it.
\n– **Player Birthday Event:**
\n – Set your birthday for a special event using:
\n – `\/scoreboard players set @s dash.date_bd.month [birthday month]`
\n – `\/scoreboard players set @s dash.date_bd.date [birthday date]`<\/p>\n
## \ud83c\udf1f Planned Details<\/p>\n
– This add-on was designed as an extremely accurate calendar system base with no extra items added to the game.
\n– 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.
\n– Future plans include events such as Christmas presents, dynamic Easter egg hunts, and other holiday-themed activities within the add-on for this pack.<\/p>\n
## \u2753 FAQ<\/p>\n 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\u2019s 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.<\/p>\n<\/details>\n Special events include: – **Halloween:** A random jumpscare during the day.<\/p>\n<\/details>\n<\/details>\n No, it uses an in-game day tracker based on real-world calendar logic. Yes, you can use the optional resource pack to hide the boss bar and display text at the top of the screen. Use the commands provided to set your birthday: Just run the command `\/function dash.date:uninstall`.<\/p>\n<\/details>\n If you’re updating from a previous version, **you must set the start year** with this command: Shows the in-game date, time, and weekday at the top of the screen!<\/p>\n","protected":false},"featured_media":54525,"template":"","meta":{"_minecraft_slug":"datetime-display","_minecraft_project_id":"Z5Qum2EN","_minecraft_author":"okdashi","_minecraft_license":"LicenseRef-Dash-MCL-ND-1.0","_minecraft_downloads":4048,"_minecraft_follows":26,"_minecraft_client_side":"optional","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"datetime-display.zip","_minecraft_size_bytes":8769089,"_minecraft_version_count":27,"_minecraft_updated_at":"2026-05-16T01:40:13.342237Z","_minecraft_date_created":"2025-04-03T04:46:53.032555Z","_minecraft_date_modified":"2026-03-25T20:33:40.568923Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/datetime-display","_minecraft_icon_attachment_id":54525,"_minecraft_imported_at":"2026-06-03T00:57:28+00:00","_minecraft_import_hash":"ecb6a994de60e491125dcae8d2e86a98","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[84,156,97,104,158,98,867,92],"mod_loader":[86,99,106,160,100],"minecraft_version":[41,78,82,83],"class_list":["post-54524","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-datapack","mod_category-decoration","mod_category-fabric","mod_category-forge","mod_category-neoforge","mod_category-quilt","mod_category-social","mod_category-utility","mod_loader-datapack","mod_loader-fabric","mod_loader-forge","mod_loader-neoforge","mod_loader-quilt","minecraft_version-1-21-11","minecraft_version-1-21-5","minecraft_version-1-21-9","minecraft_version-26-1"],"yoast_head":"\nExplained in nerd terms.<\/summary>\n
What special events are available?<\/summary>\n
\n– **New Year’s Eve:** Chat message and firework show at midnight (if outdoors).
\n– **Lunar New Year:** Fireflies appear on join and wake up.
\n– **Valentine’s Day:** Hearts appear when you join and wake up.
\n– **St Patrick’s Day:** Green particles appear when you join and wake up.
\n– **Easter:** Green and White particles appear when you join and wake up.
\n– **Thanksgiving:** Autumn leaves appear on join and wake up.
\n– **Winter Holidays:** Snow appears when you join\/wake up.
\n– **Birthday:** Happy birthday song and message to all players.
\n– **World Anniversary:** Firework show and commemorative message on the world’s creation date.
\nOther events, like New Year’s Day and April Fools, are planned for future updates.<\/p>\nSpoiler<\/summary>\n
Does this add-on track real-world time?<\/summary>\n
\n<\/details>\nCan I hide the boss bar?<\/summary>\n
\n<\/details>\nHow do I set up the birthday event? \ud83c\udf82<\/summary>\n
\n– Set the month: `\/scoreboard players set @s dash.date_bd.month [birthday month]`
\n– Set the date: `\/scoreboard players set @s dash.date_bd.date [birthday date]`
\nEach player will then receive a special birthday event.<\/p>\n<\/details>\nHow do I uninstall this add-on?<\/summary>\n
I’m updating from an old version. What do I need to do?<\/summary>\n
\n`\/scoreboard players set %start.year 0` and `\/function dash.date:update`<\/p>\n<\/details>\n","protected":false},"excerpt":{"rendered":"