Sometimes, when you install a Sponge Plugin they do not work. This can be quite frustrating. Below are a few things you can check that could be creating the issues:
- Sponge API Versions
- Check the Folder
- Incorrect Base Plugin Version
- Read the Documentation
Sponge API Versions
Unfortunately, Sponge servers are not forward compatible with plugins created with a newer API version. From the official Sponge website, find an abridged and reformatted version of the table below:
| Sponge API Version | SpongeForge Version | SpongeVanilla Version | Notes |
|---|
| 11.0.0 | 1.20.1 | 1.20.1 | TBA - Not released yet |
| 10.0.0 | 1.19.4 | 1.19.4 | SpongeForge TBA - SpongeForge for 1.19.4 not released yet |
| 9.0.0 | N/A | 1.18.2 | No SpongeForge Version available |
| 8.0.0 | 1.16.5 | 1.16.5 | End of Support not announced yet |
| 7.0.0 - 7.4.0 | 1.12.2 | 1.12.2 | Multiple records combined. The Sponge API version of your server will depend on how recent your build is. Most likely, the sponge API version is 7.4.0 |
| 6.0.0 | 1.11.2 | 1.11.2 | N/A |
| 5.1.0 | 1.10.2 | 1.10.2 | N/A |
For each version of Minecraft, there is an implementation of both the SpongeVanilla and SpongeForge API. Check the table above to check the respective sponge API version of the version of Minecraft version and the type of sponge (SpongeVanilla or SpongeForge) you are using.
You need to make sure that the plugin you are downloading uses the same API version, or lower in order for the plugin to work. If in doubt, try the lower version.
Check the Folder
Mod folder, or plugin folder?
Check whether the plugin you are using makes use of Mixins. Any plugins which use mixins must be placed in the mods folder, as per the sponge documentation.
Correct folder path?
For SpongeVanilla:
The plugins should all be in the mods folder. For Oddblox clients, the full path should be /home/container/mods.
For SpongeForge:
The mods should all be in the mods folder. For Oddblox clients, the full path should be /home/container/mods.
The plugins should all be in the plugins folder (mods/plugins). For Oddblox clients, the full path should be /home/container/mods/plugins.
Incorrect Base Plugin Version
When installing an plugin which adds functionality to an existing plugin, there can be compatibility issues with the “base” plugin and the plugin adding extra functionality, especially when the versions do not match.
An example of this is the PrismPlus and the Prism plugin, before the PrismRefracted refactor, as there is an issue where you need to manually compile the latest master release, as there was a function that only existed in the latest commit (Separate KBA to be written).
Read the Documentation
Certain special instructions are sometimes provided by the writer and maintainer of plugins and special configurations to use.
—
Further Information
