Unclaimed Package Is this your package? Claim it to unlock full analytics and manage your listing.
Claim This Package

GitUnityBuildValidator

NoaTheSoap/Git-Unity-Build-Validator 1

Validates Unity builds based on Git/GitHub branches and commits, and warns the user if the project is behind the specified branch when building.

com.noathesoap.gitunitybuildvalidator
unityunity-build-toolunity-editor-toolunity-package

Install via UPM

Add to Unity Package Manager using this URL

https://www.pkglnk.dev/gitunitybuildvalidator.git

README Markdown

Copy this to your project's README.md

Style
Preview
pkglnk installs badge
## Installation

Add **GitUnityBuildValidator** to your Unity project via Package Manager:

1. Open **Window > Package Manager**
2. Click **+** > **Add package from git URL**
3. Enter:
```
https://www.pkglnk.dev/gitunitybuildvalidator.git
```

[![pkglnk](https://www.pkglnk.dev/badge/gitunitybuildvalidator.svg?style=pkglnk)](https://www.pkglnk.dev/pkg/gitunitybuildvalidator)

README

GitUnityBuildValidator

A Unity Editor tool that validates your Unity builds based on your Git/GitHub branch status. It automatically warns you if your local project is behind the specified remote branch when you try to build, helping you avoid building outdated versions of your project.

Features

  • Pre-Build Validation: Intercepts the build process to check your Git repository's status.
  • Customizable Branch: Specify which branch to validate against (defaults to main).
  • Warning Dialog: Displays a clear warning dialog if you are behind the remote branch, giving you the option to cancel or proceed with the build.

Installation

Add package from git URL

  1. In Unity, open the Package Manager (Window > Package Manager).
  2. Click the + button in the top left corner.
  3. Select Add package from git URL...
  4. Enter the URL of this repository: https://github.com/NoaTheSoap/GitUnityBuildValidator.git
  5. Click Add.

Add package from disk (For local development)

  1. Clone or download this repository to your computer.
  2. In your Unity project, go to Window > Package Manager.
  3. Click the + button in the top left corner.
  4. Select Add package from disk...
  5. Navigate to the downloaded folder and select the package.json file.

Usage

Configuration

You can configure the validator through its custom Editor window.

  1. In the Unity Editor top menu bar, go to Tools > GitBuildValidator.

  2. This will open the Git Validator settings window.

    GitBuildValidator Window

  3. Branch: Enter the name of the branch you want to validate against (e.g., main, development). The tool will automatically fetch and warn you if you enter a branch that doesn't exist on the remote.

  4. Display Warning: Toggle this on or off to enable or disable the pre-build warning popup.

Building

Once configured, the tool works automatically when you build your project (File > Build Settings > Build).

  • If your local branch is up to date with the remote branch, the build will proceed normally.

  • If your local branch is behind the remote setting, a warning dialog will pop up:

    Warning Dialog

    • Click Build to ignore the warning and build anyway.
    • Click Cancel build to abort the build process so you can pull the latest changes.

Requirements

  • Unity 6000.3 or newer (tested with 6000.3.9f1).
  • Git installed and accessible via your system's command line (ensure Git is added to your PATH environment variable).

Related Packages

MessagePack MessagePack is an extremely fast serializer for C# that converts objects to compact binary format. It delivers 10x faster performance than alternative serializers, making it ideal for games, networking, and real-time applications. Built-in LZ4 compression support, broad type compatibility, and optimized code generation ensure efficient data transmission and storage across networked and distributed systems. MessagePack-CSharpProjectlearn A curated list of project tutorials for project-based learning. XtremiliciousXCharts A charting and data visualization library for Unity. Support line chart, bar chart, pie chart, radar chart, scatter chart, heatmap chart, ring chart, candlestick chart, polar chart and parallel coordinates. XCharts-TeamProcedural Toolkit Procedural Toolkit is a procedural generation library for Unity that provides core utilities and algorithms for building PCG systems. It offers random generation helpers, mesh generation, and mathematical utilities to streamline procedural content creation. Requires Unity 2022.3 LTS or later and is installable via Package Manager or Asset Store. Syomus

Comments

0/1000

No comments yet. Be the first!