API-Versions

This page explains which API versions exist, and to which Minecraft version their implementations belong.

API-Version

Release Date

End of Updates

Known Implementations (Minecraft Version)

11.0.0

TBA

TBA

  • SpongeForge (1.20.4 - expected)

  • SpongeVanilla (1.20.4 - expected)

10.0.0

Sep 3 2023

TBA

  • SpongeForge (1.19.4)

  • SpongeVanilla (1.19.4)

9.0.0

May 19 2022

April 1, 2023

  • SpongeVanilla (1.18.2)

8.2.0

Sep 3, 2023

Sep 3, 2023

  • SpongeForge (1.16.5)

  • SpongeVanilla (1.16.5)

8.1.0

Jan 8, 2022

Sep 3, 2023

  • SpongeForge (1.16.5)

  • SpongeVanilla (1.16.5)

8.0.0

May 19, 2022

Jan 8, 2022

  • SpongeForge (1.16.5)

  • SpongeVanilla (1.16.5)

7.4.0

Nov 28, 2020

Dec 28, 2021

  • SpongeForge (1.12.2)

  • SpongeVanilla (1.12.2)

7.3.0

Aug 30, 2020

Nov 28, 2020

  • SpongeForge (1.12.2)

  • SpongeVanilla (1.12.2)

7.2.0

Mar 29, 2020

Aug 30, 2020

  • SpongeForge (1.12.2)

  • SpongeVanilla (1.12.2)

7.1.0

Sep 6, 2018

Mar 28, 2020

  • SpongeForge (1.12.2)

  • SpongeVanilla (1.12.2)

7.0.0

Jan 1, 2018

Sep 5, 2018

  • SpongeForge (1.12.2)

  • SpongeVanilla (1.12.2)

6.0.0

May 2, 2017

Dec 31, 2017

  • SpongeForge (1.11.2)

  • SpongeVanilla (1.11.2)

5.1.0

Feb 25, 2017

Dec 31, 2017

  • SpongeForge (1.10.2)

  • SpongeVanilla (1.10.2)

It is recommended to always update to the latest stable version of the API or to an LTS version.

Nota

You may still choose to develop and release plugins against versions that have reached the end of support, but the Sponge team will not provide bug fixes or features to unsupported builds.

Getting the API Version from Implementations

Getting it from the Jar

See Versioning.

Getting the Minecraft Version from Implementations

Getting it from the Sources

  • For SpongeAPI 8 or later:

    Check the gradle.properties in the project root. It contains an entry with the minecraftVersion.

  • For SpongeForge or SpongeVanilla:

    Go to the referenced SpongeCommon repository and check the gradle.properties in the project root. It contains an entry with the minecraftVersion.

    Nota

    The same works for the mcpMappings version.

  • For SpongeVanilla (only):

    Check the gradle.properties in the project root. It contains an entry with the minecraftVersion.