Addon Builder: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
(Parameters for console mode)
No edit summary
Line 35: Line 35:
example: c:\addon d:\addon_build -clear -sign=c:\keys\bistudio.biprivatekey -project=c: -include=c:\include.txt -binarize=c:\mybinarize.exe
example: c:\addon d:\addon_build -clear -sign=c:\keys\bistudio.biprivatekey -project=c: -include=c:\include.txt -binarize=c:\mybinarize.exe
|NOTES=
|NOTES=
If you experience troubles to run the last version of AddonBuilder in command line, you can download an older version here: [http://tom4897.info/?attachment_id=2273 Addon Builder 1.0.3.0]
|LICENSING=
|LICENSING=
[[End User License Agreement for BI's Tools|Bohemia Interactive End User License Agreement]]
[[End User License Agreement for BI's Tools|Bohemia Interactive End User License Agreement]]

Revision as of 14:18, 7 May 2015

Basic information

Author:
Bohemia Interactive
Compatibility:
Arma 3
Download:
Part of Arma 3 Tools package on Steam

Description

Description:
Addon Builder is a packing tool created by Bohemia Interactive. The purpose of this tool is to convert all data into formats readable by RV Engine and pack them into a single PBO archive. The tool was formerly known as BinPBO

Usage

Line call:
AddonBuilder.exe
AddonBuilder.exe -help
Options:
Addon Builder can used in console mode with the following parameters:
  • -packonly: only stores the folder to a PBO. Do NOT binarize files. I.e. binarization is default behaviour
  • -clear: before binarizing, the content of subfolder for the current project is deleted.
  • -temp: path for the folder which stores binarized files, default destination is temp in Windows, if no value is present then the last folder is used, if you use the same folder, the next time you binarize the same addon it will take less time.
  • -prefix: relative path to files used in addon, if not present then this value is calculated automatically.
  • -project: path to folder where project starts from, if you are packing only the path of a project.
  • -sign: *.biprivatekey file with signature, addons created with a signature can be added to secure servers.
  • -include: directly copy matched files to PBO. absolute path to file with wildcard patterns. separator is ';' and ','.
  • -binarize: path to binarize tool. default is used if not specified.
  • -cfgconvert: path to cfg convert tool. default is used if not specified.
  • -filebank: path to filebank tool. default is used if not specified.
  • -dssignfile: path to DssignFile tool. default is used if not specified.
example: c:\addon d:\addon_build -clear -sign=c:\keys\bistudio.biprivatekey -project=c: -include=c:\include.txt -binarize=c:\mybinarize.exe

Licenses

Licensing:
Bohemia Interactive End User License Agreement
See also:
BinPBO


Options

Clear temp folder

This checkbox in main screen of the interface allows user to pack clean data without any interference. Packing takes longer after cleaning temp folder, but data cannot be affected by previous versions. Use this regularly if you pack data referencing other addons to ensure everything is correctly referenced.

Create signature

Use this option to create digital signatures of the PBOs using digital key defined in options. Use DSCreateKey to create the key to work with.

Binarize

This option allows you to convert possible files in addon into format readable by RV Engine. Leave this checked most of the time unless you want to publish the MLODs for some reason for example.

List of files to copy directly

This is list of files (with possible use of wild-cards) to copy directly from source directory to the packed addon. Some files are added by default and the rest has to be mentioned in here.

Create log file

Checkbox to allow creating of addon_name.log file in output directory with logs from packing. These logs show a lot of warnings and errors and are useful to fix some basic errors.

Path to signature file

Use this path to a key if you want to sign your PBO with digital signature, leave it empty otherwise.

Path to temporary folder

The addon is going to be processed in temporary folder during its building, the folder is set to the Windows temporary folder by default. You may want to clean the folder by Clear temp folder option in main menu of the Addon Builder.

Path to project folder

Is the same as path to source directory by default, may be set to different values to enable linking from different addons.

Addon prefix

Use this option to set the path prefix to the structure of the addon.