从Velocity 1.x.x移植你的插件

Velocity 3.0.0包含了与Velocity 1.x.x系列相比的重要API更改。请非常仔细地阅读本文档。

最低支持的Java版本提升

Velocity 3.3.x现在需要Java 17及以上版本。

移除旧的依赖

我们移除了对旧的text 3库的所有支持。对于text 3.x.x(以及所有依赖它的API),在Adventure中都有直接的等效替代,Adventure是在Velocity 1.1.0中引入的。

toml4j在Velocity 1.1.0中被弃用(因为它不再维护),但尚未被移除,以便为插件提供更多时间迁移到Configurate。但是,你应该准备切换到Configurate或者直接将toml4j打包到你的插件中。

新的异步事件系统

Velocity 3.0.0包含了Velocity Polymer事件系统的移植版本,它在许多方面与Velocity 1.x.x的事件系统不同。Velocity 1.x.x的事件模型强制所有事件在固定大小的线程池上异步执行,这随着时间的推移被证明是一个有缺陷的模型。

现有的事件处理器将在Velocity 3.0.0上继续不变地工作,因为默认情况下所有事件处理器都被假定为异步阻塞处理器。但是,为了处理延续(continuations),引入了一些新的API - 有关更多信息,请参见事件API页面。不过,我们鼓励你将你的事件监听器迁移到新的事件API范式。