promotional bannermobile promotional banner

TickScheduler API

A library for managing tick scheduling

TickScheduler is a lightweight tick library for mods:

  • run code in the future
  • repeat actions every N ticks
  • execute logic when conditions become true
  • persist tasks across world reloads
  • offload heavy work to async threads

FULL INFO ON GITHUB:

You can use it to:

  • temporary effects
  • cooldown timers
  • delayed world events
  • repeating logic loops
  • async computations
  • persistent timers
  • condition-triggered routines
  • modular systems requiring precise tick control

Commands:

  • /scheduler debug
  • /scheduler profiler on
  • /scheduler profiler off
  • /scheduler profiler stats
  • /scheduler save
  • /scheduler load
  • /scheduler tasks
  • /scheduler test

API classes:

  • SchedulerAPI - High-level scheduling interface
  • TickScheduler - Internal engine Types - Task types, context, builder, priorities
  • PersistentStorage - Save & load persistent tasks ConditionScheduler- Condition-based logic
  • TaskRegistry - Restore persistent task types

Example: Custom persistent task

SchedulerAPI.builder() .delay(60) .repeat(10) .maxRuns(5) .priority(Types.Priority.HIGH) .persistent() .type("regenerate") .submit(ctx -> { System.out.println("Regenerating at " + ctx.tick); });

Persistent tasks survive world reloads

Profiler measures real execution time of scheduled tasks

Port on NeoForge and on 1.21.1 later maybe…

The TickScheduler API Team

profile avatar
  • 3
    Projects
  • 291
    Downloads

More from Avacuoss

  • NoLeaks project image

    NoLeaks

    • 7
    • Mods

    Client-side privacy mod that hides coordinates, chunk/block data and other meta information

    • 7
    • June 12, 2026
    • Mods
    • +2
  • Route Relic project image

    Route Relic

    • 234
    • Mods

    Tracks your movement and lets you save and visualize routes on maps

    • 234
    • April 26, 2026
    • Mods
  • NoLeaks project image

    NoLeaks

    • 7
    • Mods

    Client-side privacy mod that hides coordinates, chunk/block data and other meta information

    • 7
    • June 12, 2026
    • Mods
    • +2
  • Route Relic project image

    Route Relic

    • 234
    • Mods

    Tracks your movement and lets you save and visualize routes on maps

    • 234
    • April 26, 2026
    • Mods