二次开发 工具 脚本 Skript-Folia 🍃兼容Folia [1.19.4~1.21.11] 2.15.0

简介​

这是 Skript 2.15.0 的 Folia 兼容修改版。原版 Skript 使用 Bukkit 传统调度器，在 Folia 服务端上会抛出 UnsupportedOperationException 异常。本版本通过封装调度器 API，实现了对 Folia 多线程架构的兼容。

兼容性​

• Folia 1.19.4 - 1.21.x
• Luminol、Leaf 等 Folia 分支
• 同时保持对 Paper/Spigot 的向后兼容

主要修改​

1. 新增 FoliaScheduler 调度器封装类，自动检测服务端类型并使用对应的调度 API
2. 修改核心任务调度逻辑（Task、Delay、AsyncEffect 等）
3. 修改事件处理相关代码（EvtAtTime、EvtPeriodical、EvtScript 等）
4. 修改方块状态处理类（BlockStateBlock、DelayedChangeBlock）
5. 修复 Folia 要求延迟至少为 1 tick 的问题

已知限制​

• 部分第三方 Skript 插件附属（addons）如果直接调用 Bukkit.getScheduler() 仍会报错
• 某些边缘功能可能未完全适配，遇到问题请反馈具体报错信息

安装​

将 Skript-2.15.0.jar 放入 plugins 文件夹，服务器启动时加载即可。不支持热重载。

致谢​

基于 SkriptLang/Skript 原项目修改：https://github.com/SkriptLang/Skript