Custom Schedulers

Ticked Scheduler

If you wish to have your own instance of a scheduler you can create an instance of TickedTaskScheduler, this gives you more control over the scheduled tasks.

val scheduler = TickedTaskScheduler()

You control when the scheduler is ticked, you essentially control when tasks will be executed, this may be useful, for example, if you want a scheduler that runs tasks at the start of a tick instead of the end.

val scheduler = TickedTaskScheduler()

GlobalEventHandler.Server.register<ServerTickEvent>(phase = PRE) {
    scheduler.tick()
}

Further having an instance of a TickedTaskScheduler allows you to cancel the scheduled events. We can cancel all the events that are scheduled for a certain tick using the cancel method, or we can cancel all scheduled tasks with cancelAll.

Custom Implementation

If you really want you can implement your own scheduler by implementing the MinecraftTaskScheduler interface. However, it's likely that for almost all cases you are better off using an instance of TickedTaskScheduler.

Temporary Schedulers

You can create a temporary ticked scheduler with a pre-determined lifetime by calling GlobalTickedScheduler.temporaryScheduler(). This scheduler will be automatically ticked for you (and will have the same behaviour as the GlobalTickedScheduler), and will be deleted after the specified lifetime.

val minigame: Minigame = // ...
val duration = 10.Seconds
val scheduler = GlobalTickedScheduler.temporaryScheduler(duration)
minigame.server.launch {
    withContext(scheduler.asCoroutineDispatcher()) {
        minigame.visuals.countdown.transition(duration = duration, players = minigame.players::all)
        minigame.unpause()
    }
}

This may be useful for creating schedulers with brief life-spans where registering your own event handler is too much effort.