{"id":14960382,"url":"https://github.com/buildalon/unity-setup","last_synced_at":"2025-10-24T18:30:37.788Z","repository":{"id":251680197,"uuid":"838110920","full_name":"buildalon/unity-setup","owner":"buildalon","description":"A GitHub Action for setting up the Unity Game Engine for CI/CD workflows","archived":false,"fork":false,"pushed_at":"2024-09-27T00:43:33.000Z","size":211,"stargazers_count":10,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-09-27T23:01:11.290Z","etag":null,"topics":["action","automation","buildalon","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":"https://buildalon.com","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/buildalon.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}},"created_at":"2024-08-05T00:51:16.000Z","updated_at":"2024-09-22T12:04:03.000Z","dependencies_parsed_at":"2024-08-21T04:34:11.417Z","dependency_job_id":null,"html_url":"https://github.com/buildalon/unity-setup","commit_stats":{"total_commits":15,"total_committers":1,"mean_commits":15.0,"dds":0.0,"last_synced_commit":"b1791af0ddaa17da9a06da08e844c3de37484bed"},"previous_names":["buildalon/unity-setup"],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/buildalon%2Funity-setup","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/buildalon%2Funity-setup/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/buildalon%2Funity-setup/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/buildalon%2Funity-setup/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/buildalon","download_url":"https://codeload.github.com/buildalon/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","buildalon","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:09.914Z","updated_at":"2025-10-24T18:30:37.782Z","avatar_url":"https://github.com/buildalon.png","language":"TypeScript","readme":"# Buildalon Unity Setup\n\n[![Discord](https://img.shields.io/discord/939721153688264824.svg?label=\u0026logo=discord\u0026logoColor=ffffff\u0026color=7389D8\u0026labelColor=6A7EC2)](https://discord.gg/VM9cWJ9rjH) [![marketplace](https://img.shields.io/static/v1?label=\u0026labelColor=505050\u0026message=Buildalon%20Actions\u0026color=FF1E6F\u0026logo=github-actions\u0026logoColor=0076D6)](https://github.com/marketplace?query=buildalon) [![actions](https://github.com/buildalon/unity-setup/actions/workflows/validate.yml/badge.svg?branch=main\u0026event=push)](https://github.com/buildalon/unity-setup/actions/workflows/validate.yml)\n\nA GitHub Action for setting up the [Unity Game Engine](https://unity.com) for CI/CD workflows.\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, WebGL\n        modules: linux-server\n      - os: windows-latest\n        build-targets: StandaloneWindows64, Android, WSAPlayer\n        modules: windows-server\n      - os: macos-latest\n        build-targets: StandaloneOSX, Android, iOS, VisionOS\n        modules: mac-server\nsteps:\n  - uses: buildalon/unity-setup@v2\n    with:\n      version-file: 'path/to/your/unity/project/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":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbuildalon%2Funity-setup","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbuildalon%2Funity-setup","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbuildalon%2Funity-setup/lists"}