{"id":29210663,"url":"https://github.com/embarkstudios/blender-tools","last_synced_at":"2025-07-02T21:07:28.997Z","repository":{"id":54819405,"uuid":"225887315","full_name":"EmbarkStudios/blender-tools","owner":"EmbarkStudios","description":"🐵 Embark Addon for Blender","archived":false,"fork":false,"pushed_at":"2021-01-27T08:50:22.000Z","size":903,"stargazers_count":421,"open_issues_count":4,"forks_count":21,"subscribers_count":16,"default_branch":"main","last_synced_at":"2025-05-09T17:51:12.627Z","etag":null,"topics":["blender","blender-addon","blender3d","game-development","python"],"latest_commit_sha":null,"homepage":"http://embark.dev","language":"Python","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/EmbarkStudios.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE-APACHE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null}},"created_at":"2019-12-04T14:34:12.000Z","updated_at":"2025-05-06T14:36:54.000Z","dependencies_parsed_at":"2022-08-14T03:50:14.325Z","dependency_job_id":null,"html_url":"https://github.com/EmbarkStudios/blender-tools","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/EmbarkStudios/blender-tools","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EmbarkStudios%2Fblender-tools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EmbarkStudios%2Fblender-tools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EmbarkStudios%2Fblender-tools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EmbarkStudios%2Fblender-tools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/EmbarkStudios","download_url":"https://codeload.github.com/EmbarkStudios/blender-tools/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EmbarkStudios%2Fblender-tools/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263215298,"owners_count":23431895,"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":["blender","blender-addon","blender3d","game-development","python"],"created_at":"2025-07-02T21:07:28.097Z","updated_at":"2025-07-02T21:07:28.979Z","avatar_url":"https://github.com/EmbarkStudios.png","language":"Python","readme":"# 🐵 Embark Blender Tools\n\n[![Embark](https://img.shields.io/badge/embark-open%20source-blueviolet.svg)](https://embark.dev)\n[![Embark](https://img.shields.io/badge/discord-ark-%237289da.svg?logo=discord)](https://discord.gg/dAuKfZS)\n[![Build Status](https://github.com/EmbarkStudios/blender-tools/workflows/CI/badge.svg)](https://github.com/EmbarkStudios/blender-tools/actions?workflow=CI)\n\nA Blender add-on containing workflow tools for game development, created and maintained by Embark Studios.\n\nThe add-on includes [tools](#tools) for standardized import/export workflow, 3D modelling and new object types.\n\nWe welcome Pull Requests - if you would like to contribute, please check out the [Contributing](#contributing) section.\n\n## Prerequisites\n\n-   [Blender 2.81](https://www.blender.org/download/)\n\n## Installation\n\n1. Download [the latest release of the addon](https://github.com/EmbarkStudios/blender-tools/releases/latest) from Github!\n1. Launch Blender and navigate to _Edit -\u003e Preferences_, then choose the _Add-ons_ section:\n\n \u003cimg alt=\"Screenshot of Preferences menu\" src=\"./images/preferences.png\"/\u003e\n\n1. Click _Install_ in the top right of the Preferences window\n1. Use the file browser to navigate to the file you downloaded, then click _Install Add-on_:\n\n \u003cimg alt=\"Screenshot of file browser with Install Add-on option\" src=\"./images/install_addon.png\"/\u003e\n\n1. Find the Embark Addon in the add-ons list, and ensure that the checkbox is checked:\n\n \u003cimg alt=\"Screenshot showing Embark Addon with active checkbox\" src=\"./images/enable_addon.png\"/\u003e\n\n### Updating the add-on\n\nThe tools contain built-in update functionality, so you should only need to run through this process once!\n\nIf you don't want the add-on to auto-update, please disable the **Automatically check for updates** checkbox in the\n_Preferences_ section of the Embark Addon.\n\n## Tools\n\nBelow is a concise list of some of the functionality offered by the Embark Blender Tools.\n\n### Export Collections\n\nExport Collections are used to define lists of objects that will be exported to a single model file.\nThe tools all use FBX for exports to game engines like Unreal, and OBJ for highpoly objects for baking.\n\n#### Working with Export Collections\n\nThere are a few things to keep in mind when working with the Embark Export Collection tools:\n\n1. You must configure your **Project source folder** in the Embark Addon's _Preferences_ panel, as shown below.\n\n    \u003cimg alt=\"Screenshot showing Embark Addon Preferences\" src=\"./images/project_source_folder.png\"/\u003e\n\n    This sets the absolute root for exporting, and all export paths will be stored as paths relative to this.\n\n1. All Blender scenes must be saved relative to the **Project source folder**\n1. Export Collections will fail to export if your scene is not saved, or is saved under a path outside of the **Project source folder**!\n\n#### Creating a new Export Collection\n\nYou can create a new Export Collection from selected objects as shown here:\n\n1. Select one or more objects that you would like to export\n1. Click on the _Embark_ tab to the right of the 3D View\n1. Click on Create New Export Collection\n\n \u003cimg alt=\"Screenshot showing how to create an Export Collection from selected objects\" src=\"./images/create_export_collection.png\"/\u003e\n\n1.  In the File Browser that pops up, select the location and name for your new export.\n\n    -   On the right, you will see some settings:\n\n            \u003cimg alt=\"Screenshot showing Export Collection settings\" src=\"./images/export_collection_settings.png\"/\u003e\n\n    -   Select the preset that is appropriate for your asset type - this will enforce some naming conventions\n    -   If you disable **Export Immediately**, the Export Collection will be created, but not exported\n\nYou will now see a new Collection in the outliner, named to match the export file name you chose.\n\n#### Modifying an existing Export Collection\n\nExport Collections are stored in the Blender scene, and can be modified and exported at any time.\n\nAll Export Collections are shown in the _Embark_ panel, and Export Collections that contain the selected object will be auto-expanded.\n\nYou can use the fields on each Export Collection to modify:\n\n-   Output file name\n-   Export type\n-   Output folder (relative to your Embark Addon's configured **Project source folder**)\n\n\u003cimg alt=\"Screenshot showing Export Collection buttons in the Embark panel\" src=\"./images/export_collection_buttons.png\"/\u003e\n\nEach Export Collection shown in the panel also has convenience functionality on the icon buttons shown above:\n\n-   **Select** objects contained in this Export Collection\n-   **Add** selected objects to this Export Collection\n-   **Remove** selected objects from this Export Collection\n-   **Export** this Export Collection\n-   **Delete** this Export Collection from the scene\n    -   Note that the objects it contained will remain in the scene!\n\n#### Exporting objects and Export Collections\n\nYou can always press the **Export All** button from the _Embark_ panel, and you can also use the\n_Embark -\u003e Export All Collections_ menu item if you aren't in a context that shows the panel.\nThis will export every Export Collection in the current scene.\n\nIf you are working on a particular object, you can use the **Export by Selection** button from the _Embark_ panel.\nThis is also accessible via the _Embark -\u003e Export Collection(s) by Selection_ menu item.\nThis will export only those Export Collections that contain _any_ of the currently selected objects.\n\nThese commands can all be bound to hotkeys or added to the Quick menu by right-clicking on them from the _Embark_ menu.\n\n### Import\n\nAccessed from the _Embark -\u003e Import_ menu item.\n\nImports objects (FBX, OBJ, PLY) using hard-coded standard settings to enforce consistency.\n\n### Spiral Curve\n\nAccessed from the _Embark -\u003e Spiral_ menu item, or the 3D viewport's _Add -\u003e Curve -\u003e Spiral_ menu item.\n\nAdds a parametric spiral curve object to the scene.\n\n### Connect Contextual\n\nMesh editing, connects verts/edges/faces depending on selection.\n\n### Frame Contextual\n\nAccessed from the 3D viewport's _View -\u003e Frame Contextual_ menu item.\n\nFrames the selection in the 3D viewport, or frames the whole scene if nothing is selected.\n\n## Contributing\n\n[![Contributor Covenant](https://img.shields.io/badge/contributor%20covenant-v1.4-ff69b4.svg)](../CODE_OF_CONDUCT.md)\n\nWe welcome community contributions to this project.\n\nPlease read our [Contributor Guide](CONTRIBUTING.md) for more information on how to get started.\n\n## License\n\nLicensed under either of\n\n-   Apache License, Version 2.0, ([LICENSE-APACHE](LICENSE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)\n-   MIT license ([LICENSE-MIT](LICENSE-MIT) or http://opensource.org/licenses/MIT)\n\nat your option.\n\n### Contribution\n\nUnless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fembarkstudios%2Fblender-tools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fembarkstudios%2Fblender-tools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fembarkstudios%2Fblender-tools/lists"}