PBO Packer

Tutorial · 3:09

A PBO is the archive format DayZ loads: the game does not read loose folders, it reads one .pbo file per addon folder of a mod. This page packs an addon folder into a PBO (what Bohemia's AddonBuilder does) and opens any existing PBO to list, preview and extract its files. Use it to pack a single addon by hand or to study how a vanilla or third-party addon is made. You need an addon folder (a folder with a config.cpp) to pack; nothing to browse.

Packing is the first step of the build-and-ship path: pack here, sign on Keys & Signing, test in the Launcher, publish from Steam Workshop. For a mod with several addon folders, Build mod on the Steam Workshop page does the first two steps for the whole mod at once.

The screen

First steps

  1. Open PBO Packer; the Pack tab is shown.
  2. In Addon folder, pick the folder that holds your config.cpp.
  3. Look at Prefix. If the badge "No $PBOPREFIX$ and no prefix" shows, press Write $PBOPREFIX$ from the folder name (or type a prefix such as MyMod\scripts).
  4. Leave Binarize config.cpp ticked. Tick Sign after packing if you already have a key.
  5. Press Pack. The log says where the PBO was written.
  6. Switch to Browse & extract, open the PBO you just made and check its prefix and files.

Take the tour (in the app) · Tour: look inside a PBO (in the app)

Common tasks

Pack one addon folder

  1. Pack tab, choose the Addon folder.
  2. Check the prefix, keep Binarize ticked.
  3. Pack. A green line in the log gives the output path.

Pack and sign in one go

  1. Tick Sign after packing.
  2. Choose your .biprivatekey (the default key of Keys & Signing is prefilled).
  3. Pack. The log adds "Signed → …bisign". If only the signature fails, the PBO is still written and the log says so.

Look inside a vanilla PBO

  1. Browse & extract tab, Open PBO, pick a file of <DayZ>/Addons (or use the example).
  2. Type in the filter (config, .p3d, .paa…).
  3. Click a row to preview it. config.bin is shown as readable config text.

Extract a PBO to read or reuse its files

  1. Open the PBO, press Extract all.
  2. Choose a destination folder: the files go to <destination>/<pbo name>/.
  3. The PBO itself is not changed. Do not redistribute other authors' files.

Leave files out of a PBO

  1. Pack tab, right card.
  2. Add one pattern per line, for example *.psd or docs/*.
  3. The patterns are remembered with the folder.

Examples

Concepts

Pitfalls

For agents

See also