Update build scripts and configs for multi-platform support and improved automation

- Add and update build.gradle.kts files for common, fabric, and neoforge modules
- Integrate Parchment mappings and Kotlin support for both Fabric and NeoForge
- Enhance resource processing with dynamic property expansion
- Update gradle.properties with new dependency versions and mod metadata
- Refactor fabric.mod.json to use property placeholders
- Improve GitHub Actions workflow for consistent CI builds
- Adjust settings.gradle.kts for unified project configuration
- Minor code cleanup in ExampleMod.java

Author: Xyndra

neo/.github/workflows/build.yml .github/workflows/build.ymlneo/.github/workflows/build.yml renamed to .github/workflows/build.yml

@@ -1,5 +1,4 @@
 name: Build
-
 on: [push, pull_request]
 
 jobs:
@@ -11,20 +10,19 @@ jobs:
         with:
           fetch-depth: 0
           fetch-tags: true
-
       - name: Setup JDK 21
         uses: actions/setup-java@v4
         with:
           java-version: '21'
-          distribution: 'temurin'
-
-      - name: Setup Gradle
-        uses: gradle/actions/setup-gradle@v4
-
-      # This is needed to be able to run ./gradlew below
-      # You can run `git update-index --chmod +x gradlew` then remove this step.
+          distribution: 'microsoft'
+      - name: Validate Gradle wrapper
+        uses: gradle/actions/wrapper-validation@v4
       - name: Make Gradle wrapper executable
         run: chmod +x ./gradlew
-
       - name: Build with Gradle
-        run: ./gradlew build
+        run: ./gradlew build
+      - name: capture build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: Artifacts
+          path: '**/build/libs/'

build.gradle.kts

@@ -1,3 +1,15 @@
 plugins {
     kotlin("jvm") version "2.2.0" apply false
 }
+
+subprojects {
+    repositories {
+        maven {
+            name = "ParchmentMC"
+            url = uri("https://maven.parchmentmc.org")
+        }
+        mavenLocal()
+        mavenCentral()
+        google()
+    }
+}

common/build.gradle.kts

@@ -0,0 +1,13 @@
+plugins {
+    id("java-library")
+    id("maven-publish")
+    kotlin("jvm")
+}
+
+val modId: String by project
+val modVersion: String by project
+val minecraftVersion: String by project
+
+base {
+    archivesName = "$modId-$minecraftVersion-common-$modVersion"
+}

fabric/.github/workflows/build.yml

@@ -8,13 +8,17 @@ val minecraftVersion: String by project
 val loaderVersion: String by project
 val fabricVersion: String by project
 val fabricKotlinVersion: String by project
