mod.builder

Reusable CI/CD workflows for Nox mods — build, version, and publish.

Part of the NoxVR ecosystem

---

Workflows

Workflow	Description
check.yml	Validate mod structure — package.json, nox.mod.jsonc, .asmdef, entrypoints
version.yml	Compute next semver from git tags + bump nox.mod.jsonc + commit
build.yml	Create Unity project, resolve dependencies, BuildMod, package .noxmod
release.yml	Publish .noxmod to GitHub Releases

Quick start

# .github/workflows/build.yml
name: Build & Release
on:
  push:
    branches: ["**"]
  pull_request:
    branches: ["main"]
  workflow_dispatch:
    inputs:
      version_override:
        description: "Override version (empty = auto)"
        required: false

jobs:
  check:
    uses: AtelierVR/mod.builder/.github/workflows/check.yml@main

  version:
    needs: check
    if: github.event_name != 'pull_request'
    uses: AtelierVR/mod.builder/.github/workflows/version.yml@main
    with:
      override: ${{ inputs.version_override }}
    secrets: inherit

  build:
    needs: version
    if: always() && (needs.version.result == 'success' || needs.version.result == 'skipped')
    uses: AtelierVR/mod.builder/.github/workflows/build.yml@main
    with:
      version: ${{ needs.version.outputs.resolved }}
    secrets: inherit

  release:
    needs: [ version, build ]
    if: github.event_name != 'pull_request'
    uses: AtelierVR/mod.builder/.github/workflows/release.yml@main
    with:
      tag: ${{ needs.version.outputs.tag }}
      prerelease: ${{ needs.version.outputs.prerelease }}

Secrets

# Windows
irm https://raw.githubusercontent.com/AtelierVR/mod.builder/refs/heads/main/scripts/setup-secrets.ps1 | iex

# Linux / Mac
curl -sSL https://raw.githubusercontent.com/AtelierVR/mod.builder/refs/heads/main/scripts/setup-secrets.sh | bash

Secret	Description
UNITY_LICENSE	Auto-detected from local Unity install
UNITY_EMAIL	Your Unity account email
UNITY_PASSWORD	Your Unity account password

Versioning

nox.mod.jsonc → "version": "1.0.x"

Branch	Tag
main	v1.0.0, v1.0.1...
development	v1.0.0-dev, v1.0.1-dev...
feature/xyz	v1.0.0-feature-xyz...

---

Made with ♥ by AtelierVR  ·  AGPL-3.0

Part of the NoxVR project — a federated social VR platform