TickScheduler API
by avacuoss
TickScheduler API is a Forge library that lets other mods run code after a set number of ticks, on a repeating interval, or once a condition holds.
What it does
Mod developers call the library to schedule tasks that run later in the game. A task can execute once after a delay, repeat every N ticks, wait until a condition becomes true, or be handed to background threads so heavy work does not stall the main loop. Tasks can also be saved and reloaded, so they continue after a world is closed and opened again.
The library covers common timing needs such as temporary effects, cooldown timers and delayed world events, and it includes an in-game scheduler profiler that measures the real execution time of scheduled tasks. Commands for debugging, saving, loading and listing tasks are available for testing. The mod is open source under the MIT License, with its source code published publicly.
Files are published for Forge 1.20.1 only, with 0.0.53 as the latest build, released in the beta channel on 2026-01-04. The mod was first published on 2025-12-06. Every player and the server need a copy of the mod.
Key features
Delayed and repeating tasks
Code can be queued to run after a number of ticks or repeated at a fixed tick interval.
Conditional execution
A task can wait and run only when a chosen logic condition becomes true.
Persistent tasks
Scheduled tasks survive world reloads, so timers and events resume where they stopped.
Asynchronous offloading
Heavy work can be moved to background threads to keep the game responsive.
Scheduler profiler
A profiler measures the real execution time of scheduled tasks, with on, off and stats subcommands.
Gallery
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Use cases
Cooldowns and temporary effects
A mod can use the scheduler to end a status effect or reset an ability after a given number of ticks.
Delayed world events
Events such as timed spawns or scheduled changes in the world can be queued and survive a restart.
Who it’s for: Mod developers building features that depend on timing, delays or background work. Server owners running mods that depend on it need it on the server as well as on each client.
Questions
Does TickScheduler API have to be installed on both sides?
Which loader and game version does TickScheduler API support?
Do scheduled tasks survive a restart?
Can players see how long scheduled tasks take?
In the catalog
TickScheduler API is one of 3,514 Library mods on ModsFinder, and one of 1,576 Library mods for Forge. 34,764 mods support Minecraft 1.20.1.
More from avacuoss
Similar mods
What the author says
Commands: - /scheduler debug - /scheduler profiler on - /scheduler profiler off - /scheduler profiler stats - /scheduler save - /scheduler load - /scheduler tasks - /scheduler test <- for test lib Persistent tasks survive world reloads. Profiler measures real execution time of scheduled tasks.
Official listing
- Modrinth page
- modrinth.com/mod/tickscheduler-api
- Owner
- avacuoss
- Published
- 2025-12-06
- Updated on Modrinth
- 2026-01-04
- Facts verified
- 2026-10-15