chore: promote dev to main (#90)

Release v1.5.0 from the validated dev integration branch.

Author: Arbousier1

.gitattributes

@@ -0,0 +1,12 @@
+* text=auto eol=lf
+
+*.bat text eol=crlf
+*.cmd text eol=crlf
+
+*.dat binary
+*.dll binary
+*.dylib binary
+*.jar binary
+*.png binary
+*.so binary
+*.zip binary

.github/CONTRIBUTING.md

@@ -1,6 +1,6 @@
 # Contributing
 
-Thanks for helping improve MahjongEngine.
+Thanks for helping improve MahjongPaper.
 
 ## Before You Start
 
@@ -11,7 +11,7 @@ Thanks for helping improve MahjongEngine.
 ## Local Setup
 
 1. Fork and clone the repository.
-2. Use JDK 21+ for the default build. The released jar is built with Java 17 bytecode and `api-version: 1.20`, so a single jar runs on Paper/Folia 1.20.1 through 26.2.
+2. Use JDK 21+ for the default build. The released jar is built with Java 21 bytecode and `api-version: 1.20`, so the server runtime must use Java 21 or newer while one jar continues to cover Paper/Folia 1.20.1 through 26.2.
 3. Build the project:
 
 ```powershell
@@ -24,7 +24,7 @@ To validate source/API compatibility against Paper 26.2:
 .\gradlew.bat test "-PmahjongPaperDevBundle=26.2-rc-2.build.9-alpha" -PmahjongJavaToolchain=25 -PmahjongJavaTarget=25
 ```
 
-This command is only a compatibility check. Release artifacts should use the default build so the distributed jar remains compatible with the whole supported server range.
+This command is only a high-version source/API compatibility check. Release artifacts use the Java 21 default target so the distributed jar remains compatible with the whole supported server range.
 
 ## Development Workflow
 

.github/dependabot.yml

@@ -2,6 +2,7 @@ version: 2
 updates:
   - package-ecosystem: "gradle"
     directory: "/"
+    target-branch: "dev"
     schedule:
       interval: "weekly"
       day: "monday"
@@ -22,6 +23,7 @@ updates:
 
   - package-ecosystem: "github-actions"
     directory: "/"
+    target-branch: "dev"
     schedule:
       interval: "weekly"
       day: "monday"

.github/workflows/build.yml

@@ -3,17 +3,19 @@ name: Build
 on:
   push:
     branches:
-      - main
       - dev
   pull_request:
+    branches:
+      - main
+      - dev
   workflow_dispatch:
 
 jobs:
   wrapper-validation:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
       - name: Validate Gradle wrapper
         uses: gradle/actions/wrapper-validation@v6
 
@@ -22,7 +24,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
 
       - name: Set up JDK 25
         uses: actions/setup-java@v5
@@ -46,7 +48,7 @@ jobs:
         # Gate the build on tests so a native-platform build never ships a jar
         # with broken Java/Kotlin. Native tasks are skipped here; they are
         # exercised in the build-platform matrix below.
-        run: ./gradlew test "-PmahjongPaperDevBundle=1.20.1-R0.1-SNAPSHOT" "-PmahjongJavaToolchain=25" "-PmahjongJavaTarget=17" -x configureGbMahjongNative -x buildGbMahjongNative -x packageGbMahjongNative
+        run: ./gradlew test "-PmahjongPaperDevBundle=1.20.1-R0.1-SNAPSHOT" "-PmahjongJavaToolchain=25" "-PmahjongJavaTarget=21" -x configureGbMahjongNative -x buildGbMahjongNative -x packageGbMahjongNative
 
   build-platform:
     needs: test-gate
@@ -74,10 +76,10 @@ jobs:
 
     steps:
       - name: Checkout
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
 
       - name: Cache native build (CMake)
-        uses: actions/cache@v4
+        uses: actions/cache@v6
         with:
           path: |
             build/native/gbmahjong
@@ -126,7 +128,7 @@ jobs:
         # Pin to the lowest supported Paper baseline so the released jar stays runtime-compatible
         # with Paper/Folia 1.20.1 -> 26.2. PaperCompatibility handles newer APIs at runtime.
         # Quote each -P argument because PowerShell on Windows runners mis-parses `1.20.1-R0.1-SNAPSHOT`.
-        run: ${{ matrix.gradle }} build -x test "-PmahjongPaperDevBundle=1.20.1-R0.1-SNAPSHOT" "-PmahjongJavaTarget=17" "-PmahjongJavaToolchain=25"
+        run: ${{ matrix.gradle }} build "-PmahjongPaperDevBundle=1.20.1-R0.1-SNAPSHOT" "-PmahjongJavaTarget=21" "-PmahjongJavaToolchain=25" "-PmahjongRequireNative=true"
 
       - name: Verify artifact compatibility (Linux only)
         if: runner.os == 'Linux'
@@ -147,7 +149,7 @@ jobs:
           python3 - "$JAR" <<'PY'
           import sys, zipfile, struct
           jar = sys.argv[1]
-          allowed_max = 61  # Java 17
+          allowed_max = 65  # Java 21
           bad = []
           with zipfile.ZipFile(jar) as z:
               for n in z.namelist():
@@ -161,11 +163,11 @@ jobs:
                   if major > allowed_max:
                       bad.append((n, major))
           if bad:
-              print(f'::error::Found {len(bad)} class files compiled above Java 17:')
+              print(f'::error::Found {len(bad)} class files compiled above Java 21:')
               for n, m in bad[:20]:
                   print(f'  {n}: major={m} (Java {m-44})')
               sys.exit(1)
-          print('All classes compiled to Java 17 or lower.')
+          print('All classes compiled to Java 21 or lower.')
           PY
 
       - name: Upload platform jar
@@ -232,6 +234,18 @@ jobs:
           (cd extract/macos && jar xf "$GITHUB_WORKSPACE/$MACOS_JAR" native)
           jar uf "$UNIVERSAL_JAR" -C extract/windows native -C extract/macos native
 
+          jar tf "$UNIVERSAL_JAR" > universal-entries.txt
+          for required in \
+            native/linux-x86_64/mahjongpaper_gb.so \
+            native/windows-x86_64/mahjongpaper_gb.dll \
+            native/windows-x86_64/libwinpthread-1.dll \
+            native/macos-x86_64/mahjongpaper_gb.dylib; do
+            if ! grep -Fxq "$required" universal-entries.txt; then
+              echo "::error::Universal jar is missing $required"
+              exit 1
+            fi
+          done
+
       - name: Upload universal jar
         uses: actions/upload-artifact@v7
         with:

.github/workflows/ensure-labels.yml

@@ -21,7 +21,17 @@ jobs:
             const labels = [
               { name: "dependencies", color: "0366d6", description: "Dependency updates" },
               { name: "gradle", color: "0e8a16", description: "Gradle build and dependency updates" },
-              { name: "github-actions", color: "5319e7", description: "GitHub Actions workflow updates" }
+              { name: "github-actions", color: "5319e7", description: "GitHub Actions workflow updates" },
+              { name: "performance-ab", color: "d4c5f9", description: "Run the base-owned paired performance gate" },
+              { name: "performance-snapshot", color: "bfdadc", description: "Use the viewer snapshot performance profile" },
+              { name: "performance-gb-bot", color: "bfdadc", description: "Use the GB bot decision performance profile" },
+              { name: "performance-region-fingerprint", color: "bfdadc", description: "Use the table region fingerprint performance profile" },
+              { name: "performance-display-spawn", color: "bfdadc", description: "Use the display entity spawn performance profile" },
+              { name: "performance-region-queue", color: "bfdadc", description: "Use the region update queue performance profile" },
+              { name: "performance-region-keys", color: "bfdadc", description: "Use the region key plan performance profile" },
+              { name: "performance-layout", color: "bfdadc", description: "Use the all-variant table layout performance profile" },
+              { name: "performance-scheduler-reflection", color: "bfdadc", description: "Use the scheduler reflection performance profile" },
+              { name: "performance-ray-proxy", color: "bfdadc", description: "Use the client ray-proxy performance profile" }
             ];
 
             for (const label of labels) {