docs(design): complete initial harvest stories
Release / release (push) Successful in 4m14s
CI / build (push) Successful in 53s

This commit is contained in:
dmg
2026-08-14 18:27:09 -04:00
parent e0a9413cb2
commit d35c0197f5
9 changed files with 121 additions and 99 deletions
+17 -2
View File
@@ -21,11 +21,26 @@ The plugin JAR is written to `build/libs/`.
```text
/harvest
/harvest status [crop]
/harvest status [wheat|carrot|potato|beetroot]
/harvest bossbar <enable|disable>
/harvestadmin <subcommand>
```
The progress boss bar is enabled by default and remains visible for five seconds after its latest update. Sneaking while breaking a mature crop bypasses auto-harvest while still earning progress.
## Administration
The `spigotharvest.admin` permission is granted to server operators by default.
```text
/harvestadmin status <player> [crop]
/harvestadmin setlevel <player> <crop> <0|I|II|III|IV|V|VI|VII|VIII|IX|X>
/harvestadmin setprogress <player> <crop> <amount>
/harvestadmin reset <player> <crop>
/harvestadmin reset <player> all confirm
```
Validated progression and presentation defaults are documented in `src/main/resources/config.yml`. UUID-keyed player state is stored in `plugins/SpigotHarvest/state.yml` using atomic replacement where supported.
## 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.