{"id":13730960,"url":"https://github.com/Voltstro-Studios/UnityVoltBuilder","last_synced_at":"2025-05-08T03:32:24.319Z","repository":{"id":56643803,"uuid":"259264988","full_name":"Voltstro-Studios/UnityVoltBuilder","owner":"Voltstro-Studios","description":"An in-editor, modular tool to make Unity game builds easier and more convenient","archived":false,"fork":false,"pushed_at":"2022-08-11T11:54:58.000Z","size":695,"stargazers_count":14,"open_issues_count":0,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-10-30T00:04:38.448Z","etag":null,"topics":["build","build-tool","builder","csharp","editor","unity","unity-build","unity-build-tool","unity-editor","unity-editor-gui","unity-gui","unity-script","unity-scripts","unity2d","unity3d"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Voltstro-Studios.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-04-27T09:20:58.000Z","updated_at":"2024-07-02T04:46:40.000Z","dependencies_parsed_at":"2022-08-15T22:31:16.170Z","dependency_job_id":null,"html_url":"https://github.com/Voltstro-Studios/UnityVoltBuilder","commit_stats":null,"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Voltstro-Studios%2FUnityVoltBuilder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Voltstro-Studios%2FUnityVoltBuilder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Voltstro-Studios%2FUnityVoltBuilder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Voltstro-Studios%2FUnityVoltBuilder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Voltstro-Studios","download_url":"https://codeload.github.com/Voltstro-Studios/UnityVoltBuilder/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224319366,"owners_count":17291828,"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":["build","build-tool","builder","csharp","editor","unity","unity-build","unity-build-tool","unity-editor","unity-editor-gui","unity-gui","unity-script","unity-scripts","unity2d","unity3d"],"created_at":"2024-08-03T02:01:22.073Z","updated_at":"2024-11-14T21:31:57.232Z","avatar_url":"https://github.com/Voltstro-Studios.png","language":"C#","readme":"# Unity Volt Builder\n\n[![License](https://img.shields.io/github/license/Voltstro-Studios/VoltUnityBuilder.svg)](/LICENSE.md)\n[![Discord](https://img.shields.io/badge/Discord-Voltstro-7289da.svg?logo=discord)](https://discord.voltstro.dev) \n[![YouTube](https://img.shields.io/badge/Youtube-Voltstro-red.svg?logo=youtube)](https://www.youtube.com/Voltstro)\n\nVoltstro-Studios' Unity build tool, with a modular scripting design.\n\n## Features\n\n- Easy to get at menu of settings to build your Unity player.\n- Build Actions (Can add custom GUI to the tool, do something before and after a build)\n\t- Three are provided, CopyFilesOnBuild, RunOnBuild and [ZipOnBuild](#ZipOnBuild)\n- Easily do a \"Quick\" build, a new build, or a scripts only build.\n- Easily add additional commands to the main window\n- [Addressables](#addressables) commands\n\n## Installation\n\nThere are three main sources on how you can install this package. Pick which ever one suites you the best!\n\n### Voltstro UPM\n\nYou can install this package from our custom UPM registry. To setup our registry, see [here](https://github.com/Voltstro/VoltstroUPM#setup).\n\nOnce you have the registry added to your project, you can install it like any other package via the package manager.\n\n### OpenUPM\n\nYou can install this package via [OpenUPM](https://openupm.com/).\n\nTo install it, use their CLI:\n\n```bash\nopenupm-cli add dev.voltstro.unityvoltbuilder\n```\n\n### Git\n\nTo install it via the package manager with git you will need to:\n\n1. Open up the package manager via Windows **-\u003e** Package Manager\n2. Click on the little + sign **-\u003e** Add package from git URL...\n3. Type `https://github.com/Voltstro-Studios/UnityVoltBuilder.git` and add it\n4. Unity will now download and install the package\n\nPlease note that you will have to manually check for updates, and replace the hash (or tag version) in your project's `packages-lock.json` file.\n\n## Using the tool\n\nTo use the tool, go to Tools **-\u003e** Unity Volt Builder **-\u003e** Volt Builder. It will open up a screen that looks like this:\n\n![Preview](Media~/preview.jpg)\n\n(Note: This is the window when [Addressables](#addressables) are installed)\n\nIt is recommended to dock the window somewhere for convince.\n\n### Build Actions\n\nYou can add build actions under the 'Build Actions' menu, the select what build action you want to add by selecting it in the dropdown, then press the '+' button.\n\n#### ZipOnBuild\n\nThis build action requires the [`com.unity.sharp-zip-lib`](https://docs.unity3d.com/Packages/com.unity.sharp-zip-lib@latest/) package to be installed. By default, the package DOES NOT appear under the Unity Registry menu in the package manager, you will need to add it manually by either altering your `manifest.json` file, or by typing `com.unity.sharp-zip-lib` into the Add package from git URL option in the package manager.\n\n#### Custom Build Actions\n\nTo add a custom Build Action, add a class to your project, and make it implement `IBuildAction`. You will then need to add the required methods: `OnGUI()`, `OnBeforeBuild(string buildLocation, BuildTarget buildTarget, ref BuildOptions buildOptions)`, and `OnAfterBuild(string buildLocation, BuildReport report)`.\n\nIn the end it should look like this:\n\n```csharp\nusing UnityVoltBuilder.Actions;\n\npublic class CustomBuildAction : IBuildAction\n{\n\tpublic void OnGUI()\n\t{\n\t\t//Do your GUI stuff here\n\t}\n\n\tpublic void OnBeforeBuild(string buildLocation, BuildTarget buildTarget, ref BuildOptions buildOptions)\n\t{\n\t\t//Do stuff you want to do before a build, if you want to you can modify the build options here as well\n\t}\n\n\tpublic void OnAfterBuild(string buildLocation, BuildReport report)\n\t{\n\t\t//Do stuff here after a build\n\t}\n}\n```\n\nAfter that, the tool will automatically add it as a selectable option in the dropdown in the Build Actions.\n\n### Addressables\n\nIf you have the [Unity Addressables package](https://docs.unity3d.com/Packages/com.unity.addressables@latest/manual/index.html) installed, additional commands will be provided in the main window, which will allow you to both build the addressables and change the play mode script without needing the Addressables Groups window opened.\n\n## Authors\nVoltstro – *Initial Work* – [Voltstro](https://github.com/Voltstro)\n\n## License\nThis project is licensed under the Apache-2.0 license – see the [LICENSE.md](/LICENSE.md) file for details.\n","funding_links":[],"categories":["C#"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FVoltstro-Studios%2FUnityVoltBuilder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FVoltstro-Studios%2FUnityVoltBuilder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FVoltstro-Studios%2FUnityVoltBuilder/lists"}