build: add Spigot plugin foundation

2026-08-14 18:15:52 -04:00
parent b8583901f5
commit 57bb0d6049
15 changed files with 677 additions and 10 deletions
@@ -0,0 +1,31 @@
+# Spigot Harvest
+
+A Spigot 26.2 plugin providing progression-gated, connected crop harvesting and automatic replanting.
+
+The approved behavior is specified in the [OKF design bundle](design/index.md).
+
+## Requirements
+
+- Spigot 26.2
+- Java 17 or newer
+
+## Build
+
+```bash
+./gradlew clean check jar
+```
+
+The plugin JAR is written to `build/libs/`.
+
+## Commands
+
+```text
+/harvest
+/harvest status [crop]
+/harvest bossbar <enable|disable>
+/harvestadmin <subcommand>
+```
+
+## Releases
+
+Gitea Actions checks pushes and pull requests and stores a development JAR. Pull requests validate conventional commits. Main-branch conventional commits drive semantic releases when the repository defines a `RELEASE_TOKEN` with contents-write permission.