feat: add CI and release workflows for automated builds and deployments

Author: Alexteens24

.github/workflows/ci.yml

@@ -0,0 +1,50 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+  workflow_dispatch:
+
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  build-and-test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Temurin JDK 21
+        uses: actions/setup-java@v4
+        with:
+          distribution: temurin
+          java-version: '21'
+          cache: maven
+
+      - name: Verify with Maven
+        run: mvn -B -ntp verify
+
+      - name: Upload plugin artifact
+        if: success()
+        uses: actions/upload-artifact@v4
+        with:
+          name: DynamicKeepInv-${{ github.sha }}
+          path: target/DynamicKeepInv-*.jar
+          if-no-files-found: error
+
+      - name: Upload test reports on failure
+        if: failure()
+        uses: actions/upload-artifact@v4
+        with:
+          name: surefire-reports-${{ github.sha }}
+          path: |
+            target/surefire-reports/**
+            target/*.log
+          if-no-files-found: ignore

.github/workflows/maven-publish.yml

@@ -0,0 +1,33 @@
+name: Release Build
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Temurin JDK 21
+        uses: actions/setup-java@v4
+        with:
+          distribution: temurin
+          java-version: '21'
+          cache: maven
+
+      - name: Build release artifact
+        run: mvn -B -ntp package
+
+      - name: Publish GitHub release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: target/DynamicKeepInv-*.jar
+          generate_release_notes: true

.github/workflows/release.yml

@@ -1,13 +1,36 @@
 # DynamicKeepInv
 
-![Java](https://img.shields.io/badge/Java-21%2B-orange) ![Server](https://img.shields.io/badge/Server-Paper%20%7C%20Spigot%20%7C%20Folia-blue) ![License](https://img.shields.io/badge/License-Apache%202.0-green)
+![Java](https://img.shields.io/badge/Java-21%2B-orange) ![Server](https://img.shields.io/badge/Server-Paper%20%7C%20Spigot%20%7C%20Folia-blue) ![License](https://img.shields.io/badge/License-Apache%202.0-green) [![CI](https://github.com/Alexteens24/DynamicKeepInv/actions/workflows/ci.yml/badge.svg)](https://github.com/Alexteens24/DynamicKeepInv/actions/workflows/ci.yml)
 
-DynamicKeepInv makes `keepInventory` configurable instead of binary. You can decide whether players keep items and XP based on time of day, death cause, protection plugins, economy rules, and optional safety-net rules.
+DynamicKeepInv turns `keepInventory` from a simple on/off gamerule into a configurable rule engine.
+
+Instead of choosing between fully safe or fully punishing deaths, you can decide whether players keep items and XP based on:
+
+- day or night
+- PvP or PvE
+- claims, regions, or towns
+- economy rules
+- first-death leniency
+- repeated-death protection
 
 Built for 1.20.4+ servers with Java 21 and full Folia support.
 
 ---
 
+## Why Use It?
+
+Vanilla `keepInventory` is too blunt for most servers.
+
+DynamicKeepInv lets you build setups like:
+
+- safe day, dangerous night
+- casual PvE, punishing PvP
+- keep items in your own land, lose them in enemy territory
+- pay to keep items through a death GUI
+- forgive a player's first death or a brutal death streak
+
+---
+
 ## Highlights
 
 - Day/night keep-inventory rules with separate item and XP control
@@ -23,6 +46,21 @@ Built for 1.20.4+ servers with Java 21 and full Folia support.
 
 ---
 
+## Optional Integrations
+
+| Plugin | What it adds |
+| :--- | :--- |
+| Vault | Economy-based keep-inventory modes |
+| PlaceholderAPI | Player/server placeholders |
+| Lands | Own-land / other-land / wilderness rules |
+| GriefPrevention | Own-claim / other-claim / wilderness rules |
+| WorldGuard | Own-region / other-region / wilderness rules |
+| Towny | Own-town / other-town / wilderness rules |
+| GravesX / AxGraves | Graves instead of normal drops |
+| MMOItems | Protected tag handling for soulbound-style items |
+
+---
+
 ## Rule Order
 
 When a player dies, the plugin evaluates rules in this order:
@@ -36,6 +74,8 @@ When a player dies, the plugin evaluates rules in this order:
 
 The first rule that returns a result wins.
 
+This means high-priority safety rules like bypass, first-death, and streak protection can override the final day/night fallback.
+
 ---
 
 ## Requirements
@@ -54,7 +94,7 @@ Optional plugins:
 
 ---
 
-## Installation
+## Quick Start
 
 1. Download the latest JAR from [Releases](https://github.com/Alexteens24/DynamicKeepInv/releases).
 2. Place it in your server's `plugins/` folder.
@@ -67,6 +107,17 @@ Config migration runs automatically on startup and reload.
 
 ---
 
+## Default Behavior
+
+Out of the box:
+
+- day keeps items and XP
+- night drops items and XP
+- stats are enabled
+- optional integrations are disabled until you enable them in config
+
+---
+
 ## Commands
 
 | Command | Permission | Description |
@@ -88,7 +139,7 @@ Useful permissions:
 
 ---
 
-## Config Example
+## Example Config
 
 ```yaml
 rules:
@@ -146,6 +197,55 @@ economy:
 
 ---
 
+## Common Use Cases
+
+### Safe Day, Dangerous Night
+
+```yaml
+rules:
+  day:
+    keep-items: true
+    keep-xp: true
+  night:
+    keep-items: false
+    keep-xp: false
+```
+
+### Keep Items On First Death
+
+```yaml
+rules:
+  first-death:
+    enabled: true
+    keep-items: true
+    keep-xp: true
+```
+
+### Pay To Keep Items
+
+```yaml
+economy:
+  enabled: true
+  cost: 250.0
+  mode: "gui"
+```
+
+### Claimed Areas Are Safe, Wilderness Is Not
+
+```yaml
+integrations:
+  lands:
+    enabled: true
+    in-own-land:
+      keep-items: true
+      keep-xp: true
+    in-other-land:
+      keep-items: false
+      keep-xp: false
+```
+
+---
+
 ## Placeholders
 
 Requires PlaceholderAPI.
@@ -161,7 +261,9 @@ See the wiki pages for full details.
 
 ---
 
-## Wiki
+## Documentation
+
+Full documentation lives in the wiki:
 
 - [Home](wiki/Home.md)
 - [Installation](wiki/Installation.md)
@@ -172,6 +274,10 @@ See the wiki pages for full details.
 - [Stats](wiki/Stats.md)
 - [Placeholders](wiki/Placeholders.md)
 
+GitHub Wiki:
+
+- https://github.com/Alexteens24/DynamicKeepInv/wiki
+
 ---
 
 ## License