Reading the Download Filename
Note
Our versioning policy was updated in October 2018. Beginning with SpongeAPI 7.1, the following information applies. See Older Versions of SpongeForge for information on older versions.
When you download files, the name of the file will provide some important version information. The following sections describe the information provided.
SpongeForge
The format of the SpongeForge download filename is:
spongeforge-<MCVersion>-<ForgeBuild>-<APIMajor>.<LatestAPIMinorRelease>.<RecommendedVersion(-RC<BuildNumber>)>.jar
|
The Minecraft version. Only clients compatible with this version can connect. |
|
The Forge build that SpongeForge is built against and is guaranteed to be compatible |
|
The major version of SpongeAPI implemented by this file (the |
|
The minor version of SpongeAPI implemented by this file (the |
|
The released version of the implementation when not followed by |
|
The build number in development for the next recommended release. When a build number is
present, the |
The Forge Build in the filename specifies the version of Forge this version of SpongeForge used during development and testing. The two versions are guaranteed to work without any issues. We tend to use the latest Recommended Build of Forge for this purpose.
Note
Normal Forge mods can usually run on any build of Forge for a given Minecraft version (e.g. 1.12.2) without any problem. However, SpongeForge needs to access, among other things, internal parts of Forge, which most mods shouldn’t be touching, let alone modifying as Sponge does. Since Forge is free to change their internal code whenever they want to, its normal guarantee of backwards-compatibility doesn’t apply to SpongeForge. Feel free to use more recent versions of Forge than the one used for SpongeForge, but we can’t always guarantee compatibility.
Warning
When investigating crash issues, you can freely try newer versions of Forge than listed on the SpongeForge Jar. However, it is recommended to also check with the matching version, to make sure your issue is not related to a version mismatch. Even though there will be no guarantee of compatibility, please report any breakage to the issue tracker, so that SpongeForge can be updated.
Examples
SpongeForge Jar files will always follow this naming scheme to allow you to easily identify compatibility.
For example, the file name spongeforge-1.12.2-2768-7.1.4.jar
is compatible with Minecraft version 1.12.2
, was
built with Forge 14.23.5.2768
(Build 2768
), guarantees compatibility with SpongeAPI 7.1.0
, is a recommended
version, and is the 4
th release of SpongeForge with this API.
Another example is the file name spongeforge-1.12.2-2768-7.1.5-RC3505.jar
. This file is compatible with Minecraft
version 1.12.2
, was built with Forge 14.23.5.2768
(Build 2768
), guarantees compatibility with SpongeAPI
7.1.0
, is not a recommended version, and is build number 3505
in development, which will be the 5
th
release of SpongeForge once this version is released.
SpongeVanilla
The information for SpongeVanilla is identical to SpongeForge except that SpongeVanilla does not contain a Forge build number. So, the above examples of SpongeForge jar files will look like the following for SpongeVanilla:
spongevanilla-1.12.2-7.1.4.jar
and spongevanilla-1.12.2-7.1.5-RC148.jar
SpongeAPI
The format of the filename is:
spongeapi-<APIMajor>.<LatestAPIMinorRelease>.0-shaded.jar
OR
spongeapi-<APIMajor>.<LatestAPIMinorRelease>.0-<Date>.<Time>-<BuildNumber>-shaded.jar
OR
spongeapi-<APIMajor>.<LatestAPIMinorRelease>.0-SNAPSHOT.jar
|
The major version of SpongeAPI implemented by this file (the |
|
The minor version of SpongeAPI implemented by this file (the |
|
The date when the build job ran. |
|
The time when the build job ran. |
|
The build number of Sponge. Supply this number when reporting bugs or seeking support. |
Note
The first format without the build information is the Release and Recommended Build format (e.g.,
spongeapi-7.1.0-shaded.jar
).
The second format with the build information is the Latest format when the file is downloaded with a web
browser. This version is still in development (e.g., spongeapi-7.2.0-20190224.183500-15-shaded.jar
).
The third format without the build information is the Latest format when the file is downloaded by Gradle or
Maven or is created by the build process. This version is still in development (e.g.,
spongeapi-7.2.0-SNAPSHOT.jar
).
See our build system page
for an explanation of the -shaded
label.