Version Fixes + QOL

Author: ryderjt

.github/workflows/release-to-discord.yml

@@ -0,0 +1,56 @@
+name: Release -> Discord
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  build-and-post:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Java
+        uses: actions/setup-java@v4
+        with:
+          distribution: temurin
+          java-version: "21"
+
+      - name: Grant execute permission for Gradle
+        run: chmod +x ./gradlew
+
+      - name: Build
+        run: ./gradlew build
+
+      - name: Find built jar
+        id: jar
+        shell: bash
+        run: |
+          # pick the main jar from build/libs; ignore extra jars
+          JAR="$(ls -1 build/libs/*.jar \
+            | grep -Ev '(-sources|-javadoc|-dev|-shadow|-all)\.jar$' \
+            | head -n 1)"
+
+          if [ -z "$JAR" ]; then
+            echo "No suitable jar found in build/libs/"
+            ls -la build/libs || true
+            exit 1
+          fi
+
+          echo "Found jar: $JAR"
+          echo "jar_path=$JAR" >> "$GITHUB_OUTPUT"
+
+      - name: Post to Discord (message + jar attachment)
+        shell: bash
+        run: |
+          TAG="${{ github.event.release.tag_name }}"
+          URL="${{ github.event.release.html_url }}"
+          NAME="${{ github.event.repository.name }}"
+          JAR="${{ steps.jar.outputs.jar_path }}"
+
+          curl \
+            -F "payload_json={\"content\":\"**${NAME} ${TAG}**\\nGitHub Release: ${URL}\\n\\n📦 **Download:** (file attached)\"}" \
+            -F "file=@\"${JAR}\"" \
+            "${{ secrets.DISCORD_WEBHOOK_URL }}"

README.md

@@ -1,6 +1,6 @@
 # Pathmind
 
