Skip to main content

Task Scheduling API

warning

This API is copied from PetarLib for Fabric and may not be fully functional in the Bukkit version. The only changes were made are related to logging.

PetarLib provides a task scheduler for running asynchronous tasks or delayed tasks with built-in exception handling and logging.

Overview​

TaskScheduler uses a thread pool to execute tasks asynchronously, catching and logging any exceptions thrown by tasks.

Usage​

Creating a Scheduler​

import com.petarmc.petarlib.task.TaskScheduler;

TaskScheduler scheduler = new TaskScheduler(4); // 4 threads

Running Tasks Asynchronously​

scheduler.runAsync(() -> {
    // Your async task here
    System.out.println("Running in background");
});

Running Delayed Tasks​

scheduler.runDelayed(() -> {
    System.out.println("This runs after 1000ms");
}, 1000); // delay in milliseconds

Shutdown​

scheduler.shutdown(); // shutdown with timeout

Features​

  • Asynchronous execution using a thread pool.
  • Delayed execution with millisecond precision.
  • Automatic exception catching and logging.
  • Graceful shutdown with timeout.