Skip to main content

​
Adding the Dependency

The SuperiorSkyblock2 API is available through BG-Software’s Maven repository. Choose your build tool below: 
<repositories>
    <repository>
        <id>bg-repo</id>
        <url>https://repo.bg-software.com/repository/api/</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>com.bgsoftware</groupId>
        <artifactId>SuperiorSkyblockAPI</artifactId>
        <version>VERSION</version>
        <scope>provided</scope>
    </dependency>
</dependencies>
Replace VERSION with the version of SuperiorSkyblock2 you’re targeting. You can find available versions on the BG-Software repository.

​
Plugin Dependencies

Make sure to declare SuperiorSkyblock2 as a dependency in your plugin.yml:
plugin.yml
name: YourPlugin
version: 1.0.0
main: com.example.yourplugin.YourPlugin
api-version: 1.13
depend: [SuperiorSkyblock2]
If SuperiorSkyblock2 is optional for your plugin, use softdepend instead:
plugin.yml
name: YourPlugin
version: 1.0.0
main: com.example.yourplugin.YourPlugin
api-version: 1.13
softdepend: [SuperiorSkyblock2]

​
Verifying the Setup

1

Build your project

Run mvn clean install or gradle build to ensure dependencies are resolved
2

Check for compilation errors

Make sure all SuperiorSkyblock2 API imports are recognized
3

Test on a server

Deploy your plugin alongside SuperiorSkyblock2 and verify it loads correctly

​
Common Issues

​
ClassNotFoundException

If you get ClassNotFoundException at runtime:
  • Ensure SuperiorSkyblock2 is installed on your server
  • Verify the dependency scope is set to provided or compileOnly
  • Check that SuperiorSkyblock2 loads before your plugin (use depend in plugin.yml)

​
Version Mismatch

If you experience compatibility issues:
  • Match your API version with the SuperiorSkyblock2 plugin version on your server
  • Check for deprecation warnings in your code
  • Review the changelog for breaking changes

​
Next Steps

Now that you have the API set up, learn how to use it: