# \u26a0 ATTENTION \u26a0
\n(Sep 27, 2025) I found few **major problems with TimeLib** that make it unreliable for certain usecases. Please **read through these carefully** and assess for yourself whether you want to use TimeLib. Once a way is found or added by Mojang to fix these issues, **I will keep supporting TimeLib again**. As of me writing this, **TimeLib v2.3.1** is the latest release.<\/p>\n
**TimeLib is NOT permanently discontinued, it will come back once all is sorted out!**
\nI will post updates to the situation here, as well as the MinecraftCommands Discord server (in #resources).<\/p>\n
## Fundamental (currently) unfixable Problems:
\nBecause of these issues, for TimeLib to keep working as expected, the user would need to **manually** confirm \/ adjust the date **every time the world reloads**. That breaks the point of TimeLib, which is why I need time to think \/ wait until Mojang makes it possible to mitigate these issues.
\n– **\u26a0** If the player head profile (which includes a timestamp) is **older than 24 hours** (which can happen due to caching and cannot be detected), it’s **impossible to automatically detect the date accurately**
\n– **\u26a0** Since 1.21.9, the unix timestamp can only be retrieved from online players, meaning **TimeLib cannot update the date while nobody’s online**, potentially breaking packs that rely on it (Note: It only needs the player to synchronize the date initially. Until the time is desynced, it keeps working even when nobody’s online)
\n– The `PausedTicks` score that contains the number of ticks that the game has been paused\/frozen for only works if at least one player is online from start to finish. If everyone leaves (doesn’t have to be at the same time) while the game is frozen, or nobody was online in the first place, the **stored value in `PausedTicks` is not reliable**
\n – The same problem makes it so **freezing the game for 24h+ makes the day not increment** (because there’s no way to tell how much time has passed if nobody’s online)
\n– Because of daylight savings, the **unix timestamp** (which is expected to increase monotonously) could go backwards by 1h, potentially **breaking packs that necessarily rely on the monotony**. Being unable to detect timezones & daylight savings automatically, this cannot be counteracted without manual player input
\n## Other big known fixable bugs \/ oversights:
\n**I will fix these issues** once I get to them. In the meantime, I put them here so you’re aware of them. While these are not all known issues, these are the major ones.
\n– **\u26a0** An oversight makes it possible under rare circumstances for the date to be 1 day ahead of what it should be
\n– **\u26a0** An oversight prevents the date from incrementing after more than 1 day has passed since the server \/ client was running without reboots
\n– **\u26a0** While the time is incorrect (because it takes a bit to retrieve the necessary data), TimeLib does not indicate that the time is not synchronized yet, potentially breaking packs that try to grab data when it’s not ready
\n# TimeLib
\nA Minecraft Data Pack library that lets you get the real life date & time ingame. For inquiries, please contact **@silicatYT** on Discord.<\/p>\n
Download: Modrinth
\nReport bugs: GitHub<\/p>\n
## Features
\n– Provides the real life date & time with tick accuracy:
\n – Year, Month, Day, Week Day, Hour, Minute, Second & the Unix Timestamp
\n– Provides the current tickrate
\n– Detects pausing the game & the pause duration (e.g. `\/tick freeze` or singleplayer)
\n– Convert any Unix Timestamp into a date & time
\n– Supports different timezones & daylight savings time
\n– Supports lag, different tick rates & pausing
\n– High efficiency<\/p>\n
## How to use
\nTimeLib automatically keeps track of the date & time for you. For that to work, you first need to configure the settings to your personal taste. To access the settings, click the message that appears in chat after reloading, or manually run `\/function timelib:util\/settings`.
\n### → Settings
\n– `Command Block Offset`: This is required to offset the time difference between the UTC timezone and your system time. If daylight savings change, this setting needs to be adjusted to ensure that the date calculation works properly.
\n – **Example:** UTC (7pm), System clock (8pm) → Use 1h
\n– `Timezone Offset`: Use this to change the displayed time.
\n – **Example:** 8pm + 1h offset → 9pm
\n### → Get the real life date & time
\nThe values for Year, Month, Day, Week Day, Hour, Minute, Second & the Unix Timestamp are all stored inside the player `#TimeLib`, with each value having its own scoreboard objective:
\n– `TimeLib.Year, TimeLib.Month, TimeLib.Day, TimeLib.WeekDay, TimeLib.Hour, TimeLib.Minute, TimeLib.Second & TimeLib.UnixTime`<\/p>\n
Additionally, string versions (with leading 0s) of the date and daytime are stored in the `timelib:date` and `timelib:daytime` storages.<\/p>\n
### → Events
\n– `#timelib:date_changed`: Function tag that gets executed whenever the date changes
\n– `#timelib:daytime_changed`: Function tag that gets executed whenever the daytime changes
\n– `#timelib:game_unpaused`: Function tag that gets executed whenever the game unpauses
\n – The `#TimeLib TimeLib.PausedTicks` scoreboard holds the number of ticks the game has been paused for<\/p>\n
### → Get the tickrate
\nThe tickrate updates once per second and can be read from the `TimeLib.Tickrate` scoreboard objective.<\/p>\n
### → Convert any Unix Timestamp into a date & time
\n**Note:** The output date & time are in the UTC timezone, as daylight savings time cannot be properly accounted for.<\/p>\n
– Set the `#TimeLib.Input TimeLib.UnixTime` score as the input.
\n– Run `\/function timelib:util\/unix_timestamp_to_date`.
\n– The output values will be stored inside the `#TimeLib.Output TimeLib.?` scores, as well as the `timelib:output` data storage.<\/p>\n
## How it works
\n– TimeLib combines the with Base64 encoded Unix Timestamp inside player heads with the daytime information inside command block outputs to calculate the current date & time.
\n– To get the tickrate, TimeLib counts the number of ticks between each daytime change.
\n– The pause detection uses the `minecraft.custom:minecraft:total_world_time` scoreboard objective, which increments every tick even while the game is paused.<\/p>\n
Additional logic is used to ensure optimal results, good performance and accuracy.<\/p>\n
## Credit
\nFrom CMDred:
\n– **SilicatYT:** TimeLib
\n– **BananaRedPanda:** Base64 Decoder & Help<\/p>\n
## Good to know
\n– TimeLib requires an internet connection.
\n– Getting the tickrate does not utilize worldborder shenanigans.
\n– If your Data Pack uses a forceloaded chunk at `29999999 29999999` in the overworld, there may be collision.
\n– TimeLib (2.3.0 and newer) uses the lantern load library that lets you check for dependencies. If you follow its conventions:
\n – `#TimeLib load.status`: 1 if TimeLib is installed, otherwise unset
\n – `#TimeLib.Version load.status`: Release-specific number
\n– Upgrade to a newer release:
\n – For TimeLib releases **before 2.3.0**: `\/function timelib:uninstall`, then replace your current TimeLib version with the new one, then `\/reload` to install the new version
\n – For upgrading from **release 2.3.0 or later** to a newer release, simply replace the old datapack with the new one
\n– (v2.3.0+) TimeLib **throws errors and stops working if multiple different releases are installed simultaneously**. This extends to trying to call utility functions.
\n – Similar behaviour occurs when trying to run utility functions after running `\/function timelib:uninstall`<\/p>\n
## License
\nAs per the MIT License, you are allowed to redistribute, modify and use TimeLib as long as we are credited for the original work.<\/p>\n","protected":false},"excerpt":{"rendered":"
Get the real life date & time tick-perfectly and efficiently!<\/p>\n","protected":false},"featured_media":156541,"template":"","meta":{"_minecraft_slug":"timelib","_minecraft_project_id":"zhrv5yZg","_minecraft_author":"SilicatYT","_minecraft_license":"MIT","_minecraft_downloads":3941,"_minecraft_follows":26,"_minecraft_client_side":"optional","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"timelib.zip","_minecraft_size_bytes":372127,"_minecraft_version_count":19,"_minecraft_updated_at":"2026-05-16T01:41:31.692749Z","_minecraft_date_created":"2023-11-22T03:00:37.967918Z","_minecraft_date_modified":"2025-07-28T13:38:43.566122Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/timelib","_minecraft_icon_attachment_id":156541,"_minecraft_imported_at":"2026-06-09T12:36:01+00:00","_minecraft_import_hash":"ab860ca7a68fbf2e8971c2ae541efeba","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[84,873,92],"mod_loader":[86],"minecraft_version":[93,728,94,101,102,62,37,73,74,38,78,79,80,81,724],"class_list":["post-156540","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-datapack","mod_category-library","mod_category-utility","mod_loader-datapack","minecraft_version-1-20-3","minecraft_version-1-20-3-pre3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-23w45a"],"yoast_head":"\n