Java minecraft-server Kotlin Shell Gradle mixin-framework spongeapi spongepowered Minecraft hacktoberfest sponge mixins
Need help with SpongeCommon?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.


Shared code between SpongeForge and SpongeVanilla

221 Stars 172 Forks MIT License 6.6K Commits 351 Opened issues

Services available

Need anything else?

SpongeCommon Build Status

Common code for official SpongeAPI implementations. It is licensed under the MIT License.



The following steps will ensure your project is cloned properly.

  1. git clone --recursive
  2. cd SpongeCommon
  3. cp scripts/pre-commit .git/hooks


Note: SpongeCommon uses Gradle as its build system. The repo includes the Gradle wrapper that will automatically download the correct Gradle version. Local installations of Gradle may work but are untested. To execute the Gradle wrapper, run the

script on Unix systems or only
on Windows systems.

Before you are able to build SpongeCommon, you must first prepare the environment (some IDEs may do this for you).

  • Run
    ./gradlew build --refresh-dependencies

Even if this fails to compile SpongeCommon, it will download all the dependencies so you can get started.

IDE Setup

For Eclipse 1. Run

./gradlew eclipse
2. Import SpongeCommon as an existing project (File > Import > General) 3. Select the root folder for SpongeCommon and make sure
Search for nested projects
is enabled 4. Check SpongeCommon when it finishes building and click Finish

For IntelliJ 1. Make sure you have the Gradle plugin enabled (File > Settings > Plugins).
2. Click File > New > Project from Existing Sources > Gradle and select the root folder for SpongeCommon. 3. Make sure Use default gradle wrapper is selected. Older/newer Gradle versions may work but we only test using the wrapper.


Note: You must Setup the environment before you can build SpongeCommon.

In order to build SpongeCommon you simply need to run the

command. On Windows systems you should run
instead of
to invoke the Gradle wrapper. You can find the compiled JAR files in

Updating your Clone

The following steps will update your clone with the official repo.

  1. git pull
  2. git submodule update --recursive
  3. ./gradlew build --refresh-dependencies


Are you a talented programmer looking to contribute some code? We'd love the help! * Open a pull request with your changes, following our guidelines. * Please follow the above guidelines for your pull request(s) to be accepted.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.