🐵 Embark Addon for Blender
A Blender add-on containing workflow tools for game development, created and maintained by Embark Studios.
The add-on includes tools for standardized import/export workflow, 3D modelling and new object types.
We welcome Pull Requests - if you would like to contribute, please check out the Contributing section.
The tools contain built-in update functionality, so you should only need to run through this process once!
If you don't want the add-on to auto-update, please disable the Automatically check for updates checkbox in the Preferences section of the Embark Addon.
Below is a concise list of some of the functionality offered by the Embark Blender Tools.
Export Collections are used to define lists of objects that will be exported to a single model file. The tools all use FBX for exports to game engines like Unreal, and OBJ for highpoly objects for baking.
There are a few things to keep in mind when working with the Embark Export Collection tools:
You must configure your Project source folder in the Embark Addon's Preferences panel, as shown below.
This sets the absolute root for exporting, and all export paths will be stored as paths relative to this.
All Blender scenes must be saved relative to the Project source folder
Export Collections will fail to export if your scene is not saved, or is saved under a path outside of the Project source folder!
You can create a new Export Collection from selected objects as shown here:
In the File Browser that pops up, select the location and name for your new export.
On the right, you will see some settings:
<img alt="Screenshot showing Export Collection settings" src="./images/export_collection_settings.png"/>
Select the preset that is appropriate for your asset type - this will enforce some naming conventions
If you disable Export Immediately, the Export Collection will be created, but not exported
You will now see a new Collection in the outliner, named to match the export file name you chose.
Export Collections are stored in the Blender scene, and can be modified and exported at any time.
All Export Collections are shown in the Embark panel, and Export Collections that contain the selected object will be auto-expanded.
You can use the fields on each Export Collection to modify:
Each Export Collection shown in the panel also has convenience functionality on the icon buttons shown above:
You can always press the Export All button from the Embark panel, and you can also use the Embark -> Export All Collections menu item if you aren't in a context that shows the panel. This will export every Export Collection in the current scene.
If you are working on a particular object, you can use the Export by Selection button from the Embark panel. This is also accessible via the Embark -> Export Collection(s) by Selection menu item. This will export only those Export Collections that contain any of the currently selected objects.
These commands can all be bound to hotkeys or added to the Quick menu by right-clicking on them from the Embark menu.
Accessed from the Embark -> Import menu item.
Imports objects (FBX, OBJ, PLY) using hard-coded standard settings to enforce consistency.
Accessed from the Embark -> Spiral menu item, or the 3D viewport's Add -> Curve -> Spiral menu item.
Adds a parametric spiral curve object to the scene.
Mesh editing, connects verts/edges/faces depending on selection.
Accessed from the 3D viewport's View -> Frame Contextual menu item.
Frames the selection in the 3D viewport, or frames the whole scene if nothing is selected.
We welcome community contributions to this project.
Please read our Contributor Guide for more information on how to get started.
Licensed under either of
at your option.
Unless 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.