API版本

本页说明存在哪些API版本,以及他们的实现所属的Minecraft版本。

API版本 发布日期 终止支持 已知实现(Minecraft版本)
8.0.0 即将公布 即将公布
  • SpongeForge (1.13.x)
  • SpongeVanilla (1.13.x)
7.1.0 2018年9月6日 即将公布
  • SpongeForge (1.12.2)
  • SpongeVanilla (1.12.2)
7.0.0 2018年1月1日 即将公布
  • SpongeForge (1.12.2)
  • SpongeVanilla (1.12.2)
6.0.0 2017年5月2日 2017年12月31日
  • SpongeForge (1.11.2)
  • SpongeVanilla (1.11.2)
5.1.0 2017年2月25日 2017年12月31日
  • SpongeForge (1.10.2)
  • SpongeVanilla (1.10.2)

建议始终更新到API的最新稳定版本,或者长时间支持版本。

注解

你仍可以继续为以及结束支持的版本开发和发布插件,但是 Sponge团队将不会为不支持的构建提供Bug修复或者新的特性。

获取实现的API版本

从Jar文件中获取

注解

SpongeForge和SpongeVanilla的版本文字目前存在缺陷,它目前包含一个次要版本号指向**未发布**的API版本,计划中这个会在未来的更新中修复。

因为我们使用语义化版本,7.1.0中的更改应该对7.0.0向后兼容。所以,我们经常在SpongeForge和SpongeVanilla中使用即将到来的API发布的**预览版**的实现。

预览版API构建中的API可能会在它正式发布前更变,所以为了插件兼容性考虑,最好为插件使用最新的稳定版API,而不是预览版的API。

所以,如果文件中指出的API版本是7.2.0但是7.2.0尚未公开发布,你应该使用针对7.1.0构建的插件,除非应插件开发者的要求测试新的特性,或者你愿意容忍由于新特性而产生的一些偶发的不兼容。

这**会**在不久的将来被修复。当修复之后, SpongeForge与SpongeVanilla的版本号将不会指向未发行的SpongeAPI次要版本,但是出于测试考虑包含下一个主要版本API预览的版本仍会存在。

主API版本提升仅留给experimental / bleeding构建使用,并且会非常清楚,因为因为主版本号不同。

获取实现的Minecraft版本

从源代码中获取

  • 对于 SpongeForgeSpongeVanilla:

    去引用的SpongeCommon仓库检查项目根目录的 gradle.properties 。它包含一条 minecraftVersion

    注解

    对于 mcpMappings 版本这也同样有效。

  • 只对于`SpongeVanilla <https://github.com/SpongePowered/SpongeVanilla>`__ :

    检查项目根目录的 gradle.properties 。它包含一条 minecraftVersion