VanillaGradle is a toolchain for Minecraft: Java Edition that provides a workspace to interact with the game using official mappings provided by Mojang Studios. This plugin requires at least Gradle 6.7 and Java 8 to run, though it is only actively tested against the latest release of every major Gradle series supported (currently 6.x and 7.x).
VANILLAGRADLE IS NOT DESIGNED AND IS NOT GENERALLY USEFUL FOR END-USER USE. IT IS FOR TOOLING AND PLATFORM DEVELOPERS WHO HAVE A SOLID WORKING KNOWLEDGE OF GRADLE ONLY!
The main documentation for VanillaGradle can be found in the Wiki.
For additional help use the channel #vanillagradle
on the Sponge Discord server.
Otherwise, to get a workspace up and going with vanilla Minecraft immediately it is as simple as creating a Gradle build based on this buildscript:
plugins {
java
id("org.spongepowered.gradle.vanilla") version "0.2"
}
group = "org.example"
version = "1.0-SNAPSHOT"
repositories {
mavenCentral()
}
minecraft {
version("1.16.5") // or: latestRelease() or latestSnapshot()
runs {
server()
client()
}
}
Within IntelliJ IDEA and Eclipse, this will generate run configurations named runClient
and runServer
To have browsable sources in-IDE, run ./gradlew decompile
VanillaGradle uses the Gradle build automation system. To perform a build, use Gradle version 6.9 and execute
gradle build
from within the project root directory. (If you do not have Gradle installed on
your system you can instead run the supplied Gradle wrapper gradlew
)
Compatibility: We use Semantic Versioning for the user-visible API in VanillaGradle. This applies to every public class
outside of the org.spongepowered.gradle.vanilla.internal
package. The contents of the internal
package are considered implementation details
and are subject to change at any time.
Version | Date | Features / Changes |
---|---|---|
0.2 | May 2021 |
|
0.1 | February 2021 |
|