{"id":30228953,"url":"https://github.com/imjuniper/unrealbuildscript","last_synced_at":"2026-07-01T19:32:25.947Z","repository":{"id":308279164,"uuid":"1032115337","full_name":"imjuniper/UnrealBuildScript","owner":"imjuniper","description":"Small build script for UE project that can also upload to itch.io","archived":false,"fork":false,"pushed_at":"2025-11-03T20:31:15.000Z","size":23,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-11-03T22:17:52.476Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"PowerShell","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/imjuniper.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":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-04T20:39:15.000Z","updated_at":"2025-11-03T20:31:18.000Z","dependencies_parsed_at":"2025-08-05T05:24:13.035Z","dependency_job_id":"01792d4d-7971-4606-811f-9dd7af663548","html_url":"https://github.com/imjuniper/UnrealBuildScript","commit_stats":null,"previous_names":["imjuniper/unrealbuildscript"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/imjuniper/UnrealBuildScript","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imjuniper%2FUnrealBuildScript","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imjuniper%2FUnrealBuildScript/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imjuniper%2FUnrealBuildScript/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imjuniper%2FUnrealBuildScript/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/imjuniper","download_url":"https://codeload.github.com/imjuniper/UnrealBuildScript/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imjuniper%2FUnrealBuildScript/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35020870,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-01T02:00:05.325Z","response_time":130,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":[],"created_at":"2025-08-14T20:07:33.570Z","updated_at":"2026-07-01T19:32:25.930Z","avatar_url":"https://github.com/imjuniper.png","language":"PowerShell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# UnrealBuildScript\nSmall build script for UE project that can also upload to itch.io\n\n\u003c!-- no toc --\u003e\n- [Usage](#usage)\n\t- [Building](#building)\n\t\t- [Parameters](#parameters)\n\t- [Uploading to itch.io](#uploading-to-itchio)\n\t\t- [Parameters](#parameters-1)\n\n## Usage\n\nThe easiest way to use the script is copying it in your project's directory, opening the terminal and running the following:\n\n```pwsh\n.\\BuildProject.ps1\n```\n\nThis will find the `.uproject` file in the script's directory, build the game in the `Development` configuration for the `Win64` platform, and output the build to `$ProjectRoot/ArchivedBuilds`.\n\nYou can find all the command's parameters documented in the file or lower in this page.\n\n### Building\n\n#### Parameters\n\n**`-ProjectRoot:\u003cstring\u003e`**  \nWhere to find the `.uproject` file.  \n**Default value**: The script's directory (or `$EngineRoot/$ProjectName` for native projects with a `-ProjectName` specified)\n\n**`-ProjectName:\u003cstring\u003e`**  \nName of the `.uproject` file to build.  \n**Default value**: Will try to find a `.uproject` file in `$ProjectRoot` and will use it's filename.\n\n**`-TargetName:\u003cstring\u003e`**  \nName of the build target.  \n**Default value**: `$ProjectName`\n\n**`-TargetType:\u003cstring\u003e`**  \nType of target that will get built. Only used to find the output directory.  \n**Accepted values**: `Game`, `Client`, `Server`  \n**Default value**: unset\n\n**`-Configuration:\u003cstring\u003e`**  \nTarget configuration. `Debug` and `Test` are only supported in source builds.  \n**Accepted values**: `Debug`, `DebugGame`, `Development`, `Test`, `Shipping`  \n**Default value**: `Development`\n\n**`-Platform:\u003cstring\u003e`**  \nPlatform to build and cook  \n**Accepted values**: `Win64`, `Linux`  \n**Default value**: `Win64`\n\n**`-Prerequisites:\u003cstring\u003e`**  \nIf set, will bundle Unreal Engine prerequisites either as an installer or local DLLs.  \n**Aliases**: `-Prereqs`  \n**Accepted values**: `Installer`, `Local`\n\n**`-IncludeCrashReporter`**  \nIf set, will include the crash reporter in the build.  \n**Aliases**: `-CrashReporter`  \n\n**`-ArchiveRoot:\u003cstring\u003e`**  \nWhere to output the build.  \n**Default value**: `$ProjectRoot/ArchivedBuilds`\n\n**`-TimestampedArchiveFolder`**  \nIf set, will output the builds to `$ArchiveRoot\\$TargetName-$Configuration+yyyymmddThhmm` instead of just `$ArchiveRoot`.  \n**Default value**: unset\n\n**`-EngineVersion:\u003cstring\u003e`**  \nUnreal version that is used. Only used for launcher installs auto-root folder \"detection\".  \n**Default value**: 5.6\n\n**`-NativeProject`**  \nWhether this is a native project. See [this article](https://dev.epicgames.com/community/learning/knowledge-base/eP9R/unreal-engine-what-s-a-native-project) for more information. If you don't know what this means, you probably don't need it!  \n**Default value**: unset\n\n**`-EngineRoot:\u003cstring\u003e`**  \nPath to Unreal Engine.  \n**Default value**: `C:/Program Files/Epic Games/UE_$EngineVersion` (or `$ProjectRoot/..` for native projects)\n\n### Uploading to itch.io\n\nTo upload a build in the **Shipping** configuration, to the channel `windows`, run the following command:\n\n```pwsh\n.\\BuildProject.ps1 -Configuration:Shipping -PublishToItch -ItchUsername:ITCH_USERNAME -ItchGame:ITCH_GAME\n```\n\n\u003e [!TIP]\n\u003e For game jams, you will probably want to add `-Prerequisites:Local` so that the Visual C++ and other dependencies' DLLs are copied alongside the game's exe. You can also use `-Prerequisites:Installer` to bundle the installer instead.\n\n\u003e [!IMPORTANT]\n\u003e By default, the script will block you from uploading non-Shipping builds to itch.io, to prevent mistakes. You can add the `-AllowPublishNonShipping` parameter to override that behaviour.\n\nSee [itch.io's documentation](https://itch.io/docs/butler/pushing.html) for more info about channel names and the pushing process.\n\n#### Parameters\n\n**`-PublishToItch`**  \nWhether to upload the game to itch using butler. See the [butler docs](https://itch.io/docs/butler/) to learn about the upload process.  \n**Default value**: unset\n\n**`-AllowPublishNonShipping`**  \nEnables uploading of non-shipping games.  \n**Default value**: unset\n\n**`-ItchUsername:\u003cstring\u003e`**  \nUsername under which the game is hosted. See the [butler docs](https://itch.io/docs/butler/pushing.html) for more info.  \n**Required if `-PublishToItch` is set**  \n**Default value**: none\n\n**`-ItchGame:\u003cstring\u003e`**  \nName of the game being uploaded. See the [butler docs](https://itch.io/docs/butler/pushing.html) for more info.  \n**Required if `-PublishToItch` is set**  \n**Default value**: none\n\n**`-ItchChannel:\u003cstring\u003e`**  \nName of the channel where it should upload. See the [butler docs](https://itch.io/docs/butler/pushing.html) for more info.  \n**Default value**: `windows` for the `Win64` platform and `linux` for the `Linux` platform.\n\n**`-ItchCredentialsPath:\u003cstring\u003e`**  \nIf set, will use a custom credentials file. Useful if you need multiple users. See the [butler docs](https://itch.io/docs/butler/login.html) for more info.  \n**Default value**: unset\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fimjuniper%2Funrealbuildscript","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fimjuniper%2Funrealbuildscript","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fimjuniper%2Funrealbuildscript/lists"}