============================= Reading the Download Filename ============================= .. note:: Our versioning policy was updated in October 2018. **Beginning with** SpongeAPI 7.1, the following information applies. See :doc:`legacy-versions` 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. .. _sponge-forge-file-name: SpongeForge =========== The format of the SpongeForge download filename is: ``spongeforge---..)>.jar`` +----------------------+-----------------------------------------------------------------------------------------------+ | ``MCVersion`` | The Minecraft version. Only clients compatible with this version can connect. | +----------------------+-----------------------------------------------------------------------------------------------+ | ``ForgeBuild`` | The Forge build that SpongeForge is built against and is guaranteed to be compatible | +----------------------+-----------------------------------------------------------------------------------------------+ | ``APIMajor`` | The major version of SpongeAPI implemented by this file (the ``X`` in | | | :ref:`semantic versioning`). | +----------------------+-----------------------------------------------------------------------------------------------+ | ``LatestAPI`` | The minor version of SpongeAPI implemented by this file (the ``Y`` in | | ``MinorRelease`` | :ref:`semantic versioning`). | +----------------------+-----------------------------------------------------------------------------------------------+ | ``Recommended`` | The released version of the implementation when **not** followed by ``-RC`` (the | | ``Version`` | ``Z`` in :ref:`semantic versioning`). | +----------------------+-----------------------------------------------------------------------------------------------+ | ``-RC`` | The build number in development for the next recommended release. When a build number is | | ```` | present, the ``RecommendedVersion`` has **not** been released yet. | +----------------------+-----------------------------------------------------------------------------------------------+ 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-..0-shaded.jar`` **OR** ``spongeapi-..0-.