LogoArcartX Doc
服务端API

SchedulerUtils:调度工具

线程调度扩展工具集

SchedulerUtils

  • 调度工具集提供了 Plugin 的Kotlin扩展函数，简化Bukkit调度器的使用。
  • 位于 priv.seventeen.artist.arcartx.util.SchedulerUtils。

Plugin.run(runnable)

  • 在主线程执行任务
  • 参数：runnable: Runnable — 要执行的任务
  • 返回值：无
  • 调用示例
// Kotlin
plugin.run { player.sendMessage("Hello") }
 
// Java
SchedulerUtils.run(plugin, () -> player.sendMessage("Hello"));

Plugin.runAsync(runnable)

  • 在异步线程执行任务
  • 参数：runnable: Runnable — 要执行的任务
  • 返回值：无
  • 调用示例
SchedulerUtils.runAsync(plugin, () -> {
    // 异步操作，如数据库查询
});

Plugin.runLater(runnable, tick)

  • 在主线程延迟执行任务
  • 参数：
    • runnable: Runnable — 要执行的任务
    • tick: int — 延迟tick数（20tick = 1秒）
  • 返回值：无
  • 调用示例
SchedulerUtils.runLater(plugin, () -> {
    // 1秒后执行
}, 20);

Plugin.runLaterAsync(runnable, tick)

  • 在异步线程延迟执行任务
  • 参数：
    • runnable: Runnable — 要执行的任务
    • tick: int — 延迟tick数
  • 返回值：无
  • 调用示例
SchedulerUtils.runLaterAsync(plugin, () -> {
    // 异步延迟执行
}, 40);

Plugin.ensureMainThread(runnable)

  • 确保任务在主线程执行。如果当前已在主线程则直接执行，否则调度到主线程
  • 参数：runnable: Runnable — 要执行的任务
  • 返回值：无
  • 调用示例
SchedulerUtils.ensureMainThread(plugin, () -> {
    // 保证在主线程执行，适合操作Bukkit API
    entity.teleport(location);
});

Plugin.ensureAsyncThread(runnable)

  • 确保任务在异步线程执行。如果当前已在异步线程则直接执行，否则调度到异步线程
  • 参数：runnable: Runnable — 要执行的任务
  • 返回值：无
  • 调用示例
SchedulerUtils.ensureAsyncThread(plugin, () -> {
    // 保证在异步线程执行，适合IO操作
    saveToDatabase();
});

Previous

EntityUtils:实体工具

Next

ChatUtils:聊天工具

On this page