Documentation home
Page cover image

🚀Quick Start Reference

Requirements

  • Blender 2.90.0 or higher

  • Arma 3 Tools from steam (not strictly needed, but recommended)

Aside from the technical requirements, to utilize the add-on, knowledge of the content creation process for Arma 3 is required, as well as familiarity with Blender.

Installation

The add-on can be downloaded from the public GitHub repository either as a prepacked release, or as a clone of the live repository.

For Blender 4.2 and higher, the add-on can also be installed from the official Extensions repository.

Releases

The packed releases are prepared as ZIP files and can be installed like any other add-on for Blender. If you are unsure about how to install add-ons for Blender, you can reference the Blender Manual.

Live repository

Only use the live code base if you know what you are doing, and you want to:

  • try a new feature that's not in a release yet

  • there's a bug in the last release that's not yet fixed in a new release

Using the live code base is a little more involved as you'll have to do the packaging yourself.

  1. Download the code base as a ZIP

  2. It should look like this (only folders are shown here):

  3. Unpack it to a convenient location

  4. Find the Arma3ObjectBuilder folder

  5. Put the folder into a new ZIP file identically named Arma3ObjectBuilder

At the end, you should get a ZIP file just like a prepacked release (only folders are shown here):

The add-on can then be installed in Blender like any other add-on with this ZIP file.

Setup

The setup is relatively straight forward. Once the add-on is installed, navigate to the add-on preferences. For a quick start most settings can be left on the default value, only a few options need to be touched.

You can read further about the options on the Add-on Preferences page.

Arma 3 Tools

Most functions will work regardless if this path is set, but to use everything, you want to set up this path (currently only the the Rigging tools rely on it).

The typical path is C:\Program Files (x86)\Steam\steamapps\common\Arma 3 Tools\

Project Root

The Project Root is used during P3D export and import. Relative paths are created by stripping the Project Root from the path, and absolute paths are attempted to be reconstructed by attaching the root back to the path. For most cases the default P:\ should be fine. If you don't want to deal with automatic path transformations, and would rather export the paths exactly as you input them, disable the Export Relative and Reconstruct Absolute Paths options during P3D export and import.

User Interface

A few useful links are included in the Help -> Object Builder menu.

One of the main goals of the add-on project is to have an interface that is in-line with the design of Blender, so the tools and options are where you'd normally expect them.

The elements can be found in 4 distinct places, depending on their context.

Import-Export

All import and export options can be found in the File -> Import and File -> Export menus.

You can read further about import and export options in the IMPORT and EXPORT categories, and about object setups related to them in the SETUP category.

Utility Functions

A few utility functions can be found in the Object Builder menu at the top of the 3D View.

You can find references about the functions on the Utility Functions page.

Tools

The tools are organized into panels on the sidebar of the 3D View. The panels can be found in the Object Builder category.

Each panel is home to one or more operators belonging to the same context, like proxy operations, or weight painting.

You can read further about the specific tools in the TOOLS category.

Properties

Object and material properties can be found in the properties area, in the Object Data and Material tabs respectively. The name of every property panel starts with Object Builder. These panels show the properties of the currently selected object, or material.

You can read further about the topic in the PROPERTIES category.

Last updated