Add release packaging workflow

Author: chripa85

.github/workflows/release.yml

@@ -0,0 +1,57 @@
+name: Release Mod
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    runs-on: windows-latest
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Set up MSBuild
+        uses: microsoft/setup-msbuild@v2
+
+      - name: Build mod
+        run: msbuild src\kc-accessibility\kc-accessibility.csproj /t:Build /p:Configuration=Release
+
+      - name: Package staged mod
+        shell: cmd
+        run: scripts\package-mod.cmd
+
+      - name: Resolve release metadata
+        id: release_meta
+        shell: pwsh
+        run: |
+          $version = if ($env:GITHUB_REF_TYPE -eq 'tag') {
+            $env:GITHUB_REF_NAME
+          } else {
+            "manual-" + $env:GITHUB_RUN_NUMBER
+          }
+          $asset = "kc-accessibility-$version.zip"
+          Copy-Item "dist\kc-accessibility.zip" "dist\$asset" -Force
+          "version=$version" >> $env:GITHUB_OUTPUT
+          "asset_name=$asset" >> $env:GITHUB_OUTPUT
+
+      - name: Upload packaged mod artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: ${{ steps.release_meta.outputs.asset_name }}
+          path: dist/${{ steps.release_meta.outputs.asset_name }}
+
+      - name: Create GitHub release
+        if: github.ref_type == 'tag'
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: ${{ steps.release_meta.outputs.version }}
+          name: ${{ steps.release_meta.outputs.version }}
+          generate_release_notes: true
+          files: dist/${{ steps.release_meta.outputs.asset_name }}

.gitignore

@@ -459,5 +459,8 @@ $RECYCLE.BIN/
 # Generated staged mod output
 mod/**
 
+# Local packaged release output
+dist/
+
 # Local-only research, decompiled references, and machine-specific notes
 local/

README.md

@@ -50,6 +50,14 @@ msbuild src\kc-accessibility\kc-accessibility.csproj /t:Build /p:Configuration=D
 
 The post-build step stages the mod into `mod/kc-accessibility/`.
 
+To package the staged mod into a distributable zip, use:
+
+```powershell
+cmd /c scripts\package-mod.cmd
+```
+
+That creates `dist/kc-accessibility.zip`.
+
 ## Deploy
 
 Deploy the staged mod with:
@@ -58,6 +66,22 @@ Deploy the staged mod with:
 cmd /c scripts\deploy-mod-to-game.cmd
 ```
 
+## Releases
+
+GitHub Actions builds and releases the mod on Windows when you push a tag that starts with `v`, for example:
+
+```powershell
+git tag v1.0.0
+git push origin v1.0.0
+```
+
+The workflow:
+
+- builds `src\kc-accessibility\kc-accessibility.csproj` in `Release`
+- stages `mod/kc-accessibility/`
+- zips that staged mod folder
+- publishes the zip as a GitHub release asset
+
 ## Repository Layout
 
 - `src/kc-accessibility/` mod source

scripts/deploy-mod-to-game.cmd

@@ -16,12 +16,16 @@ if not exist "%SOURCE_MOD_DIR%" (
 
 if not exist "%TARGET_MOD_DIR%" mkdir "%TARGET_MOD_DIR%"
 
+for %%F in ("%TARGET_MOD_DIR%\*") do (
+  if /I not "%%~aF"=="d" del /F /Q "%%~fF" >nul
+)
+
 for %%F in ("%SOURCE_MOD_DIR%\*") do (
   if /I not "%%~aF"=="d" copy /Y "%%~fF" "%TARGET_MOD_DIR%\%%~nxF" >nul
 )
 
 if exist "%TARGET_MOD_DIR%\output.txt" del /F /Q "%TARGET_MOD_DIR%\output.txt"
 
-echo Deployed staged mod files to "%TARGET_MOD_DIR%"
+echo Mirrored staged mod files to "%TARGET_MOD_DIR%"
 echo Cleared "%TARGET_MOD_DIR%\output.txt"
 exit /b 0

scripts/package-mod.cmd

@@ -0,0 +1,29 @@
+@echo off
+setlocal
+
+set "REPO_ROOT=%~dp0.."
+for %%I in ("%REPO_ROOT%") do set "REPO_ROOT=%%~fI"
+
+set "PROJECT_DIR=%REPO_ROOT%\src\kc-accessibility\"
+set "MOD_NAME=kc-accessibility"
+set "STAGE_ROOT=%REPO_ROOT%\mod"
+set "MOD_ROOT=%STAGE_ROOT%\%MOD_NAME%"
+set "DIST_ROOT=%REPO_ROOT%\dist"
+set "ZIP_PATH=%DIST_ROOT%\%MOD_NAME%.zip"
+
+if not exist "%PROJECT_DIR%kc-accessibility.csproj" (
+  echo Project file not found under "%PROJECT_DIR%"
+  exit /b 1
+)
+
+call "%~dp0stage-mod.cmd" "%PROJECT_DIR%"
+if errorlevel 1 exit /b 1
+
+if not exist "%DIST_ROOT%" mkdir "%DIST_ROOT%"
+if exist "%ZIP_PATH%" del /F /Q "%ZIP_PATH%"
+
+powershell -NoProfile -ExecutionPolicy Bypass -Command "Compress-Archive -Path '%MOD_ROOT%\*' -DestinationPath '%ZIP_PATH%' -Force"
+if errorlevel 1 exit /b 1
+
+echo Packaged mod zip at "%ZIP_PATH%"
+exit /b 0