### Build Add-on Package

Source: https://github.com/nvidia/simready-blender-add-on/blob/main/README.md

Build the add-on package using the provided Python script. This generates a .zip file for installation.

```bash
python CORE_SysUtils/package/make_core_zip.py
```

--------------------------------

### Release Versioning Example

Source: https://github.com/nvidia/simready-blender-add-on/blob/main/CORE_SysUtils/package/ARCHIVE_README.md

Shows how to specify a release version for the archive, typically derived from a git branch, ensuring accurate versioning for published releases.

```bash
# Release version (e.g., from git branch release/16.1.9)
tools\bat\repo.bat archive --version 16.1.9
# Creates: simready-blender-addons@2025.10.16.1.9-x86x64.7z
```

--------------------------------

### GitLab CI Manual Version Tagging

Source: https://github.com/nvidia/simready-blender-add-on/blob/main/CORE_SysUtils/package/ARCHIVE_README.md

Example of using manual version tagging within a GitLab CI environment, specifying version, year, and month explicitly.

```bash
# Example: GitLab CI with explicit version
 repo.bat archive --version 16.1.9 --year 2025 --month 10
```

--------------------------------

### Quick Tools Operator

Source: https://github.com/nvidia/simready-blender-add-on/blob/main/CORE_ArtistTools/CORE_ArtistTools_README.md

Provides access to small utilities and helpers for asset setup within the Blender add-on.

```python
CORE_PT_Tools
```

--------------------------------

### Offline License Regeneration

Source: https://github.com/nvidia/simready-blender-add-on/blob/main/PACKAGE-LICENSES/README.md

Execute this command for offline license regeneration. It ensures that only installed wheels are used, preventing internet access.

```powershell
tools\scripts\regenerate_package_licenses.bat --no-network
```

--------------------------------

### Set Up Asset Source Directories

Source: https://github.com/nvidia/simready-blender-add-on/blob/main/CORE_ArtistTools/CORE_ArtistTools_README.md

Creates the necessary on-disk folder structure for a new asset. This structure is crucial as many tools rely on it. It includes subdirectories for DCC source files, images, models, and textures.

```python
CORE_PT_make_source_dir
```

--------------------------------

### Clone Repository

Source: https://github.com/nvidia/simready-blender-add-on/blob/main/README.md

Clone the SimReady Blender Addon repository to your local machine.

```bash
git clone <repository-url>
cd simready-blender-addons
```

--------------------------------

### Regenerate All Package Licenses

Source: https://github.com/nvidia/simready-blender-add-on/blob/main/PACKAGE-LICENSES/README.md

Run this command to refresh all package license files. It yields the best results when the addon's dependencies are installed locally.

```powershell
tools\scripts\regenerate_package_licenses.bat
```

--------------------------------

### Combine All Options for Release

Source: https://github.com/nvidia/simready-blender-add-on/blob/main/CORE_SysUtils/package/ARCHIVE_README.md

Combines version, year, and month options for a specific release build. This provides full control over the archive's naming convention.

```bash
# Combine all options for a specific release
 tools\bat\repo.bat archive --version 16.1.9 --year 2025 --month 8
```

--------------------------------

### GitLab CI Integration

Source: https://github.com/nvidia/simready-blender-add-on/blob/main/CORE_SysUtils/package/ARCHIVE_README.md

Example of integrating the archive command into a GitLab CI pipeline. It extracts the version from the branch name and conditionally runs the archive command.

```yaml
job-archive:
  artifacts:
    paths:
      - _build/archives/*
  needs:
    - job: job-0-setup
      artifacts: true
  rules:
    - !reference [.rules-workflow, rules]
  script:
    # Extract version from branch name (e.g., release/16.1.9)
    - |
      $branch = git rev-parse --abbrev-ref HEAD
      if ($branch -match 'release/(\d+\.\d+\.\d+)') {
        $version = $matches[1]
        ./tools/bat/repo.bat archive --version $version
      } else {
        ./tools/bat/repo.bat archive
      }
  stage: build
  tags:
    - os/windows
```

--------------------------------

### Clone SimReady Blender Add-on Repository

Source: https://github.com/nvidia/simready-blender-add-on/blob/main/CORE_ArtistTools/CORE_ArtistTools_README.md

Clone the forked repository to your local machine to begin making custom changes. Ensure you are in the correct directory before cloning.

```bash
cd simready-blender-add-on
git clone <forked copy>
```