spigot-heights/design/user-stories/us-005-build-and-release.md

type, title, description, status

type	title	description	status
User Story	US-005: Build and release the plugin	Give maintainers repeatable Purpur builds, automated verification, and versioned Gitea releases.	done

US-005: Build and release the plugin

As a plugin maintainer, I want automated builds and releases modeled on Spigot Base so that tested artifacts can be distributed consistently.

Acceptance criteria

• Gradle compiles against Purpur API 26.2.build.2618-stable using Java 25.
• Compiler lint warnings fail the build and JUnit 5 tests run during check.
• Gitea Actions verifies pushes and pull requests and stores a development JAR.
• Pull requests validate conventional commits.
• Main-branch conventional commits drive semantic releases and attach versioned JARs to Gitea releases.
• The README documents requirements, recipes, configuration, building, and releases.
• ./gradlew clean check jar succeeds.

Related

• User-story catalog