Add mod

.github/workflows/mod-ci.yml

@@ -0,0 +1,196 @@
+name: Mod CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: mod
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Java
+        uses: actions/setup-java@v4
+        with:
+          distribution: temurin
+          java-version: "21"
+
+      - name: Set up Gradle
+        uses: gradle/actions/setup-gradle@v4
+        with:
+          gradle-version: "8.10.2"
+
+      - name: Validate matrix and run common tests
+        run: |
+          chmod +x ./gradlew
+          ./gradlew validateModMatrix :common:test --stacktrace --info
+
+      - name: Upload Gradle reports
+        if: failure()
+        uses: actions/upload-artifact@v4
+        with:
+          name: mod-validate-gradle-reports
+          path: |
+            mod/**/build/reports/**
+            mod/**/build/test-results/**
+
+  build:
+    runs-on: ubuntu-latest
+    needs: validate
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - minecraft-version: "1.21.2"
+            loader: fabric
+          - minecraft-version: "1.21.2"
+            loader: neoforge
+          - minecraft-version: "1.21.4"
+            loader: fabric
+          - minecraft-version: "1.21.4"
+            loader: forge
+          - minecraft-version: "1.21.4"
+            loader: neoforge
+          - minecraft-version: "1.21.5"
+            loader: fabric
+          - minecraft-version: "1.21.5"
+            loader: forge
+          - minecraft-version: "1.21.5"
+            loader: neoforge
+          - minecraft-version: "1.21.6"
+            loader: fabric
+          - minecraft-version: "1.21.6"
+            loader: forge
+          - minecraft-version: "1.21.6"
+            loader: neoforge
+          - minecraft-version: "1.21.7"
+            loader: fabric
+          - minecraft-version: "1.21.7"
+            loader: forge
+          - minecraft-version: "1.21.7"
+            loader: neoforge
+          - minecraft-version: "1.21.8"
+            loader: fabric
+          - minecraft-version: "1.21.8"
+            loader: forge
+          - minecraft-version: "1.21.8"
+            loader: neoforge
+          - minecraft-version: "1.21.9"
+            loader: fabric
+          - minecraft-version: "1.21.9"
+            loader: forge
+          - minecraft-version: "1.21.9"
+            loader: neoforge
+          - minecraft-version: "1.21.10"
+            loader: fabric
+          - minecraft-version: "1.21.10"
+            loader: forge
+          - minecraft-version: "1.21.10"
+            loader: neoforge
+          - minecraft-version: "1.21.11"
+            loader: fabric
+          - minecraft-version: "1.21.11"
+            loader: forge
+          - minecraft-version: "1.21.11"
+            loader: neoforge
+
+    defaults:
+      run:
+        working-directory: mod
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Java
+        uses: actions/setup-java@v4
+        with:
+          distribution: temurin
+          java-version: "21"
+
+      - name: Set up Gradle
+        uses: gradle/actions/setup-gradle@v4
+        with:
+          gradle-version: "8.10.2"
+
+      - name: Build matrix project
+        id: build
+        env:
+          MINECRAFT_VERSION: ${{ matrix.minecraft-version }}
+          LOADER: ${{ matrix.loader }}
+        run: |
+          chmod +x ./gradlew
+          set -o pipefail
+          VERSION_KEY="${MINECRAFT_VERSION//./_}"
+          TASK=":versions:mc_${VERSION_KEY}:${LOADER}:build"
+          LOG_FILE="build-${MINECRAFT_VERSION}-${LOADER}.log"
+          echo "Building ${TASK}"
+          ./gradlew "${TASK}" --stacktrace --info 2>&1 | tee "${LOG_FILE}"
+          echo "log_file=${LOG_FILE}" >> "${GITHUB_OUTPUT}"
+
+      - name: Write failure summary
+        if: failure()
+        env:
+          MINECRAFT_VERSION: ${{ matrix.minecraft-version }}
+          LOADER: ${{ matrix.loader }}
+        run: |
+          LOG_FILE="${{ steps.build.outputs.log_file }}"
+          VERSION_KEY="${MINECRAFT_VERSION//./_}"
+          {
+            echo "### Mod build failed: ${LOADER} / ${MINECRAFT_VERSION}"
+            echo ""
+            echo "**Gradle task:** \`:versions:mc_${VERSION_KEY}:${LOADER}:build\`"
+            echo ""
+            if [ -f "${LOG_FILE}" ]; then
+              echo "#### Error highlights"
+              echo '```text'
+              grep -E "FAILURE:|What went wrong:|Execution failed for task|error:|Caused by:|> Could not|BUILD FAILED" "${LOG_FILE}" | tail -n 40 || true
+              echo '```'
+              echo ""
+              echo "#### Last 120 log lines"
+              echo '```text'
+              tail -n 120 "${LOG_FILE}"
+              echo '```'
+            else
+              echo "No build log was captured."
+            fi
+          } >> "${GITHUB_STEP_SUMMARY}"
+
+      - name: Upload Gradle reports
+        if: failure()
+        uses: actions/upload-artifact@v4
+        with:
+          name: mod-${{ matrix.minecraft-version }}-${{ matrix.loader }}-gradle-reports
+          path: |
+            mod/**/build/reports/**
+            mod/**/build/test-results/**
+            mod/**/build/tmp/**
+            mod/build-*.log
+
+  summary:
+    runs-on: ubuntu-latest
+    needs: [validate, build]
+    if: always()
+    steps:
+      - name: Report overall mod CI status
+        run: |
+          {
+            echo "### Mod CI summary"
+            echo ""
+            echo "- validate: ${{ needs.validate.result }}"
+            echo "- build matrix: ${{ needs.build.result }}"
+          } >> "${GITHUB_STEP_SUMMARY}"
+
+          if [ "${{ needs.validate.result }}" != "success" ] || [ "${{ needs.build.result }}" != "success" ]; then
+            echo "One or more mod CI jobs failed. Open the failed matrix job for the detailed Gradle log summary."
+            exit 1
+          fi

.gitignore

@@ -17,4 +17,7 @@ highlighter/node_modules/
 highlighter/dist/
 highlighter/*.vsix
 npm/node_modules/
-npm/*.tgz
+npm/*.tgz
+mod/.gradle/
+mod/build/
+mod/**/build/

