Starter-Mod

Starter-Mod is a NeoForge 1.21.1 test mod used to validate the release pipeline:

• build once in Forgejo
• create a Forgejo release with the built jar
• publish the same jar to Nexus
• optionally publish alpha, beta, and stable releases to Modrinth and CurseForge by manual dispatch

Workflow

• Build and release automation lives in .forgejo/workflows/build.yml
• Contribution rules live in CONTRIBUTING.md
• Versioning and changelog rules live in docs/versioning.md

The workflow uses java-ci only for the Gradle build. Release metadata, Forgejo publishing, Nexus publishing, and manual external publishing use the other idle runners. Release notes reset at the previous Forgejo tag, so each release only shows the commits that landed since the last published release.

Publish Secrets

For external publishing:

• Put these in organization secrets:
  • MODRINTH_TOKEN
  • CURSEFORGE_TOKEN
• Put these in repository secrets:
  • MODRINTH_PROJECT_ID
  • CURSEFORGE_PROJECT_ID

Modrinth and CurseForge publishing is skipped for -rc releases. Stable releases keep the semver version string unchanged and only add -stable to the visible release name. The external publish path is manual and uses the Forgejo UI dispatch input publish_external=true.

Local Setup

If you need to refresh dependencies:

./gradlew --refresh-dependencies
./gradlew clean

Reference

• NeoForge docs: https://docs.neoforged.net/
• NeoForge mappings reference: https://github.com/NeoForged/NeoForm/blob/main/Mojang.md