MAS Logo

Build Uploader

Unity Editor Tool For Uploading Builds To Online Services.

Steamworks Support | Open Source | Commercial Use

[![LICENSE](https://camo.githubusercontent.com/074f10d54f5948c7cc2f827d9aaa141e91308e49a77703792f92738bb9833230/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f4a616d6573566575672f556e697479537465616d4275696c6455706c6f61646572)](https://github.com/JamesVeug/UnitySteamBuildUploader/raw/main/LICENSE) [![STARS](https://camo.githubusercontent.com/c00c56796b78960f7e0ab15a607cb78583cd54ffb87edca26956e25ecdb21338/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f4a616d6573566575672f556e697479537465616d4275696c6455706c6f61646572)](https://github.com/JamesVeug/UnitySteamBuildUploader) ## Key Points 💡 - Windows, Mac, Linux support - Unity Supported - Unity 6000.1 - Unity 6000.0 - Unity 2022 - Unity 2021 - Unity 2020 and 2019 - Requires package [com.unity.sharp-zip-lib](https://docs.unity3d.com/Packages/com.unity.sharp-zip-lib@1.3/manual/Installation.html) - Services - Steamworks - Uploading a build - DRM Wrapping - Github - Upload a new Release - Unity Cloud Build - View builds - Download builds - Start new builds - Safely modify builds before uploading - Remove files/folders - Compress/Decompress files - Steam DRM wrapping (anti-piracy) - Start a new Unity build then upload with 1 button - Minimal build size impact - Can be used commercially - Open Source ## Links - Documentation: https://github.com/JamesVeug/UnitySteamBuildUploader/wiki - Support Me: https://buymeacoffee.com/jamesgamesnz - Discord: https://discord.gg/R2UjXB6pQ8 - Github: https://github.com/JamesVeug/UnitySteamBuildUploader - Asset Store: https://assetstore.unity.com/packages/tools/utilities/build-uploader-306907 ## How to Install 💿

### 1. Add package to your project #### Unity Asset Store - https://assetstore.unity.com/packages/tools/utilities/build-uploader-306907 - Add the asset to your list of assets - Add to your unity project #### Manually - Open `Window->Package Manager` - Press the `+` button in the top left - Choose `Add package from git URL` - Enter the git url `https://github.com/JamesVeug/UnitySteamBuildUploader.git` - Press `Add` - Unity 2020 and below - Repeat above steps with but using `com.unity.sharp-zip-lib` ### 2. Setup

- a. Go to `Edit->Preferences->Build Uploader` - Steamworks - Turn on Enabled - [Download SteamSDK](https://partner.steamgames.com/downloads/list) and extract it to your computer - Enter the path to the SteamSDK folder - Enter your Steamworks login details - Unity Cloud Build (Optional) - Turn on Enabled - Enter your Organization - You use this to log into https://cloud.unity.com/home/login - Enter your Project ID - You can find this in the URL of your Unity Cloud Build page eg: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx - Enter the DevOps API Key - This is found in `DevOps->Settings->API Key`

- b. Go to `Edit->ProjectSettings->Build Uploader->Open Window` - Press `New` - Enter the name of your game - Enter the AppID of your game. (Found in the URL of your games store page. eg: `1141030`) - Press `+` to create a new depot for your game - Enter a name for the depot - Enter the depot ID (Found in the Steamworks website eg: `1141031`) - Add any branches that you need (`none` is also known as default on Steamworks) - c. Go to `Window->Build Uploader->Open Window` - Go to Upload Tab (Will already be open if Unity Cloud is disabled in preferences) - Press `New` to create a Build Config - Choose where your build will come from (AKA: Source) - Choose `Folder` if you have already build game or DLC pack you want to upload - Choose `File` if you have a .zip file you want to upload - Choose `UnityCloud` if you want to Upload a build from Unity Cloud - Choose where your build will go (AKA: Destination) - Choose `Steamworks` if you want to upload to Steam - Choose which Game you want to upload it to - Choose Depot - Choose Branch - Choose `Nowhere` to test retrieving your Build and modifying it without uploading it anywhere - You can view where the modified build is in the Cache folder go going to `Edit->Preferences->Build Uploader` - Optional - Press `>` to see more details about what you're uploading and where from - Under Modifiers, you can make any additional changes - Press `Save` ### 3. Upload - Go to `Window->Build Uploader->Open Window` - Go to Upload Tab - NOTE: If you have no Builds Configs setup yet see #2c - Enable each of the Build Configs you want to upload (Checkbox at the beginning) - Enter description of the build (eg: `v1.0.1 - Hotfix to fix jumping bug`) - Press `Upload all` - If this button does not show then there will be errors mentioned in the giant button at the bottom. Fix them and repeat. > !NOTE: If you have no Builds Configs setup yet see #2c ## Upload Tab

Specify where you want builds to come from and where you want them to go. - You can specify a file/file on your computer or choose from your Unity Cloud builds. - Choose where you want the build to go (Steam depot & branch) - Add any additional modifiers to change the build before uploading - Set a description to appear on steam - Click Download and Upload all **NOTE: You can not upload to the default branch (default branch everyone uses). This is on purpose to avoid uploading the wrong build, Also the SDK does not allow this.** ## Unity Cloud Tab (Optional)

Utilize Unity Cloud to automate make builds of your project. - Tracks progress of current builds - Start a new build - Download builds ## How does it work? https://github.com/JamesVeug/UnitySteamBuildUploader/wiki#how-does-it-work ## Security 🔒 This package does NOT distribute any personal information. Any information entered is stored locally on your computer and not in plain text format. Keeping your credentials safe is important to me! If you discover any security related issues, please email me, message on discord or create an issue on [github.](https://github.com/JamesVeug/UnitySteamBuildUploader) ## Known Issues 🪳 - Steam Two-Factor authentication requires you to enter the steam guard code manually every time you upload - I Don't know why pressing "Confirm that's me" doesn't work, and it does not cache this locally like the Steam Guard Code. ## Reporting bugs / suggesting changes ❓ If you find a bug or want to suggest a change, please create an issue on the [github page](https://github.com/JamesVeug/UnitySteamBuildUploader). Include: - What the problem is - What you expected to happen - What version of Build Uploader you're using - Are you using Mac or Windows ## How to Contribute 🔨 - Fork the [repository](https://github.com/JamesVeug/UnitySteamBuildUploader) - Make your changes - Create a pull request to the `develop` branch - Include detailed description of the changes you made and why - Include what version of Unity you tested it on - Include any concerns with the changes you made (So i'm aware of them too) ## How to Support 🙏 A lot of effort has been put into this package for others to freely use. Any kind of support is greatly appreciated and encourages further work! - Star ⭐ the [Github repository](https://github.com/JamesVeug/UnitySteamBuildUploader) - Review this package on the [Asset Store](https://assetstore.unity.com/packages/tools/utilities/build-uploader-306907) - Buy me a coffee: https://buymeacoffee.com/jamesgamesnz ## License 🪪 Creative Commons - CC0 1.0 Universal Use this package however you want - commercially or non-commercially.