Keys & Signing

Tutorial · 3:15

DayZ servers that verify signatures accept a mod only if each of its PBOs carries a signature made by a key the server trusts. This page creates your key pair, signs PBOs and checks a mod folder the way a server does. It replaces Bohemia's DSCreateKey, DSSignFile and DSCheckSignatures and produces the same files. You need packed PBOs to sign (PBO Packer or Build mod on Steam Workshop).

It is the second step of the build-and-ship path: pack, sign, test in the Launcher, publish from Steam Workshop. You create a key once; after that, Build mod signs for you with it.

The screen

First steps

  1. In Create key pair, type an authority name: your mod tag, without spaces (e.g. MyModTag).
  2. Choose an output folder outside your mod folder (for example a keys folder in your documents, or ci/keys of your project if that folder is not published).
  3. Press Generate. Two files are written, and the key becomes your default key.
  4. In Sign PBOs, choose your built mod folder (…/target/@MyMod) and press Sign. Each PBO gets a .bisign, and your .bikey is copied to @MyMod/keys/.
  5. In Check signatures, choose the same mod folder and press Check: every row must be valid.

Take the tour (in the app)

Common tasks

Create your key pair (once)

  1. Authority name, output folder, Generate.
  2. Back up the .biprivatekey somewhere safe. If you lose it you cannot sign updates with the same key, and server owners must install a new .bikey.

Sign a whole mod

  1. Private key: your .biprivatekey.
  2. Target: the @Mod folder (every addons/*.pbo is signed).
  3. Keep the tidy option ticked, press Sign, read the log.

Sign one PBO

  1. Press PBO file… and pick the .pbo.
  2. Sign. The .bisign is written next to it. If the PBO is not in an @Mod/addons folder, the log says there is no keys/ folder to copy the .bikey into.

Check a mod before giving it to a server

  1. Mod folder: the @Mod folder.
  2. Leave Trusted keys empty to check against @Mod/keys, or point it at a server's keys folder to know what that server would say.
  3. Check. Fix anything that is not valid: unsigned (sign it), unknown key (the .bikey of that signature is not among the trusted keys), INVALID (the PBO changed after it was signed: sign again).

Make a key the default

  1. Put its path in Private key, press Set as default key.
  2. The PBO page ("Sign after packing") and Build mod use it when the project has no key of its own.

Examples

This page has no example to open: it works on your own keys and mods. To see real signatures, look at a Workshop mod folder on your disk: its addons folder has a .bisign next to each .pbo and its keys folder has the author's .bikey. Checking such a folder is safe: Check only reads.

Concepts

Pitfalls

For agents

See also