> For the complete documentation index, see [llms.txt](https://mrcmodding.gitbook.io/arma-3-object-builder/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mrcmodding.gitbook.io/arma-3-object-builder/general/add-on-preferences.md).

# Add-on Preferences

{% tabs %}
{% tab title="General" %}

<div data-full-width="true"><figure><img src="https://418903991-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNJv4RINtC1OtMV3u9E73%2Fuploads%2Fn17mp3nmmzuh5m6Znwtm%2Faddon_preferences.png?alt=media&amp;token=8263aa21-8e16-43ac-a78a-f0b8c30a3f81" alt="General prefernces"><figcaption></figcaption></figure></div>

### Show Help Links

When the option is enabled, links to the documentation are displayed in the header of tool and properties panels.

<figure><img src="https://418903991-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNJv4RINtC1OtMV3u9E73%2Fuploads%2FspFqNvI4oGiDdJKFWENh%2Faddon_preferences_help_links.png?alt=media&amp;token=66ab8844-1a99-40a4-b232-23b56bf3da37" alt="tool panel help links"><figcaption></figcaption></figure>

### Create Backups

If the option is enabled and the target path of an export process already exists, the existing file will be given a `.bak` extension, thus becoming a backup.  The export then proceeds to write to the original file path.

<figure><img src="https://418903991-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNJv4RINtC1OtMV3u9E73%2Fuploads%2Fxp4eGUjqXcI1CHBfnaLr%2Faddon_preferences_bak_files.png?alt=media&amp;token=ca869649-6eb5-4a9c-96db-8690e53d71dc" alt=""><figcaption></figcaption></figure>

### Icon Theme

* Dark: icons with light primary color, ideal for use with dark themes of **Blender**
* Light: icons with dark primary color, ideal for use with light themes of **Blender**

### Outliner

The Outliner is a special tool panel that lists all the LOD objects in the current project file. Since this requires constant checking of object changes, it can potentially have an impact on performance depeding on the number of objects, and the used computer. This option is provided for users to disable the Outliner, should they desire.
{% endtab %}

{% tab title="Paths" %}

<figure><img src="https://418903991-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNJv4RINtC1OtMV3u9E73%2Fuploads%2FEChiq4y5LCboTGUDtP0R%2Faddon_preferences_paths.png?alt=media&amp;token=98bad8b6-fd86-48e8-8a9e-046a057c6965" alt="Path preferences"><figcaption></figcaption></figure>

### Arma 3 Tools

Path to the installation folder of the official Arma 3 Tools.

{% hint style="info" %}
Only a few functions actually require it, most functionalities work regardless if it is set.
{% endhint %}

The magnifying glass button next to the property can be used to try to automatically locate the **Arma 3 Tools** installation through registry entries.

### Project Root

Root folder where the file paths for the project starts. The value of this field is used for exporting relative file paths, and reconstructing absolute file paths upon import.

### Custom Data

File path pointing to a JSON file defining personal data for certain properties.
{% endtab %}

{% tab title="Defaults" %}

<figure><img src="https://418903991-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNJv4RINtC1OtMV3u9E73%2Fuploads%2FuJExxUtLQD6uN2NKJLba%2Faddon_preferences_defaults.png?alt=media&amp;token=eac05e9f-d9e0-4894-be9e-ab6b422b2e64" alt=""><figcaption></figcaption></figure>

### Vertex Flag

Default vertex flag value displayed in hexadecimal format.&#x20;

### Face flag

Default face flag value displayed in hexadecimal format.
{% endtab %}

{% tab title="Debug" %}

<figure><img src="https://418903991-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNJv4RINtC1OtMV3u9E73%2Fuploads%2F3tQKaMe8cphYer7LPbNB%2Faddon_preferences_debug.png?alt=media&amp;token=1b423103-84a5-42d6-aab5-96dbf08dff52" alt=""><figcaption></figcaption></figure>

### Preserve Faulty Output

Exports are first written to a `.temp` file to avoid overwriting a working file with a faulty one in case the export fails for some reason.&#x20;

<figure><img src="https://418903991-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNJv4RINtC1OtMV3u9E73%2Fuploads%2FoqSssrEx5gxhXUdUBokg%2Fimage.png?alt=media&amp;token=2b33d313-c70b-4581-91cf-7a06c76f5e9b" alt=""><figcaption></figcaption></figure>

The temporary files are cleaned up by default whether or not the export succeeds. If the option is enabled and the export fails, the temporary file is not removed and can be attached to a bug report on GitHub.

### Preserve Preprocessed LOD Objects

During the P3D export, all LOD objects and proxies are temporarily duplicated in blender in order to safely preprocess the data, without affecting the source objects. After preprocessing, these temporary objects are passed to the actual export logic. For debug purposes, the preprocessed objects can be preserved in the project file if needed.

<figure><img src="https://418903991-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNJv4RINtC1OtMV3u9E73%2Fuploads%2FDm4XZF9HBEkzEmNIuGJS%2Faddon_preferences_debug_preprocessed.png?alt=media&amp;token=43ef7c15-75fb-4a8c-b227-08350e1fcf70" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Only enable this option when really necessary.
{% endhint %}
{% endtab %}
{% endtabs %}