Quick Start

Setup

Prerequisites

$ dotnet nuget list source
Registered Sources:
  1.  nuget.org [Enabled]
      https://api.nuget.org/v3/index.json

Installation

  1. Use dotnet tool install.
$ dotnet tool install --global Andtech.Gooball

Uninstallation

  1. Use dotnet tool uninstall.
$ dotnet tool uninstall --global Andtech.Gooball

Usage

Unity Project Commands

goo <command> [<projectPath>] [--follow] [-- <args>]
Gooball commands:
	open	Open a Unity project with a unity editor
	test	Run tests on a Unity project
	build	Build a unity project
	run		Run arbitrary Unity commands
ParameterDescriptionRemarks
projectPathThe path to the Unity project.Default: ./
--follow(Experimental) Output appended data to console as the Unity log grows.
argsArguments to pass to the Unity process (e.g. Unity.exe).

Miscellaneous Commands

List installed Unity editors

goo list

Hide assets

goo hide [--in-package <packagePath>] <assetPath>
ParameterDescriptionRemarks
--in-packageThe path to the Unity project.This folder should contain your package.json.
assetPathThe path to the asset.This will hide the asset and delete the associated meta file.

Examples

Open a Unity project with a Unity editor

$ goo MyProject

Build a Unity project

$ goo build MyProject -- -executeMethod BuildAll

Run tests on Unity project

$ goo test MyProject -- -testResults results.xml

Run arbitrary Unity commands

$ goo run -- -batchMode -quit -executeMethod ExportPackages

Hide assets from the Unity asset database

This hides assets from Unity during the import process (see Unity - Manual: Special folder names for more details)

$ goo hide MyProject/Assets/README.md
$ goo hide --in-package MyProject/Assets/MyPackage MyProject/Assets/MyPackage/Samples

List installed Unity editors

$ goo list
2021.1.24f1	[/mnt/c/Program Files/Unity/Hub/Editor/2021.1.24f1/Editor/Unity.exe]
2021.2.0f1	[/mnt/c/Program Files/Unity/Hub/Editor/2021.2.0f1/Editor/Unity.exe]