minecraft_script/shell_commands.py

@@ -6,7 +6,7 @@
 from .common import COMMON_CONFIG, version
 from .config_utils import update_config, reset_config
 from .lint import lint_code
-from .version_config import breaking_changes_between
+from .version_config import breaking_changes_between, load_version_profile
 from pathlib import Path
 
 
@@ -80,6 +80,16 @@ def sh_debug(*args) -> None:
 
 def sh_compile(*args) -> None:
     # Manage args & parameters:
+    args = list(args)
+    minecraft_version = None
+    if "--minecraft-version" in args:
+        version_index = args.index("--minecraft-version")
+        if version_index + 1 >= len(args):
+            print("No version specified after --minecraft-version.")
+            exit(1)
+        minecraft_version = args[version_index + 1]
+        del args[version_index:version_index + 2]
+
     arg_count = len(args)
     if arg_count < 1:
         print("No path specified to compile.")
@@ -114,7 +124,19 @@ def sh_compile(*args) -> None:
     with open(source_path, 'rt', encoding='utf-8') as mcs_file:
         code = mcs_file.read()
 
-    build_datapack(code, datapack_name, str(output_path), verbose, source_path=source_path)
+    previous_version = COMMON_CONFIG["minecraft_version"]
+    if minecraft_version is not None:
+        try:
+            load_version_profile(minecraft_version)
+        except FileNotFoundError as error:
+            print(f"Error: {error}")
+            exit(1)
+        COMMON_CONFIG["minecraft_version"] = minecraft_version
+
+    try:
+        build_datapack(code, datapack_name, str(output_path), verbose, source_path=source_path)
+    finally:
+        COMMON_CONFIG["minecraft_version"] = previous_version
 
 
 def sh_config(*args) -> None:

mod/build.gradle

