backup

Author: SolsticeSpectrum

README.md

@@ -7,6 +7,7 @@ Starting with 1.21.11, Mojang ships unobfuscated JARs.
 ## Requirements
 
 - JDK 21+
+- GraalVM 21+ (native builds)
 
 ## Setup
 
@@ -50,6 +51,7 @@ export IDEA_JDK="/usr/lib/jvm/java-21-jetbrains"
 │   └── server/        # server patches (mymod.patch)
 ├── server/src/        # shared/server source
 ├── client/src/        # client-only source
+├── native/            # GraalVM substitutions and configs
 └── prism-instance/    # PrismLauncher instance template
 ```
 
@@ -133,6 +135,31 @@ prism-instance/
     └── custom.mods.json            # jarMods component
 ```
 
+## Native Builds
+
+### Build
+
+```bash
+./gradlew nativeServer
+./gradlew nativeClient
+```
+
+### Run
+
+```bash
+./gradlew runNativeServer
+./gradlew runNativeClient
+```
+
+### Reachability Metadata
+
+Run the game, trigger as many code paths as possible, then quit. Agent merges into `native/configs/`, can be run multiple times.
+
+```bash
+./gradlew nativeServerAgent
+./gradlew nativeClientAgent
+```
+
 ## Decompiler
 
 Uses Vineflower with standard flags. Patches fix type inference issues, lambda captures, and other decompiler artifacts.

build.gradle

@@ -41,6 +41,8 @@ ext {
     ]
 
     assetsVer = '29'