-[![Minecraft](https://img.shields.io/badge/Minecraft-1.21.x-00AA00?style=for-the-badge&logo=minecraft)](https://minecraft.net)
+[![Minecraft](https://img.shields.io/badge/Minecraft-Multi--Version-00AA00?style=for-the-badge&logo=minecraft)](https://minecraft.net)
 [![Fabric](https://img.shields.io/badge/Fabric-0.17.2-CC6E3E?style=for-the-badge&logo=modrinth)](https://fabricmc.net)
 [![Java](https://img.shields.io/badge/Java-21+-FF6B6B?style=for-the-badge&logo=openjdk)](https://openjdk.java.net)
 [![License](https://img.shields.io/badge/License-All%20Rights%20Reserved-lightgrey?style=for-the-badge)](LICENSE)
@@ -11,20 +11,20 @@ A Minecraft Fabric mod that introduces a visual node editor system for creating
 ## Quick Start
 
 ### Prerequisites
-- **Minecraft**: any 1.21.x release
+- **Minecraft**: Any supported version (match the `+mc<version>` suffix on the jar you download)
 - **Fabric Loader**: 0.17.2 or higher
-- **Fabric API**: latest release for your 1.21.x version
-- **Baritone API**: 1.21.x release (download separately)
+- **Fabric API**: release that matches your chosen Minecraft version
+- **Baritone API**: version that matches your Minecraft/Fabric combo (download separately)
 - **Java**: 21 or higher
 
 ### Installation
 
 1. **Install Fabric Loader**
-   - Download and install Fabric Loader for Minecraft 1.21.x
+   - Download and install Fabric Loader for your chosen Minecraft version
    - [Download from FabricMC](https://fabricmc.net/use/installer/)
 
 2. **Install Fabric API**
-   - Download the latest Fabric API for your 1.21.x version
+   - Download the Fabric API build that matches your chosen Minecraft version
    - [Download from Modrinth](https://modrinth.com/mod/fabric-api)
 
 3. **Install Baritone API**
@@ -33,13 +33,19 @@ A Minecraft Fabric mod that introduces a visual node editor system for creating
    - [Download from GitHub](https://github.com/cabaletta/baritone/releases/latest)
 
 4. **Install Pathmind**
-   - Download the latest Pathmind mod jar
+   - Download the Pathmind jar whose filename ends with your Minecraft version (every release ships with `+mc<version>` in the filename)
    - Place it in your `mods` folder
 
 5. **Launch and Enjoy!**
    - Start Minecraft with Fabric Loader
    - Use your configured keybind to open the visual editor
 
+## Compatibility
+
+- Release jars are suffixed with `+mc<version>` so you can keep multiple Minecraft targets side-by-side (e.g., `pathmind-1.0.1+mc1.21.4.jar`).
+- The default Gradle build targets the version listed in `gradle.properties`, but passing `-Pmc_version=<version>` (or using the auto-generated `buildMc<version>` tasks) compiles the identical codebase against any entry in `supportedMinecraftVersions`.
+- Use the `buildAllTargets` task to batch-build jars for every configured version.
+
 ## Development
 
 ### Building from Source
@@ -70,15 +76,25 @@ A Minecraft Fabric mod that introduces a visual node editor system for creating
    ./gradlew runClient
    ```
 
+### Building for Specific Minecraft Versions
+
+- `./gradlew build` creates a jar for the default target (set in `gradle.properties`), but the source code is the same across all supported versions.
+- To build for another version, override the property:  
+  `./gradlew build -Pmc_version=<minecraftVersion>`
+- Convenience tasks are available:
+  - `./gradlew buildMc1_21_4` (build only for `1.21.4`, as an example)
+  - `./gradlew buildAllTargets` (build every configured version sequentially)
+- Each jar is versioned as `pathmind-<modVersion>+mc<gameVersion>.jar` so you can publish multiple targets side by side.
+
 ## Version Information
 
 | Component | Version |
 |-----------|---------|
 | **Mod Version** | 1.0.1 |
-| **Minecraft Version** | 1.21.x |
-| **Yarn Mappings** | 1.21.8+build.1 (with :v2 for compilation) |
+| **Minecraft Version** | Matches the `+mc<version>` suffix on each jar |
+| **Yarn Mappings** | Automatically selected per target version |
 | **Fabric Loader** | 0.17.2 |
-| **Fabric API** | Latest 1.21.x-compatible release |
+| **Fabric API** | Automatically selected per target version |
 | **Baritone API** | 1.15.0 (external dependency) |
 
 ### Development Guidelines

build.gradle.kts

@@ -1,9 +1,54 @@
+import org.gradle.api.GradleException
+import org.gradle.api.tasks.GradleBuild
+import org.gradle.api.tasks.TaskProvider
+
 plugins {
     id("fabric-loom") version "1.10.3"
     id("maven-publish")
 }
 
-version = project.property("mod_version") as String
+data class MinecraftVersionSpec(
+    val yarnMappings: String,
+    val fabricApiVersion: String
+)
+
+val supportedMinecraftVersions = linkedMapOf(
+    "1.21" to MinecraftVersionSpec("1.21+build.9", "0.102.0+1.21"),
+    "1.21.1" to MinecraftVersionSpec("1.21.1+build.3", "0.116.7+1.21.1"),
+    "1.21.2" to MinecraftVersionSpec("1.21.2+build.1", "0.106.1+1.21.2"),
+    "1.21.3" to MinecraftVersionSpec("1.21.3+build.2", "0.114.1+1.21.3"),
+    "1.21.4" to MinecraftVersionSpec("1.21.4+build.8", "0.119.4+1.21.4"),
+    "1.21.5" to MinecraftVersionSpec("1.21.5+build.1", "0.128.2+1.21.5"),
+    "1.21.6" to MinecraftVersionSpec("1.21.6+build.1", "0.128.2+1.21.6"),
+    "1.21.7" to MinecraftVersionSpec("1.21.7+build.8", "0.129.0+1.21.7"),
+    "1.21.8" to MinecraftVersionSpec("1.21.8+build.1", "0.133.4+1.21.8")
+)
+
+fun String.toTaskSuffix(): String = replace(".", "_")
+
+val requestedMinecraftVersion = providers.gradleProperty("mc_version")
+    .orElse(providers.gradleProperty("minecraft_version"))
+    .get()
+
+val requestedSpec = supportedMinecraftVersions[requestedMinecraftVersion]
+
+val yarnMappings = providers.gradleProperty("yarn_mappings").orElse(
+    requestedSpec?.let { provider { it.yarnMappings } }
+        ?: throw GradleException(
+            "No Yarn mappings configured for Minecraft $requestedMinecraftVersion. " +
+                "Either add it to supportedMinecraftVersions or pass -Pyarn_mappings=<mapping>"
+        )
+).get()
+
+val fabricApiVersion = providers.gradleProperty("fabric_api_version").orElse(
+    requestedSpec?.let { provider { it.fabricApiVersion } }
+        ?: throw GradleException(
+            "No Fabric API version configured for Minecraft $requestedMinecraftVersion. " +
+                "Either add it to supportedMinecraftVersions or pass -Pfabric_api_version=<version>"
+        )
+).get()
+
+version = "${project.property("mod_version") as String}+mc$requestedMinecraftVersion"
 group = project.property("maven_group") as String
 
 base {
@@ -40,12 +85,12 @@ val baritoneApiJar: File by extra {
 
 dependencies {
     // To change the versions see the gradle.properties file
-    minecraft("com.mojang:minecraft:${project.property("minecraft_version")}")
-    mappings("net.fabricmc:yarn:${project.property("yarn_mappings")}:v2")
+    minecraft("com.mojang:minecraft:$requestedMinecraftVersion")
+    mappings("net.fabricmc:yarn:$yarnMappings:v2")
     modImplementation("net.fabricmc:fabric-loader:${project.property("loader_version")}")
 
     // Fabric API. This is technically optional, but you probably want it anyway.
-    modImplementation("net.fabricmc.fabric-api:fabric-api:${project.property("fabric_api_version")}")
+    modImplementation("net.fabricmc.fabric-api:fabric-api:$fabricApiVersion")
 
     // Baritone API dependency (compile-time only, users must provide the mod at runtime)
     val baritoneApi = files(baritoneApiJar)
@@ -59,9 +104,9 @@ dependencies {
 tasks.processResources {
     val properties = mapOf(
         "version" to version,
-        "minecraft_version" to project.property("minecraft_version"),
+        "minecraft_version" to requestedMinecraftVersion,
         "loader_version" to project.property("loader_version"),
-        "fabric_api_version" to project.property("fabric_api_version")
+        "fabric_api_version" to fabricApiVersion
     )
     inputs.properties(properties)
 
@@ -96,6 +141,33 @@ tasks.jar {
     }
 }
 
+val cleanTask = tasks.named("clean")
+val multiVersionBuildTasks = mutableListOf<TaskProvider<GradleBuild>>()
+var previousVersionTask: TaskProvider<GradleBuild>? = null
+supportedMinecraftVersions.keys.forEach { version ->
+    val taskName = "buildMc${version.toTaskSuffix()}"
+    val provider = tasks.register<GradleBuild>(taskName) {
+        group = "build"
+        description = "Build Pathmind for Minecraft $version"
+        dir = projectDir
+        tasks = listOf("build")
+        startParameter.projectProperties = mapOf("mc_version" to version)
+    }
+    provider.configure {
+        mustRunAfter(cleanTask)
+        previousVersionTask?.let { mustRunAfter(it) }
+    }
+    multiVersionBuildTasks += provider
+    previousVersionTask = provider
+}
+
+tasks.register("buildAllTargets") {
+    group = "build"
+    description = "Build Pathmind for every configured Minecraft target"
+    dependsOn(cleanTask)
+    multiVersionBuildTasks.forEach { dependsOn(it) }
+}
+
 // configure the maven publication
 publishing {
     publications {

gradle.properties

@@ -5,13 +5,9 @@ org.gradle.parallel=true
 # Fabric Properties
 # check these on https://fabricmc.net/develop
 minecraft_version=1.21.8
-yarn_mappings=1.21.8+build.1
 loader_version=0.17.2
 
 # Mod Properties
 mod_version=1.0.1
 maven_group=com.pathmind
 archives_base_name=pathmind
-
-# Dependencies
-fabric_api_version=0.133.4+1.21.8

src/main/java/com/pathmind/PathmindClientMod.java

@@ -10,7 +10,6 @@
 import net.fabricmc.api.ClientModInitializer;
 import net.fabricmc.fabric.api.client.event.lifecycle.v1.ClientLifecycleEvents;
 import net.fabricmc.fabric.api.client.event.lifecycle.v1.ClientTickEvents;
-import net.fabricmc.fabric.api.client.event.lifecycle.v1.ClientWorldEvents;
 import net.fabricmc.fabric.api.client.networking.v1.ClientPlayConnectionEvents;
 import net.fabricmc.fabric.api.client.rendering.v1.HudRenderCallback;
 import net.fabricmc.fabric.api.client.keybinding.v1.KeyBindingHelper;
@@ -58,14 +57,6 @@ public void onInitializeClient() {
             handleKeybinds(client);
         });
 
-        ClientWorldEvents.AFTER_CLIENT_WORLD_CHANGE.register((client, world) -> {
-            if (world != null) {
-                worldShutdownHandled = false;
-            } else {
-                handleClientShutdown("world change (null)", false);
-            }
-        });
-
         ClientPlayConnectionEvents.JOIN.register((handler, sender, client) -> {
             worldShutdownHandled = false;
         });

src/main/java/com/pathmind/PathmindMod.java

@@ -1,7 +1,9 @@
 package com.pathmind;
 
+import com.pathmind.util.VersionSupport;
 import net.fabricmc.api.ModInitializer;
 import net.fabricmc.fabric.api.event.lifecycle.v1.ServerTickEvents;
+import net.fabricmc.loader.api.FabricLoader;
 import net.minecraft.util.Identifier;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
@@ -21,6 +23,14 @@ public static Identifier id(String path) {
     @Override
     public void onInitialize() {
         LOGGER.info("Initializing Pathmind mod");
+
+        String minecraftVersion = FabricLoader.getInstance()
+            .getModContainer("minecraft")
+            .map(container -> container.getMetadata().getVersion().getFriendlyString())
+            .orElse("unknown");
+        if (!VersionSupport.isSupported(minecraftVersion)) {
+            LOGGER.warn("Pathmind targets Minecraft {} but detected {}", VersionSupport.SUPPORTED_RANGE, minecraftVersion);
+        }
 
         // Register server tick events
         ServerTickEvents.END_SERVER_TICK.register(server -> {