Main 1.21.1 Update

.gitattributes

@@ -0,0 +1,11 @@
+# Set the default behavior, in case people don't have core.autocrlf set.
+* text=auto
+
+# Explicitly declare text files you want to always be normalized and converted
+# to native line endings on checkout.
+*.java text eol=lf
+*.json text eol=lf
+src/generated/resources/.cache/** text eol=lf
+
+# Denote all files that are truly binary and should not be modified.
+*.png binary

.github/actions/build_setup/action.yml

@@ -0,0 +1,43 @@
+name: Build Setup
+description: Setup for standard Java builds
+
+inputs:
+  update-cache:
+    description: If cache should be updated
+    required: false
+    default: 'false'
+  ref:
+    description: 'Ref to checkout'
+    required: false
+
+runs:
+  using: 'composite'
+  steps:
+    - uses: actions/checkout@v4
+      with:
+        ref: ${{ inputs.ref || github.ref }}
+    - name: Set up JDK
+      uses: actions/setup-java@v4
+      env:
+        REF: ${{ inputs.ref || github.ref }}
+      with:
+        distribution: temurin
+        java-version: ${{ contains(env.REF, '1.20.1') && '17' || '21' }}
+
+    - name: Validate Gradle wrapper
+      uses: gradle/actions/wrapper-validation@v3
+
+    - name: Grant execute permission for gradlew
+      shell: bash
+      run: chmod +x gradlew
+
+    - name: Setup Gradle
+      uses: gradle/actions/setup-gradle@v3
+      with:
+        cache-write-only: ${{ inputs.update-cache }}
+        generate-job-summary: false
+        gradle-home-cache-includes: |
+          caches
+          notifications
+          jdks
+          wrapper

.github/workflows/deploy-pages.yml

@@ -0,0 +1,56 @@
+name: Publish docs via GitHub Pages
+on:
+  workflow_dispatch:
+  push:
+    branches: [1.20.1]
+    paths: ['docs/**']
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: 'pages'
+  cancel-in-progress: false
+
+jobs:
+  build:
+    name: build docs
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: './docs'
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: '1.20.1'
+          sparse-checkout: './docs'
+      - uses: actions/setup-python@v4
+        with:
+          python-version: '3.11'
+          cache: 'pip'
+      - run: pip install -r ./requirements.txt
+      - uses: actions/cache@v4
+        with:
+          key: 'mkdocs-cache'
+          path: './docs/.cache'
+      - name: Build static files
+        id: mkdocs
+        run: mkdocs build
+      - name: Upload pages as artifact
+        id: artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: './docs/site/'
+
+  deploy:
+    runs-on: ubuntu-latest
+    needs: build
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.github/workflows/release.yml

@@ -35,15 +35,22 @@ jobs:
       - name: Setup Gradle Wrapper
         run: chmod +x gradlew
 
-      - name: Get Version and Platform
-        id: properties
+      - name: Get Version
+        id: gradle_properties
         uses: christian-draeger/read-properties@1.1.1
         with:
           path: ./gradle.properties
-          properties: "mod_version minecraft_version"
+          properties: "mod_version"
+
+      - name: Get minecraft version
+        id: toml_properties
+        uses: SebRollen/toml-action@v1.2.0
+        with:
+          file: ./gradle/libs.versions.toml
+          field: "versions.minecraft"
 
       - name: Build Project
-        run: ./gradlew build
+        run: ./gradlew build --build-cache
 
       - name: Upload Forge Releases (Curse|Modrinth|Github)
         id: forge_release
@@ -54,12 +61,12 @@ jobs:
 
           github-token: ${{ secrets.GITHUB_TOKEN }}
           github-generate-changelog: true
-          github-tag: "${{ steps.properties.outputs.minecraft_version }}-${{ steps.properties.outputs.mod_version }}"
+          github-tag: "${{ steps.toml_properties.outputs.value }}-${{ steps.gradle_properties.outputs.mod_version }}"
 
-          files: ./build/libs/!(*-@(dev|sources|dev-shadow)).jar
-          name: "Cosmic Core ${{ steps.properties.outputs.mod_version }}"
-          version: ${{ steps.properties.outputs.mod_version }}
+          files: ./build/libs/!(*-@(dev|sources|dev-slim|slim)).jar
+          name: "Cosmic Core ${{ steps.gradle_properties.outputs.mod_version }}"
+          version: ${{ steps.gradle_properties.outputs.mod_version }}
           version-type: ${{ inputs.version_type }}
           changelog-file: changelog.md
           loaders: forge
-          game-versions: ${{ steps.properties.outputs.minecraft_version }}
+          game-versions: ${{ steps.toml_properties.outputs.value }}

.github/workflows/spotless.yml

@@ -0,0 +1,38 @@
+# Runs formatting requirements
+name: Java Formatting
+
+on:
+  push:
+    branches: ['main-1.20.1-forge']
+    paths: ['src/main/java/**']
+  pull_request:
+    paths: ['**']
+
+concurrency:
+  group: formatting-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  formatting:
+    name: Formatting
+    runs-on: ubuntu-latest
+    permissions:
+      pull-requests: read
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v4
+      - name: Check Path Filter
+        uses: dorny/paths-filter@v3
+        id: filter
+        with:
+          filters: |
+            code:
+              - 'src/main/java/**'
+      - run: git fetch origin main-1.20.1-forge
+        if: steps.filter.outputs.code == 'true'
+      - name: Setup Build
+        if: steps.filter.outputs.code == 'true'
+        uses: ./.github/actions/build_setup
+      - name: Run Spotless Formatting Check with Gradle
+        if: steps.filter.outputs.code == 'true'
+        run: ./gradlew spotlessCheck --warning-mode all --build-cache   

.gitignore

@@ -28,9 +28,15 @@ bin/
 
 *.DS_Store
 
-# fabric
+# runtime folders
 
 run/
+run-data/
+runs/
 
 # forge generated resources cache
 /src/generated/resources/.cache/
+# Agenic Support Tools - Debug Only
+/.claude/
+# Personal Notes I Keep in my Local
+/docs/