build: scaffold Spigot plugin project

2026-08-08 13:10:04 -04:00
parent a01f36db86
commit 152cac0740
15 changed files with 664 additions and 9 deletions
@@ -0,0 +1,30 @@
+# Trigger Spawn
+
+A Spigot 26.2 plugin providing progression-gated, safe teleportation to each world's spawn area.
+
+The behavior under development 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/`.
+
+For a local versioned build:
+
+```bash
+./gradlew clean check jar -PreleaseVersion=1.2.3
+```
+
+## Releases
+
+Gitea Actions checks every push and pull request and stores a development JAR as a workflow artifact. Pull requests also validate conventional commits.
+
+Pushes to `main` run semantic-release. A release-causing conventional commit builds a versioned JAR and attaches it to the corresponding public Gitea release. The repository must define a `RELEASE_TOKEN` secret with repository contents write permission.