@@ -0,0 +1,121 @@
+plugins {
+    id "java"
+    id "dev.architectury.loom" version "${architectury_loom_version}" apply false
+    id "architectury-plugin" version "${architectury_plugin_version}" apply false
+}
+
+ext.modSupportedMinecraftVersions = [
+    "1.21.2",
+    "1.21.4",
+    "1.21.5",
+    "1.21.6",
+    "1.21.7",
+    "1.21.8",
+    "1.21.9",
+    "1.21.10",
+    "1.21.11",
+]
+
+ext.modLoaders = ["fabric", "forge", "neoforge"]
+
+ext.fabricApiVersions = [
+    "1.21.2": "0.106.1+1.21.2",
+    "1.21.4": "0.119.4+1.21.4",
+    "1.21.5": "0.128.2+1.21.5",
+    "1.21.6": "0.128.2+1.21.6",
+    "1.21.7": "0.129.0+1.21.7",
+    "1.21.8": "0.136.1+1.21.8",
+    "1.21.9": "0.134.1+1.21.9",
+    "1.21.10": "0.138.4+1.21.10",
+    "1.21.11": "0.141.4+1.21.11",
+]
+
+ext.forgeVersions = [
+    "1.21.2": null,
+    "1.21.4": "1.21.4-54.1.16",
+    "1.21.5": "1.21.5-55.1.10",
+    "1.21.6": "1.21.6-56.0.4",
+    "1.21.7": "1.21.7-57.0.3",
+    "1.21.8": "1.21.8-58.1.18",
+    "1.21.9": "1.21.9-59.0.5",
+    "1.21.10": "1.21.10-60.1.9",
+    "1.21.11": "1.21.11-61.1.8",
+]
+
+ext.neoForgeVersions = [
+    "1.21.2": "21.2.1-beta",
+    "1.21.4": "21.4.157",
+    "1.21.5": "21.5.97",
+    "1.21.6": "21.6.20-beta",
+    "1.21.7": "21.7.25-beta",
+    "1.21.8": "21.8.53",
+    "1.21.9": "21.9.16-beta",
+    "1.21.10": "21.10.64",
+    "1.21.11": "21.11.42",
+]
+
+allprojects {
+    group = mod_group
+    version = mod_version
+}
+
+subprojects { project ->
+    apply plugin: "java"
+
+    java {
+        toolchain {
+            languageVersion = JavaLanguageVersion.of(21)
+        }
+    }
+
+    tasks.withType(JavaCompile).configureEach {
+        options.encoding = "UTF-8"
+        options.release = 21
+    }
+
+    repositories {
+        maven { url = "https://maven.fabricmc.net/" }
+        maven { url = "https://maven.minecraftforge.net/" }
+        maven { url = "https://maven.neoforged.net/releases/" }
+        maven { url = "https://maven.architectury.dev/" }
+        mavenCentral()
+    }
+}
+
+project(":common") {
+    dependencies {
+        testImplementation platform("org.junit:junit-bom:5.10.3")
+        testImplementation "org.junit.jupiter:junit-jupiter"
+    }
+
+    test {
+        useJUnitPlatform()
+    }
+}
+
+tasks.register("validateModMatrix") {
+    inputs.file(rootProject.file("../minecraft_script/versions/index.json"))
+    doLast {
+        def index = new groovy.json.JsonSlurper().parse(rootProject.file("../minecraft_script/versions/index.json"))
+        def expectedVersions = index.supported.findAll { it != "26.1" }
+        if (expectedVersions != modSupportedMinecraftVersions) {
+            throw new GradleException("modSupportedMinecraftVersions must equal versions/index.json supported minus 26.1. expected=${expectedVersions}, actual=${modSupportedMinecraftVersions}")
+        }
+
+        def missingProjects = []
+        expectedVersions.each { mcVersion ->
+            modLoaders.each { loader ->
+                if (loader == "forge" && forgeVersions[mcVersion] == null) {
+                    return
+                }
+                def projectPath = ":versions:mc_${mcVersion.replace(".", "_")}:${loader}"
+                if (findProject(projectPath) == null) {
+                    missingProjects.add(projectPath)
+                }
+            }
+        }
+        if (!missingProjects.isEmpty()) {
+            throw new GradleException("Missing mod matrix projects: ${missingProjects.join(", ")}")
+        }
+    }
+}