Files
dmg d35c0197f5
Release / release (push) Successful in 4m14s
CI / build (push) Successful in 53s
docs(design): complete initial harvest stories
2026-08-14 18:27:09 -04:00

1.5 KiB

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.

Requirements

  • Spigot 26.2
  • Java 17 or newer

Build

./gradlew clean check jar

The plugin JAR is written to build/libs/.

Commands

/harvest
/harvest status [wheat|carrot|potato|beetroot]
/harvest bossbar <enable|disable>

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.

/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.