Mods
Resource Packs
Data Packs
Modpacks
Shaders
Plugins
Mods Resource Packs Data Packs Plugins Shaders Modpacks
Get Modrinth App Upgrade to Modrinth+
Sign in
ModsPluginsData PacksShadersResource PacksModpacks
Sign in
Settings
TimeLib

TimeLib

Get the real life date & time tick-perfectly and efficiently!

2,869
26
Library
Utility
TimeLib has been archived. TimeLib will not receive any further updates unless the author decides to unarchive the project.
AboutGalleryChangelogVersions

TimeLib v2.3.1

by SilicatYT on Jul 28, 2025
Download

TimeLib v.2.3.1

by SilicatYT on Jul 28, 2025
Download

Bugfixes:

  • Fixed a bug that caused TimeLib not to work at all (A typo when trying to call the tick function)

TimeLib v2.3.0

by SilicatYT on Jul 26, 2025
Download

TimeLib v2.3.0

by SilicatYT on Jul 26, 2025
Download

IMPORTANT NOTICE

Despite being declared as Lantern Load compatible, that had not been the case in older releases. From now on, you can use the Lantern Load conventions to check whether TimeLib is installed and what version. Details in the changelog below.

Additions:

  • Added Lantern Load compatibility
    • If you follow the conventions, you can check whether TimeLib is installed (#TimeLib load.status is 1) and what version (Check #TimeLib.Version load.status)
    • You can also specifically check if multiple incompatible versions of TimeLib are installed at the same time (#TimeLib.VersionError load.status is 1)
    • The #TimeLib.Version load.status version is now 1
  • TimeLib now stops functioning and throws errors if multiple incompatible versions are installed simultaneously
    • This extends to the utility functions, which will fail
  • TimeLib now stops functioning and throws errors upon executing utility functions if it has been uninstalled by running the timelib:uninstall function

(!) The version compatibility checks are not compatible with releases 2.2.0 and earlier.

(!) To counteract potential problems with datapacks trying to access TimeLib while it's uninstalled (before upgrading to a newer release), future releases of TimeLib will provide an "upgrade" feature that automatically detects what version was installed prior. Because this depends on the newly implemented version feature, it will only work with releases 2.3.0 and newer.

TimeLib v2.2.0

by SilicatYT on Jun 12, 2025
Download

TimeLib v2.2.0

by SilicatYT on Jun 12, 2025
Download

âš  BREAKING CHANGES

This version contains breaking changes. Make sure you uninstall the previous version and check if the breaking changes affect your datapack.

Breaking changes:

  • Renamed #TimeLib TimeLib.PausedTicks to #TimeLib.PausedTicks TimeLib

Additions:

  • During the date_changed event, the number of days that have passed can be retrieved from #TimeLib.PassedDays TimeLib
  • During the daytime_changed event, the number of seconds that have passed (not capped to a single day) can be retrieved from #TimeLib.PassedSeconds TimeLib

TimeLib v2.1.0

by SilicatYT on Apr 19, 2025
Download

TimeLib v2.1.0

by SilicatYT on Apr 19, 2025
Download

âš  BREAKING CHANGES

This version contains breaking changes. Make sure you uninstall the previous version and check if the breaking changes affect your datapack.

Breaking changes:

  • Changed the data structure of timelib:date and timelib:output

Additions:

  • The tickrate can now be retrieved from the TimeLib.Tickrate scoreboard
  • Added a game_unpaused function tag that runs whenever the game is unpaused (from singleplayer or /tick unfreeze)
    • You can get the number of paused ticks from the TimeLib.PausedTicks scoreboard

Changes:

  • timelib:output now contains the daytime as well
  • timelib:output and timelib:date now additionally contain a stringified form of the month with leading zeros
  • Added more information regarding leftover data in the uninstall function
  • Changed some tellraw formatting

Bugfixes:

  • Fixed a wrong comment in the "How to" section of unix_timestamp_to_date

TimeLib v2.0.0

by SilicatYT on Apr 18, 2025
Download

TimeLib v2.0.0

by SilicatYT on Apr 18, 2025
Download

âš  COMPLETE REWRITE

This version is not compatible with previous ones. Make sure you uninstall the previous version.

Changes:

  • TimeLib now natively supports lag, different tick rates & pausing due to refreshing the time every tick
    • The RealtimeTracking and SavingsTimeChecks settings have been removed
  • Added a timelib:daytime data storage containing stringified versions (with leading 0s) of the daytime
  • Added event tags for #timelib:date_changed and #timelib:daytime_changed which get called whenever the date or daytime changes respectively
    • The #timelib:time_updated event tag has been removed
    • They do not get called on datapack reloads
  • The get_date utility has been renamed to unix_timestamp_to_date
    • It now fails if the input is invalid
    • The unix timestamp is now correctly in the UTC timezone
  • Rewrote the setting descriptions
  • Removed the compatibility issue with the Constant scoreboard objective
  • Moved the forceloaded blocks outside the world border to prevent survival interference
  • Various optimizations and improvements

Bugfixes:

  • Fixed 1.21.5 not working properly (TimeLib v1.3.0)
  • Fixed a short time desync on first join
  • Fixed TimeLib giving the wrong time on first load

TimeLib v1.3.1

by SilicatYT on Apr 6, 2025
Download

Bugfixes:

  • Fixed the init function not loading properly, causing the Data Pack to break in 1.21-1.21.4

Note: This release is equivalent to v1.3.0, please refer to that version's changelog.

TimeLib v1.3.0 (Not working)

by SilicatYT on Mar 27, 2025
Download

TimeLib v1.3.0 (Use 1.3.1 instead)

by SilicatYT on Mar 27, 2025
Download

BREAKING CHANGES

This version contains a breaking change. Make sure to run the uninstall function if you have an older version installed, so that the data storage is updated properly.

Additions:

  • Added a link to the Modrinth and GitHub pages on reload

Changes:

  • Reduced the filesize and data storage size (Breaking)
  • The day in the data storages is now always stored as a string
  • Fixed the version number in the tellraw commands

TimeLib v1.2.1

by SilicatYT on Oct 10, 2024
Download

Additions:

  • Added a new data storage (timelib:output) that contains additional output for "util/get_date":
    • Day value as a string, with 0 prefix
    • WeekDay String (Long & Short)
    • Month String (Long & Short)

Changes:

  • Improved the "util/get_date" description
  • The day in the data storages is now always stored as a string

TimeLib v1.2.0

by SilicatYT on Jul 31, 2024
Download

Additions:

  • Added a new data storage (timelib:date) that contains:
    • Day value as a string, with 0 prefix
    • WeekDay String (Long & Short)
    • Month String (Long & Short)
  • Added a new function tag (#timelib:time_updated) that gets run whenever timelib updated the time or the date changes
  • Added a new setting to disable the reload messages

Changes:

  • Moved the "load" and "init" functions to the zprivate folder to make it clear they're not meant to be run by users

TimeLib v1.1.4

by SilicatYT on Jun 11, 2024
Download
  • Updated to 1.21

TimeLib v1.1.4

by SilicatYT on Apr 23, 2024
Download
  • Updated to 1.20.5 & Item Components (Not backwards compatible!)
  • TimeLib now refreshes as soon as it can, instead of after 1 second when reloading
  • Fixed a bug where reloading shortly before a second, minute or hour passed would desync the timer for a moment
  • Made the command in the command blocks shorter
  • Added "minecraft:" prefix where possible for consistency

TimeLib v1.1.3

by SilicatYT on Dec 24, 2023
Download

Bugfixes:

  • Fixed a logic error in the Timezone Offset that made it impossible to go backwards on the date
  • The same error prohibited timezone offsets from being bigger than 24h, or smaller than -24h

TimeLib v1.1.2

by SilicatYT on Dec 23, 2023
Download

Bugfixes:

  • Fixed Timezone Offset not working properly when set to a negative value

TimeLib v1.1.1

by SilicatYT on Dec 23, 2023
Download

Bugfixes:

  • Fixed Timezone Offset not working properly
1
2

90% of ad revenue goes to creators

Support creators and Modrinth ad-free with Modrinth+
Filter

Show all versions

Modrinth is open source.

main@a0bd011

© Rinth, Inc.

Company

TermsPrivacyRulesCareers

Resources

SupportBlogDocsStatus

Interact

Discord X (Twitter) Mastodon Crowdin
Get Modrinth App Settings
NOT AN OFFICIAL MINECRAFT SERVICE. NOT APPROVED BY OR ASSOCIATED WITH MOJANG OR MICROSOFT.