Add GitHub Actions for automated builds and releases

- Build workflow triggers on push/PR to master/main
- Release workflow creates GitHub release on version tags (v*)
- Requires HytaleServer.jar via HYTALE_SERVER_URL variable or lib/ folder
- Updated pom.xml with configurable hytale.server.path property

To create a release:
  git tag v1.0.0
  git push origin v1.0.0

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: cryptobench

.github/workflows/build.yml

@@ -0,0 +1,119 @@
+name: Build and Release
+
+on:
+  push:
+    branches: [ master, main ]
+    tags:
+      - 'v*'
+  pull_request:
+    branches: [ master, main ]
+  workflow_dispatch:  # Allow manual trigger
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+
+    - name: Set up Java 25
+      uses: actions/setup-java@v4
+      with:
+        java-version: '25-ea'
+        distribution: 'temurin'
+        cache: maven
+
+    - name: Create lib directory
+      run: mkdir -p lib
+
+    - name: Download HytaleServer.jar from secret URL
+      if: ${{ vars.HYTALE_SERVER_URL != '' }}
+      run: curl -L -o lib/HytaleServer.jar "${{ vars.HYTALE_SERVER_URL }}"
+
+    - name: Check for HytaleServer.jar in lib folder
+      run: |
+        if [ ! -f lib/HytaleServer.jar ]; then
+          echo "ERROR: HytaleServer.jar not found!"
+          echo ""
+          echo "To fix this, do ONE of the following:"
+          echo "1. Add a repository variable HYTALE_SERVER_URL with a download link"
+          echo "2. Add lib/HytaleServer.jar to the repository"
+          echo ""
+          exit 1
+        fi
+        echo "Found HytaleServer.jar"
+
+    - name: Build with Maven
+      run: mvn clean package -Dhytale.server.path=${{ github.workspace }}/lib/HytaleServer.jar
+
+    - name: Upload artifact
+      uses: actions/upload-artifact@v4
+      with:
+        name: HomeEssentials
+        path: target/HomeEssentials-*.jar
+
+  release:
+    needs: build
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/v')
+    permissions:
+      contents: write
+
+    steps:
+    - name: Download artifact
+      uses: actions/download-artifact@v4
+      with:
+        name: HomeEssentials
+        path: ./dist
+
+    - name: Get version from tag
+      id: version
+      run: echo "VERSION=${GITHUB_REF#refs/tags/v}" >> $GITHUB_OUTPUT
+
+    - name: Rename JAR to include version
+      run: |
+        cd dist
+        mv HomeEssentials-*.jar HomeEssentials-${{ steps.version.outputs.VERSION }}.jar
+
+    - name: Create Release
+      uses: softprops/action-gh-release@v2
+      with:
+        name: HomeEssentials v${{ steps.version.outputs.VERSION }}
+        body: |
+          ## HomeEssentials v${{ steps.version.outputs.VERSION }}
+
+          A home management plugin for Hytale servers.
+
+          ### Installation
+          1. Download `HomeEssentials-${{ steps.version.outputs.VERSION }}.jar` below
+          2. Place in your Hytale server's `mods/` folder
+          3. Restart the server
+
+          ### Quick Setup
+          Run in server console:
+          ```
+          perm group add default homes.use
+          perm group add default homes.limit.1
+          ```
+
+          ### Commands
+          | Command | Description |
+          |---------|-------------|
+          | `/sethome [name]` | Save your location |
+          | `/home [name]` | Teleport to home |
+          | `/homes` | List all homes |
+          | `/delhome <name>` | Delete a home |
+          | `/homehelp` | Show full help |
+
+          ### Permissions
+          | Permission | Description |
+          |------------|-------------|
+          | `homes.use` | Basic access |
+          | `homes.limit.1` | 1 home (default) |
+          | `homes.limit.3` | 3 homes |
+          | `homes.limit.5` | 5 homes |
+          | `homes.limit.unlimited` | Unlimited |
+        files: ./dist/HomeEssentials-${{ steps.version.outputs.VERSION }}.jar
+        draft: false
+        prerelease: false

pom.xml

@@ -16,6 +16,8 @@
         <maven.compiler.source>25</maven.compiler.source>
         <maven.compiler.target>25</maven.compiler.target>
         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+        <!-- Override this for CI builds: -Dhytale.server.path=/path/to/HytaleServer.jar -->
+        <hytale.server.path>${project.basedir}/../../HytaleServer.jar</hytale.server.path>
     </properties>
 
     <dependencies>
@@ -25,10 +27,10 @@
             <artifactId>HytaleServer</artifactId>
             <version>1.0.0</version>
             <scope>system</scope>
-            <systemPath>${project.basedir}/../../HytaleServer.jar</systemPath>
+            <systemPath>${hytale.server.path}</systemPath>
         </dependency>
 
-        <!-- JSON processing - Gson is likely already in Hytale, mark as provided -->
+        <!-- JSON processing - Gson is provided by Hytale -->
         <dependency>
             <groupId>com.google.code.gson</groupId>
             <artifactId>gson</artifactId>