TickScheduler API

TickScheduler API

一个用于管理定时调度的库

基础库

TickScheduler 是一个轻量级的模组 Tick 库:

  • 在未来运行代码
  • 每 N 个 tick 重复执行动作
  • 当条件变为真时执行逻辑
  • 在世界重新加载后持久化任务
  • 将繁重工作卸载到异步线程

GitHub 上的完整信息:

你可以用它来:

  • 临时效果
  • 冷却计时器
  • 延迟的世界事件
  • 重复逻辑循环
  • 异步计算
  • 持久化计时器
  • 条件触发的例程
  • 需要精确 tick 控制的模块化系统

命令:

  • /scheduler debug
  • /scheduler profiler on
  • /scheduler profiler off
  • /scheduler profiler stats
  • /scheduler save
  • /scheduler load
  • /scheduler tasks
  • /scheduler test <- 用于测试库

API 类:

SchedulerAPI - 高层调度接口
TickScheduler - 内部引擎
Types - 任务类型、上下文、构建器、优先级
PersistentStorage - 保存和加载持久化任务
ConditionScheduler- 基于条件的逻辑
TaskRegistry - 恢复持久化任务类型

示例:自定义持久化任务

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

持久化任务在世界重新加载后仍然存在。 Profiler 测量已调度任务的实际执行时间。


稍后可能会移植到 NeoForge 和 1.21.1 上……