-
+val parchmentVersion: String by project
+val modName: String by project
+val modDescription: String by project
+val modAuthors: String by project
+val modLicense: String by project
 val modVersion: String by project
 val mavenGroup: String by project
 val modId: String by project
 
 base {
-	archivesName = modId
+	archivesName = "$modId-$minecraftVersion-fabric-$modVersion"
 }
 
 repositories {
@@ -34,17 +38,37 @@ fabricApi {
 dependencies {
 	// To change the versions see the gradle.properties file
 	minecraft("com.mojang:minecraft:${minecraftVersion}")
-	mappings(loom.officialMojangMappings())
+	mappings(loom.layered {
+		officialMojangMappings()
+		parchment("org.parchmentmc.data:parchment-${minecraftVersion}:${parchmentVersion}")
+	})
 	modImplementation("net.fabricmc:fabric-loader:${loaderVersion}")
 
 	// Fabric API. This is technically optional, but you probably want it anyway.
 	modImplementation("net.fabricmc.fabric-api:fabric-api:${fabricVersion}")
 	modImplementation("net.fabricmc:fabric-language-kotlin:${fabricKotlinVersion}")
+
+	implementation(project(":common"))
 }
 
+val replacements = mapOf(
+	"minecraft_version" to minecraftVersion,
+	"loader_version" to loaderVersion,
+	"fabric_version" to fabricVersion,
+	"fabric_kotlin_version" to fabricKotlinVersion,
+	"parchment_version" to parchmentVersion,
+	"mod_version" to modVersion,
+	"group_id" to mavenGroup,
+	"mod_name" to modName,
+	"mod_description" to modDescription,
+	"mod_authors" to modAuthors.replace(", ", "\", \""),
+	"mod_license" to modLicense,
+	"mod_id" to modId
+)
+
 tasks.named<ProcessResources>("processResources") {
-	filesMatching("fabric.mod.json") {
-		expand("version" to modVersion)
+	filesNotMatching(mutableSetOf("**/*.png")) {
+		expand(replacements)
 	}
 }
 

fabric/build.gradle.kts

@@ -1,17 +1,17 @@
 {
 	"schemaVersion": 1,
-	"id": "examplemod",
-	"version": "${version}",
-	"name": "Example Mod",
-	"description": "This is an example description! Tell everyone what your mod is about!",
+	"id": "${mod_id}",
+	"version": "${mod_version}",
+	"name": "${mod_name}",
+	"description": "${mod_description}",
 	"authors": [
-		"Me!"
+		"${mod_authors}"
 	],
 	"contact": {
 		"homepage": "https://fabricmc.net/",
 		"sources": "https://github.com/FabricMC/fabric-example-mod"
 	},
-	"license": "CC0-1.0",
+	"license": "${mod_license}",
 	"icon": "assets/examplemod/icon.png",
 	"environment": "*",
 	"entrypoints": {

fabric/src/main/resources/fabric.mod.json

@@ -2,16 +2,16 @@
 org.gradle.jvmargs=-Xmx1G
 org.gradle.daemon=true
 org.gradle.parallel=true
-org.gradle.caching=true
-org.gradle.configuration-cache=true
 
 # General Properties
 minecraftVersion=1.21.6
+parchmentVersion=BLEEDING-20250629.110335-3
 modVersion=1.0.0
 mavenGroup=com.example
 modId=examplemod
 modName=Example Mod
 modLicense=All Rights Reserved
+# Note: keep authors seperated by ", " and not by "," or anything else
 modAuthors=YourNameHere, OtherNameHere
 modDescription=Example mod description.\nNewline characters can be used and will be replaced properly.
 
@@ -24,10 +24,6 @@ fabricKotlinVersion=1.13.4+kotlin.2.2.0
 # Fabric Dependencies
 fabricVersion=0.128.1+1.21.6
 
-# read more on this at https://github.com/neoforged/NeoGradle/blob/NG_7.0/README.md#apply-parchment-mappings
-# you can also find the latest versions at: https://parchmentmc.org/docs/getting-started
-neogradle.subsystems.parchment.minecraftVersion=1.21.5
-neogradle.subsystems.parchment.mappingsVersion=2025.06.15
 # Environment Properties
 # You can find the latest versions here: https://projects.neoforged.net/neoforged/neoforge
 # The Minecraft version must agree with the Neo version to get a valid artifact
@@ -39,3 +35,4 @@ minecraftVersionRange=[1.21.6]
 neoVersion=21.6.20-beta
 # The Neo version range can use any version of Neo as bounds
 neoVersionRange=[21.6.20-beta,)
+kotlinForForgeVersion=5.9.0

gradle.properties

@@ -2,43 +2,68 @@ plugins {
     id("java-library")
     id("maven-publish")
     id("net.neoforged.gradle.userdev") version "7.0.189"
+    kotlin("jvm")
 }
 
 val mavenGroup: String by project
 val modId: String by project
 val minecraftVersion: String by project
 val minecraftVersionRange: String by project
+val parchmentVersion: String by project
 val neoVersion: String by project
 val neoVersionRange: String by project
 val modName: String by project
 val modLicense: String by project
 val modVersion: String by project
 val modAuthors: String by project
 val modDescription: String by project
+val kotlinForForgeVersion: String by project
 
 repositories {
+    maven {
+        name = "Kotlin for Forge"
+        url = uri("https://thedarkcolour.github.io/KotlinForForge/")
+        content { includeGroup("thedarkcolour")}
+    }
     // Add here additional repositories if required by some of the dependencies below.
 }
 
 base {
-    archivesName = modId
+    archivesName = "$modId-$minecraftVersion-neoforge-$modVersion"
 }
 
 // Mojang ships Java 21 to end users starting in 1.20.5, so mods should target Java 21.
 java {
-    sourceCompatibility = JavaVersion.VERSION_21
-    targetCompatibility = JavaVersion.VERSION_21
+    toolchain {
+        languageVersion = JavaLanguageVersion.of(21)
+    }
+}
+
+tasks.withType<org.jetbrains.kotlin.gradle.tasks.KotlinCompile>().configureEach {
+    compilerOptions {
+        jvmTarget.set(org.jetbrains.kotlin.gradle.dsl.JvmTarget.JVM_21)
+    }
 }
 
+
 //minecraft.accessTransformers.file rootProject.file("src/main/resources/META-INF/accesstransformer.cfg")
 //minecraft.accessTransformers.entry public net.minecraft.client.Minecraft textureManager # textureManager
 
+// minecraftVersion is also a variable name used by the parchment plugin.
+val outerMinecraftVersion = minecraftVersion
+subsystems {
+    parchment {
+        addRepository(false)
+        parchmentArtifact("org.parchmentmc.data:parchment-${outerMinecraftVersion}:${parchmentVersion}")
+    }
+}
+
 // Default run configurations.
 // These can be tweaked, removed, or duplicated as needed.
 runs {
     // applies to all the run configs below
     configureEach {
-        // Recommended logging data for a userdev environment
+        // Recommended logging data for an userdev environment
         // The markers can be added/remove as needed separated by commas.
         // "SCAN": For mods scan.
         // "REGISTRIES": For firing of registry events.
@@ -123,8 +148,8 @@ dependencies {
     // Example mod dependency using a file as dependency
     // implementation files("libs/coolmod-${mc_version}-${coolmod_version}.jar")
 
-    // Example project dependency using a sister or child project:
-    // implementation project(":myproject")
+    implementation(project(":common"))
+    implementation("thedarkcolour:kotlinforforge-neoforge:$kotlinForForgeVersion")
 
     // For more info:
     // http://www.gradle.org/docs/current/userguide/artifact_dependencies_tutorial.html
@@ -149,9 +174,7 @@ tasks.withType<ProcessResources>().configureEach {
         "mod_description" to modDescription,
     )
     inputs.properties(replaceProperties)
-    filesMatching("META-INF/neoforge.mods.toml") {
-        expand(replaceProperties)
-    }
+    expand(replaceProperties)
 }
 
 // Example configuration to allow publishing using the maven-publish plugin

neo/build.gradle.kts

@@ -119,7 +119,7 @@ public void onServerStarting(ServerStartingEvent event) {
     }
 
     // You can use EventBusSubscriber to automatically register all static methods in the class annotated with @SubscribeEvent
-    @EventBusSubscriber(modid = MODID, bus = EventBusSubscriber.Bus.MOD, value = Dist.CLIENT)
+    @EventBusSubscriber(modid = MODID, value = Dist.CLIENT)
     public static class ClientModEvents {
         @SubscribeEvent
         public static void onClientSetup(FMLClientSetupEvent event) {

neo/src/main/java/com/example/examplemod/ExampleMod.java

@@ -14,12 +14,11 @@ pluginManagement {
 	val loomVersion: String by settings
 	plugins {
 		id("fabric-loom") version loomVersion apply false
+		id("org.gradle.toolchains.foojay-resolver-convention") version "0.9.0"
 	}
 }
 
-plugins {
-    id("org.gradle.toolchains.foojay-resolver-convention") version "0.9.0"
-}
+
 
 val modName: String by settings
 rootProject.name = modName