Laufaufgaben für die Produktionsumgebung 1.21.4

Dokumentation für Laufaufgaben für die Produktionsumgebung mit dem Fabric Loom Gradle Plugin.

WARNING

Diese Seite ist für die Version 1.21.4 geschrieben. Dokumentationen für ältere Versionen sind möglicherweise unvollständig.

Wenn du deinen Mod für die Verteilung an die Benutzer erstellst, wird er auf Zwischenmappings umgestellt, die leichte Inkonsistenzen zwischen der Entwicklungsumgebung und der Produktion (wie dem Vanilla Launcher) verursachen. Obwohl solche Probleme selten sind, ist es sinnvoll, deinen Mod in einer Produktionsumgebung zu testen, bevor du ihn freigibst.

Häufige Optionen

Die Server- und die Client-Aufgaben erben beide von der gleichen Klasse AbstractProductionRunTask. Das bedeutet, dass sie sich die folgenden Optionen teilen:

tasks.register("prodServer", net.fabricmc.loom.task.prod.ServerProductionRunTask) {
    // A collection of mod jars that will be used when running the game. The mods must be remapped to run with intermediary names.
    // This uses a Gradle ConfigurableFileCollection allowing the files to come from a variety of sources.
    mods.from file("mod.jar")
    mods.from configurations.exampleConfiguration

    // A list of additional JVM arguments to pass to the game.
    jvmArgs.add("-Dfabric.client.gametest")

    // A list of additional program arguments to pass to the game.
    programArgs.add("--example")

    // The directory to run the game in.
    runDir = file("run")

    // Specify the Java toolchain to use when running the game.
    // Defaults to the Java version being used to run Gradle.
    // See https://docs.gradle.org/current/userguide/toolchains.html#sec:plugins_toolchains
    javaLauncher = javaToolchains.launcherFor {
        languageVersion = JavaLanguageVersion.of(21)
    }
}

Server

Die Server-Produktionslaufaufgabe verwendet denselben Server-Launcher, den du von der Fabric-Website herunterlädst, um zu gewährleisten, dass die Umgebung der Produktionsumgebung so nahe wie möglich kommt.

tasks.register("prodServer", net.fabricmc.loom.task.prod.ServerProductionRunTask) {
    // The version of the Fabric Installer to use. This must be specified.
    installerVersion = "1.0.1"

    // The version of Fabric Loader to use.
    // Defaults to the version of Fabric Loader that the project is using.
    loaderVersion = "0.16.10"

    // The version of Minecraft to use.
    // Defaults to the version of Minecraft that the project is using.
    minecraftVersion = "1.21.4"
}

Der Server-Task hat die einzigartige Fähigkeit, deinen Mod mit einer anderen Version von Minecraft laufen zu lassen, dies könnte nützlich sein, wenn du einen Cross-Version-Mod entwickelst.

Client

tasks.register("prodClient", net.fabricmc.loom.task.prod.ClientProductionRunTask) {
    // Whether to use XVFB to run the game, using a virtual framebuffer. This is useful for headless CI environments.
    // Defaults to true only on Linux and when the "CI" environment variable is set.
    // XVFB must be installed, on Debian-based systems you can install it with: `apt install xvfb`
    useXVFB = true

    // Optionally configure the tracy-capture executable.
    tracy {
        // The path to the tracy-capture executable.
        tracyCapture = file("tracy-capture")

        // The output path of the captured tracy profile.
        output = file("profile.tracy")

        // The maximum number of seconds to wait for tracy-capture to stop on its own before killing it.
        // Defaults to 10 seconds.
        maxShutdownWaitSeconds = 10
    }
}