Pin Mapping Versions For Reproducible Builds
A build may compile locally and fail elsewhere when mapping coordinates or other build inputs float, resolve differently, or are omitted from the checked-in configuration. Pin the Minecraft, loader, mappings, and relevant plugin or dependency versions in the project’s normal build configuration, and keep lockfiles or dependency verification metadata where the toolchain supports them. When reproducing a mismatch, compare resolved dependency inputs and generated sources across environments; exact configuration details depend on the Minecraft, loader, mappings, and build-tool versions.
For Gradle builds,
./gradlew --write-verification-metadata sha256generates the verification file to commit, and./gradlew dependencies --write-lockswrites lockfiles for resolved versions. Seen another edge case with this? Add it below.