SpongePowered / VanillaGradle

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!

Documentation

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

Building VanillaGradle

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)

Version History

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.