{"id":14960384,"url":"https://github.com/rageagainstthepixel/unity-setup","last_synced_at":"2025-10-24T18:30:39.518Z","repository":{"id":252008809,"uuid":"837774252","full_name":"RageAgainstThePixel/unity-setup","owner":"RageAgainstThePixel","description":"A GitHub action for setting up the Unity Game Engine for CI/CD workflows.","archived":false,"fork":false,"pushed_at":"2024-08-21T03:07:55.000Z","size":418,"stargazers_count":6,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-10-10T09:44:15.315Z","etag":null,"topics":["action","automation","cd","ci","ci-cd","editor","game-ci","game-development","github","github-actions","install","setup","unity","unity-editor","unity-setup","unity3d"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/RageAgainstThePixel.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"StephenHodgson","patreon":"RageAgainstThePixel"}},"created_at":"2024-08-04T01:54:04.000Z","updated_at":"2024-08-22T11:24:23.000Z","dependencies_parsed_at":"2024-08-21T06:15:48.479Z","dependency_job_id":null,"html_url":"https://github.com/RageAgainstThePixel/unity-setup","commit_stats":null,"previous_names":["rageagainstthepixel/unity-setup"],"tags_count":9,"template":false,"template_full_name":"RageAgainstThePixel/github-action-template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RageAgainstThePixel%2Funity-setup","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RageAgainstThePixel%2Funity-setup/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RageAgainstThePixel%2Funity-setup/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RageAgainstThePixel%2Funity-setup/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RageAgainstThePixel","download_url":"https://codeload.github.com/RageAgainstThePixel/unity-setup/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":219868213,"owners_count":16555876,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["action","automation","cd","ci","ci-cd","editor","game-ci","game-development","github","github-actions","install","setup","unity","unity-editor","unity-setup","unity3d"],"created_at":"2024-09-24T13:22:10.090Z","updated_at":"2025-10-24T18:30:39.512Z","avatar_url":"https://github.com/RageAgainstThePixel.png","language":"TypeScript","readme":"# unity-setup\n\nA GitHub Action for setting up the [Unity Game Engine](https://unity.com) on GitHub Action Runners.\n\n## How to use\n\n### workflow\n\n```yaml\nstrategy:\n  matrix:\n    os: [ubuntu-latest, windows-latest, macos-latest]\n    unity-version:\n      - None\n      - 2019.4.40f1 (ffc62b691db5)\n      - 2020.x\n      - 2021.3.x\n      - 2022.3\n      - 6000.0.x\n      - 6000.1.*\n      - 6000\n  include:\n    - os: ubuntu-latest\n      build-targets: StandaloneLinux64, Android, iOS\n      modules: linux-server\n    - os: windows-latest\n      build-targets: StandaloneWindows64, Android, WSAPlayer\n      modules: windows-server\n    - os: macos-13\n      build-targets: StandaloneOSX, Android, iOS\n      modules: mac-server\n    - os: macos-latest\n      build-targets: StandaloneOSX, Android, iOS, VisionOS\n      modules: mac-server\nsteps:\n  - uses: RageAgainstThePixel/unity-setup@v2\n    with:\n      version-file: 'path/to/your/ProjectSettings.ProjectVersion.txt'\n      unity-version: ${{ matrix.unity-version }} # overrides version in version-file\n      build-targets: ${{ matrix.build-targets }}\n      modules: ${{ matrix.modules }}\n\n  - run: |\n      echo \"UNITY_HUB_PATH: '${{ env.UNITY_HUB_PATH }}'\"\n      echo \"UNITY_EDITORS: '${{ env.UNITY_EDITORS }}'\"\n      echo \"UNITY_EDITOR_PATH: '${{ env.UNITY_EDITOR_PATH }}'\"\n      echo \"UNITY_PROJECT_PATH: '${{ env.UNITY_PROJECT_PATH }}'\"\n```\n\n### inputs\n\n| name | description | required |\n| ----------- | ----------- | ----------- |\n| `version-file` | Specify a path to search for the unity project version text file. Useful if there are multiple projects in a single repo. Pass `None` if creating a new project to skip file search. | false |\n| `unity-version` | Specify the Unity version(s) to install. example: `2019.4.13f1 (518737b1de84)`. ***This will override any version specified in the `version-file`!*** | false |\n| `build-targets` | Specify the build targets to install for. Remaps to corresponding module. One or more of `StandaloneWindows64` `WSAPlayer` `StandaloneOSX` `iOS` `StandaloneLinux64` `Android` `Lumin` `WebGL` `VisionOS`. | false |\n| `modules` | Modules to install with the editor. This list can be different per editor version. | false |\n| `architecture` | Specify the architecture to install. Either `x86_64` or `arm64`. | false |\n| `install-path` | Specify the path where Unity will be installed to. | false |\n| `auto-update-hub` | Automatically update Unity Hub to the latest version before installing Unity Editors. Can be `true` or `false`. Default is `true`. | false |\n\n#### unity-version formats\n\nUse any of the following patterns to control how the editor version is resolved:\n\n- Fully qualified: `2022.3.62f1` or `2019.4.40f1 (ffc62b691db5)`\n- Major + minor: `6000.2` → latest stable in the 6000.2.x line\n- Major only: `6000` or `2022` → latest stable in that major (e.g., `6000.2.1f1`, `2022.3.x`)\n- Wildcards: `2021.3.x`, `2022.3.*`, `6000.0.x`\n- Exact year+minor with trailing zero: `6000.0.0` confines selection to the 6000.0.x line\n\n\u003e [!NOTE]\n\u003e\n\u003e - If you want the latest across minors within a major, use just the major (e.g., `6000`).\n\u003e - If you want to stay within a specific minor, use `MAJOR.MINOR` (e.g., `6000.2`).\n\u003e - If you want to lock to the `.0` minor, use `6000.0.0` or `6000.0.x`.\n\u003e - Stable (f) releases are preferred unless you explicitly specify a pre-release (a/b/rc) version.\n\n### outputs\n\n- `UNITY_HUB_PATH`: The path to the installed unity hub.\n- `UNITY_PROJECT_PATH`: The path to the Unity project.\n- `UNITY_EDITOR_PATH`: The path to the last installed version of Unity.\n- `UNITY_EDITORS`: A json object array of each editor installation `[{\"version\":\"path\"},...]`.\n","funding_links":["https://github.com/sponsors/StephenHodgson","https://patreon.com/RageAgainstThePixel"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frageagainstthepixel%2Funity-setup","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frageagainstthepixel%2Funity-setup","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frageagainstthepixel%2Funity-setup/lists"}