+    serverMain = 'net.minecraft.server.Main'
+    clientMain = 'net.minecraft.client.main.Main'
 }
 
 task download {
@@ -143,9 +145,7 @@ task modPackServer {
     doLast { Mod.pack(rootDir, 'server') }
 }
 
-task setupServer { group = 'setup'; dependsOn snapServer }
-task setupClient { group = 'setup'; dependsOn snapClient }
-task setup { group = 'setup'; dependsOn setupServer, setupClient }
+task setup { group = 'setup'; dependsOn snapServer, snapClient }
 
 task genPatchServer {
     group = 'patches'
@@ -169,7 +169,7 @@ configure([project(':server'), project(':client')]) {
         from(zipTree("${rootDir}/jars/${project.name}.jar")) { include '**/package-info.class' }
 
         manifest {
-            def main = project.name == 'server' ? 'net.minecraft.server.Main' : 'net.minecraft.client.main.Main'
+            def main = project.name == 'server' ? serverMain : clientMain
             attributes 'Main-Class': main
         }
 
@@ -192,9 +192,7 @@ configure([project(':server'), project(':client')]) {
             rename { "${project.name}-${version}_unobfuscated.jar" }
         }
     }
-}
 
-subprojects {
     dependencies {
         implementation 'com.mojang:authlib:7.0.61'
         implementation 'com.mojang:brigadier:1.3.10'
@@ -219,7 +217,7 @@ task runServer(type: JavaExec) {
     group = 'run'
     doFirst { mkdir 'run_server' }
 
-    mainClass = 'net.minecraft.server.Main'
+    mainClass = serverMain
     classpath = project(':server').sourceSets.main.runtimeClasspath
     workingDir = file('run_server')
 
@@ -231,7 +229,7 @@ task runClient(type: JavaExec) {
     dependsOn 'assets'
     doFirst { mkdir 'run' }
 
-    mainClass = 'net.minecraft.client.main.Main'
+    mainClass = clientMain
     classpath = project(':client').sourceSets.main.runtimeClasspath
     workingDir = file('run')
 
@@ -241,10 +239,89 @@ task runClient(type: JavaExec) {
             '--assetIndex', assetsVer, '--gameDir', 'run']
 }
 
+task runNativeServer(type: Exec) {
+    group = 'run'
+    doFirst { mkdir 'run_server' }
+
+    commandLine = Native.runCommand(rootDir, 'server', '--nogui')
+    workingDir = file('run_server')
+}
+
+task runNativeClient(type: Exec) {
+    group = 'run'
+    dependsOn 'assets'
+    doFirst { mkdir 'run' }
+
+    commandLine = Native.runCommand(rootDir, 'client',
+        '--version', version, '--accessToken', '0', '--assetsDir', 'assets',
+        '--assetIndex', assetsVer, '--gameDir', 'run')
+    workingDir = file('run')
+    environment '__GL_THREADED_OPTIMIZATIONS', '0'
+}
+
+task nativeServerAgent(type: JavaExec) {
+    group = 'native'
+    dependsOn ':server:jar'
+    doFirst { Native.requireGraalVM(); mkdir 'run_server' }
+
+    mainClass = serverMain
+    classpath = project(':server').sourceSets.main.runtimeClasspath
+    workingDir = file('run_server')
+    jvmArgs = [Native.agentArg(rootDir, 'server')]
+
+    args = ['--nogui']
+}
+
+task nativeClientAgent(type: JavaExec) {
+    group = 'native'
+    dependsOn ':client:jar', 'assets'
+    doFirst { Native.requireGraalVM(); mkdir 'run' }
+
+    mainClass = clientMain
+    classpath = project(':client').sourceSets.main.runtimeClasspath
+    workingDir = file('run')
+    jvmArgs = [Native.agentArg(rootDir, 'client')]
+    environment '__GL_THREADED_OPTIMIZATIONS', '0'
+
+    args = ['--version', version, '--accessToken', '0', '--assetsDir', 'assets',
+            '--assetIndex', assetsVer, '--gameDir', 'run']
+}
+
+project(':server').tasks.compileJava.mustRunAfter snapServer
+project(':client').tasks.compileJava.mustRunAfter snapClient
+
+task nativeServer(type: Exec) {
+    group = 'native'
+    dependsOn snapServer, ':server:jar', ':native:jar'
+    doFirst {
+        Native.requireGraalVM(); mkdir 'native/build'
+        def cp = Native.classpath(
+            project(':server').tasks.jar.archiveFile.get().asFile,
+            project(':server').sourceSets.main.runtimeClasspath.asPath,
+            project(':native').tasks.jar.archiveFile.get().asFile)
+        commandLine = Native.buildCommand(cp, rootDir, 'server', serverMain)
+    }
+    workingDir = file('native/build')
+}
+
+task nativeClient(type: Exec) {
+    group = 'native'
+    dependsOn snapServer, snapClient, ':client:jar', ':native:jar'
+    doFirst {
+        Native.requireGraalVM(); mkdir 'native/build'
+        def cp = Native.classpath(
+            project(':client').tasks.jar.archiveFile.get().asFile,
+            project(':client').sourceSets.main.runtimeClasspath.asPath,
+            project(':native').tasks.jar.archiveFile.get().asFile)
+        commandLine = Native.buildCommand(cp, rootDir, 'client', clientMain)
+    }
+    workingDir = file('native/build')
+}
+
 idea.project.settings {
     runConfigurations {
         'Minecraft Client'(org.jetbrains.gradle.ext.Application) {
-            mainClass = 'net.minecraft.client.main.Main'
+            mainClass = clientMain
             moduleName = "${rootProject.name}.client.main"
             workingDirectory = "${rootDir}/run"
             programParameters = "--version ${version} --accessToken 0 " +
@@ -254,7 +331,7 @@ idea.project.settings {
         }
 
         'Minecraft Server'(org.jetbrains.gradle.ext.Application) {
-            mainClass = 'net.minecraft.server.Main'
+            mainClass = serverMain
             moduleName = "${rootProject.name}.server.main"
             workingDirectory = "${rootDir}/run_server"
             programParameters = 'nogui'
@@ -267,7 +344,7 @@ jar.enabled = false
 
 clean {
     delete 'run', 'run_server', 'decompSrc/client', 'patchSrc'
-    delete 'client/src', 'server/src', 'client/bin', 'server/bin'
+    delete 'client/src', 'server/src', 'client/bin', 'server/bin', 'native/build'
     delete 'jars', 'libs', 'vineflower.jar'
 }
 

buildSrc/src/main/java/Native.java

@@ -0,0 +1,44 @@
+import java.io.*;
+import java.util.*;
+
+public class Native {
+
+    public static void requireGraalVM() {
+        if (!new File(bin()).exists())
+            throw new RuntimeException("Current JDK is not GraalVM (native-image not found)");
+    }
+
+    public static String agentArg(File root, String side) {
+        return "-agentlib:native-image-agent=config-merge-dir=" + new File(root, "native/configs/" + side);
+    }
+
+    public static String classpath(File projectJar, String runtimeCp, File nativeJar) {
+        return projectJar.getAbsolutePath() + File.pathSeparator + runtimeCp +
+            File.pathSeparator + nativeJar.getAbsolutePath();
+    }
+
+    public static List<String> buildCommand(String cp, File root, String side, String mainClass) {
+        return new ArrayList<>(Arrays.asList(
+            bin(), "-cp", cp,
+            "-H:ConfigurationFileDirectories=" + new File(root, "native/configs/" + side),
+            "-H:Name=" + side,
+            "--no-fallback", "--gc=serial", "--enable-http", "--enable-https",
+            "-H:+AddAllCharsets", "-H:+UnlockExperimentalVMOptions", "-Djava.awt.headless=false",
+            "-H:IncludeResources=data/.*", "-H:IncludeResources=assets/.*",
+            "--initialize-at-run-time=net.minecraft.TracingExecutor,sun.net.dns.ResolverConfigurationImpl," +
+                "io.netty,org.apache.logging.log4j,org.apache.logging.slf4j,org.slf4j,com.mojang.logging",
+            mainClass
+        ));
+    }
+
+    public static List<String> runCommand(File root, String side, String... args) {
+        List<String> cmd = new ArrayList<>();
+        cmd.add(new File(root, "native/build/" + side).getAbsolutePath());
+        cmd.addAll(Arrays.asList(args));
+        return cmd;
+    }
+
+    private static String bin() {
+        return System.getProperty("java.home") + "/bin/native-image";
+    }
+}

logs/2025-12-30-1.log.gz

@@ -1,9 +1,14 @@
-[22:06:46] [main/ERROR]: Failed to start the minecraft server
-joptsimple.UnrecognizedOptionException: c is not a recognized option
-	at joptsimple.OptionException.unrecognizedOption(OptionException.java:108)
-	at joptsimple.OptionParser.validateOptionCharacters(OptionParser.java:633)
-	at joptsimple.OptionParser.handleShortOptionCluster(OptionParser.java:528)
-	at joptsimple.OptionParser.handleShortOptionToken(OptionParser.java:523)
-	at joptsimple.OptionParserState$2.handleArgument(OptionParserState.java:59)
-	at joptsimple.OptionParser.parse(OptionParser.java:396)
-	at net.minecraft.server.Main.main(Main.java:87)
+[22:41:44] [main/ERROR]: Failed to load properties from file: server.properties
+java.nio.file.NoSuchFileException: server.properties
+	at java.base@21.0.10/sun.nio.fs.UnixFileSystemProvider.newByteChannel(UnixFileSystemProvider.java:261)
+	at java.base@21.0.10/java.nio.file.Files.newByteChannel(Files.java:379)
+	at java.base@21.0.10/java.nio.file.Files.newByteChannel(Files.java:431)
+	at java.base@21.0.10/java.nio.file.spi.FileSystemProvider.newInputStream(FileSystemProvider.java:420)
+	at java.base@21.0.10/java.nio.file.Files.newInputStream(Files.java:159)
+	at net.minecraft.server.dedicated.Settings.loadFromFile(Settings.java:38)
+	at net.minecraft.server.dedicated.DedicatedServerProperties.fromFile(DedicatedServerProperties.java:156)
+	at net.minecraft.server.dedicated.DedicatedServerSettings.<init>(DedicatedServerSettings.java:12)
+	at net.minecraft.server.Main.main(Main.java:107)
+	at java.base@21.0.10/java.lang.invoke.LambdaForm$DMH/sa346b79c.invokeStaticInit(LambdaForm$DMH)
+[22:41:44] [main/WARN]: Failed to load eula.txt
+[22:41:44] [main/INFO]: You need to agree to the EULA in order to run the server. Go to eula.txt for more info.

logs/2026-03-14-1.log.gz

@@ -0,0 +1,8 @@
+repositories {
+    maven { url 'https://maven.fabricmc.net/' }
+}
+
+dependencies {
+    implementation 'org.graalvm.sdk:nativeimage:24.2.1'
+    implementation 'net.fabricmc:sponge-mixin:0.15.0+mixin.0.8.7'
+}