Bring Building Pieces to Forge 26.3

.gitattributes

@@ -5,8 +5,21 @@
 *.md text eol=lf
 *.gradle text eol=lf
 *.properties text eol=lf
+*.mcmeta text eol=lf
+*.py text eol=lf
+*.toml text eol=lf
 *.yml text eol=lf
 gradlew text eol=lf
 *.bat text eol=crlf
 *.png binary
 *.jar binary
+*.zip binary
+*.nbt binary
+
+# Keep build scripts and the sealed Mavenizer fixture stable on Windows.
+.gitattributes text eol=lf
+*.js text eol=lf
+ci-fixtures/tools/** -text
+
+# Keep the signed-off registry proof bytes unchanged on every checkout.
+src/testFixtures/worlds/*.forge61-registry.json -text whitespace=cr-at-eol

.github/workflows/ci.yml

@@ -1,22 +1,76 @@
-name: Sky's Building Pieces CI
+name: Sky's Building Pieces 26.3 CI
 
 on:
   push:
     branches:
-      - 'master-*'
+      - master-26.3
       - 'feature/**'
   pull_request:
     branches:
-      - 'master-*'
+      - master-26.3
 
 permissions:
   contents: read
 
 concurrency:
-  group: skysbuildingpieces-${{ github.workflow }}-${{ github.ref }}
+  group: skysbuildingpieces-26.3-${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: true
 
 jobs:
+  cold-forge-bootstrap:
+    name: Cold Forge bootstrap
+    runs-on: ubuntu-latest
+    timeout-minutes: 60
+
+    steps:
+      - name: Check out source
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+
+      - name: Install pinned Java 25 runtime and toolchain
+        uses: actions/setup-java@b6effb05e454b25005698d916606bdc6ffcbf961 # v5
+        with:
+          distribution: temurin
+          java-version: '25.0.3+9.0.LTS'
+
+      - name: Pin production Java
+        run: |
+          echo "SBP_JAVA25_HOME=$JAVA_HOME" >> "$GITHUB_ENV"
+
+      - name: Bootstrap Forge from an empty cache
+        shell: bash
+        env:
+          GRADLE_USER_HOME: ${{ runner.temp }}/skysbuildingpieces-cold-gradle
+        run: |
+          set -euo pipefail
+          test ! -e .gradle
+          test ! -e "$GRADLE_USER_HOME"
+          mkdir -p "$GRADLE_USER_HOME"
+          chmod +x ./gradlew
+          gradle_args=(
+            classes test
+            --no-daemon --no-build-cache --stacktrace --max-workers=2
+            -Dorg.gradle.java.installations.paths="$JAVA_HOME"
+            -Dorg.gradle.java.installations.auto-detect=false
+            -Dorg.gradle.java.installations.auto-download=false
+          )
+          ./gradlew "${gradle_args[@]}"
+
+      - name: Verify same-cache bootstrap offline
+        shell: bash
+        env:
+          ORESPAWN_MAVENIZER_OFFLINE: 'true'
+          GRADLE_USER_HOME: ${{ runner.temp }}/skysbuildingpieces-cold-gradle
+        run: |
+          set -euo pipefail
+          gradle_args=(
+            classes test
+            --rerun-tasks --offline --no-daemon --no-build-cache --stacktrace --max-workers=2
+            -Dorg.gradle.java.installations.paths="$JAVA_HOME"
+            -Dorg.gradle.java.installations.auto-detect=false
+            -Dorg.gradle.java.installations.auto-download=false
+          )
+          ./gradlew "${gradle_args[@]}"
+
   build:
     name: Build, test, and audit
     runs-on: ubuntu-latest
@@ -26,73 +80,95 @@ jobs:
       - name: Check out source
         uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
 
-      - name: Read target build metadata
+      - name: Read target Java metadata
         id: target
         shell: bash
         run: |
           set -euo pipefail
           value() { sed -n "s/^$1=//p" gradle.properties; }
-          toolchain="$(value java_toolchain_version)"
-          selector="$(value java_setup_version)"
-          echo "java_setup_version=${selector:-$toolchain}" >> "$GITHUB_OUTPUT"
-          echo "java_version=$(value java_version)" >> "$GITHUB_OUTPUT"
-          echo "minecraft_version=$(value minecraft_version)" >> "$GITHUB_OUTPUT"
-          echo "gradle_java_version=$(value gradle_java_version)" >> "$GITHUB_OUTPUT"
-          echo "artifact_prefix=SkysBuildingPieces-$(value mod_version)" >> "$GITHUB_OUTPUT"
-
-      - name: Install target Java toolchain
+          test "$(value java_toolchain_version)" = "$(value gradle_java_toolchain_version)"
+          echo "java_setup_version=$(value java_setup_version)" >> "$GITHUB_OUTPUT"
+
+      - name: Install pinned Java 25 runtime and toolchain
         uses: actions/setup-java@b6effb05e454b25005698d916606bdc6ffcbf961 # v5
         with:
           distribution: temurin
           java-version: ${{ steps.target.outputs.java_setup_version }}
 
-      - name: Pin production Java
-        if: steps.target.outputs.java_version == '8'
+      - name: Pin production Java for coordinated builds
+        shell: bash
         run: |
-          echo "SGS_JAVA8_HOME=$JAVA_HOME" >> "$GITHUB_ENV"
-          echo "SBP_JAVA8_HOME=$JAVA_HOME" >> "$GITHUB_ENV"
-          echo "STS_JAVA8_HOME=$JAVA_HOME" >> "$GITHUB_ENV"
-
-      - name: Install Java for Gradle
-        uses: actions/setup-java@b6effb05e454b25005698d916606bdc6ffcbf961 # v5
-        with:
-          distribution: microsoft
-          java-version: ${{ steps.target.outputs.gradle_java_version }}
+          set -euo pipefail
+          for prefix in SGS SBP STS; do
+            echo "${prefix}_JAVA25_HOME=$JAVA_HOME" >> "$GITHUB_ENV"
+          done
 
       - name: Set up Gradle
         uses: gradle/actions/setup-gradle@9c971963bec38e04b3d30dcc455b5382be2fdbfb # v6
 
-
       - name: Make the wrapper executable
         run: chmod +x ./gradlew
 
+      - name: Read coordinated Grass Slabs source pin
+        id: grass
+        shell: bash
+        run: |
+          set -euo pipefail
+          commit="$(sed -n 's/^source.commit=//p' gradle/grass-slabs-release.properties)"
+          [[ "$commit" =~ ^[0-9a-f]{40}$ ]]
+          echo "commit=$commit" >> "$GITHUB_OUTPUT"
+
+      - name: Check out pinned Grass Slabs source
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+        with:
+          repository: MinecraftModDevelopmentMods/SkysGrassSlabs
+          ref: ${{ steps.grass.outputs.commit }}
+          path: .gradle/qualification-sources/grass-slabs
+
+      - name: Build pinned optional Grass Slabs dependency
+        shell: bash
+        run: |
+          set -euo pipefail
+          dependency="$GITHUB_WORKSPACE/.gradle/qualification-sources/grass-slabs"
+          chmod +x "$dependency/gradlew"
+          "$dependency/gradlew" -p "$dependency" assemble --no-daemon --stacktrace \
+            -Dorg.gradle.java.installations.paths="$JAVA_HOME"
+          version="$(sed -n 's/^version=//p' gradle/grass-slabs-release.properties)"
+          echo "ORG_GRADLE_PROJECT_grassSlabsMainJar=$dependency/build/libs/SkysGrassSlabs-$version.jar" >> "$GITHUB_ENV"
+
       - name: Build, test, and audit release artifacts
         run: >-
           ./gradlew clean check integrationTest build javadoc verifyReleaseArtifacts writeReleaseChecksums
-          verifyEclipseProductionClasspath  --no-daemon --stacktrace
+          verifyEclipseProductionClasspath --no-daemon --stacktrace
+          -Dorg.gradle.java.installations.paths="$JAVA_HOME"
+          -Dorg.gradle.java.installations.auto-detect=false
+          -Dorg.gradle.java.installations.auto-download=false
 
       - name: Replay artifact checks offline
+        env:
+          ORESPAWN_MAVENIZER_OFFLINE: 'true'
         run: >-
           ./gradlew assemble verifyReleaseArtifacts writeReleaseChecksums --offline --no-daemon --stacktrace
+          -Dorg.gradle.java.installations.paths="$JAVA_HOME"
 
       - name: Upload audited release candidate
         uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
         with:
-          name: SkysBuildingPieces-${{ steps.target.outputs.minecraft_version }}-${{ github.sha }}
+          name: SkysBuildingPieces-26.3-${{ github.sha }}
           if-no-files-found: error
           retention-days: 30
           path: |
-            build/libs/${{ steps.target.outputs.artifact_prefix }}.jar
-            build/libs/${{ steps.target.outputs.artifact_prefix }}-sources.jar
-            build/libs/${{ steps.target.outputs.artifact_prefix }}-javadoc.jar
+            build/libs/SkysBuildingPieces-0.3.9.2603001.jar
+            build/libs/SkysBuildingPieces-0.3.9.2603001-sources.jar
+            build/libs/SkysBuildingPieces-0.3.9.2603001-javadoc.jar
             build/release/SHA256SUMS
             CHANGELOG.md
 
       - name: Upload diagnostics on failure
         if: failure()
         uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
         with:
-          name: SkysBuildingPieces-${{ steps.target.outputs.minecraft_version }}-diagnostics-${{ github.sha }}
+          name: SkysBuildingPieces-26.3-diagnostics-${{ github.sha }}
           if-no-files-found: ignore
           retention-days: 14
           path: |

.github/workflows/codeql-analysis.yml

@@ -3,11 +3,11 @@ name: CodeQL
 on:
   push:
     branches:
-      - 'master-*'
+      - master-26.3
       - 'feature/**'
   pull_request:
     branches:
-      - 'master-*'
+      - master-26.3
   schedule:
     - cron: '47 7 * * 4'
 
@@ -40,24 +40,33 @@ jobs:
           echo "gradle_java_version=$(value gradle_java_version)" >> "$GITHUB_OUTPUT"
           echo "artifact_prefix=SkysBuildingPieces-$(value mod_version)" >> "$GITHUB_OUTPUT"
 
+      - name: Install Mavenizer Java runtime
+        uses: actions/setup-java@b6effb05e454b25005698d916606bdc6ffcbf961 # v5
+        with:
+          distribution: temurin
+          java-version: '25.0.3+9.0.LTS'
+
       - name: Install target Java toolchain
         uses: actions/setup-java@b6effb05e454b25005698d916606bdc6ffcbf961 # v5
         with:
           distribution: temurin
           java-version: ${{ steps.target.outputs.java_setup_version }}
 
       - name: Pin production Java
-        if: steps.target.outputs.java_version == '8'
+        shell: bash
         run: |
-          echo "SGS_JAVA8_HOME=$JAVA_HOME" >> "$GITHUB_ENV"
-          echo "SBP_JAVA8_HOME=$JAVA_HOME" >> "$GITHUB_ENV"
-          echo "STS_JAVA8_HOME=$JAVA_HOME" >> "$GITHUB_ENV"
+          set -euo pipefail
+          java_version="${{ steps.target.outputs.java_version }}"
+          [[ "$java_version" =~ ^[0-9]+$ ]]
+          for prefix in SGS SBP STS; do
+            echo "${prefix}_JAVA${java_version}_HOME=$JAVA_HOME" >> "$GITHUB_ENV"
+          done
 
       - name: Install Java for Gradle
         uses: actions/setup-java@b6effb05e454b25005698d916606bdc6ffcbf961 # v5
         with:
-          distribution: microsoft
-          java-version: ${{ steps.target.outputs.gradle_java_version }}
+          distribution: temurin
+          java-version: '25.0.3+9.0.LTS'
 
       - name: Set up Gradle
         uses: gradle/actions/setup-gradle@9c971963bec38e04b3d30dcc455b5382be2fdbfb # v6
@@ -71,7 +80,8 @@ jobs:
       - name: Compile production code
         run: |
           chmod +x ./gradlew
-          ./gradlew clean classes  --rerun-tasks --no-daemon --stacktrace
+          ./gradlew clean classes --rerun-tasks --no-daemon --stacktrace \
+            -Dorg.gradle.java.installations.paths="$JAVA_HOME"
 
       - name: Analyze
         uses: github/codeql-action/analyze@db488ddef3bf6cb639b32c2e9a7c0a7ea8271d28 # v4

.gitignore

@@ -77,3 +77,8 @@ agent_notes/
 # Files from Forge MDK
 forge*changelog.txt
 /README.txt
+
+# Resource-generation tools
+__pycache__/
+*.py[cod]
+.pytest_cache/