Archiver

Archiver is a tool for data archiving, which handles UNG files. It implements encrypting to avoid unauthorized data access.
UNG files are transparent to the engine, and their content is handled as not packed. For more details about file packing, see File System.

To invoke Archiver, run ung_x86.exe (in Windows) or ung_x86 (in Linux) from a command-line console (the 64-bit version has x64 postfix).

Archiver recognizes the following command-line options:

• -p PASSWORD — set a password. It should be the same password as passed on engine initialization on the C++ side.
  Notice

  You can skip password setting if it is not required. The engine supports loading UNG packages without password protection even if the password was specified on its initialization.
• -x FILE — exclude the specified files from packaging into the archive.
• -o NAME — name the output archive.
• -e NAME — extract files from the archive.
• -i NAME — print archive statistics.
• -c COMPRESSION_TYPE — set compression type. The following compression types are available:
  • none - no compression.
  • speed - fast performance (LZ4).
  • size - best compression (ZLIB). This option is used by default.

The following creates an archive named files.ung that contains files file.txt and file.tga using LZ4 compression:

ung_x86 -c speed -o files.ung file.txt file.tga

The following extracts all files from the archive created above:

ung_x86 -e files.ung

The following prints statistics related to the archive:

ung_x86 -i files.ung

The following creates an archive named files.ung that contains files file.txt and file.tga protected with a password "12345":

ung_x86 -p 12345 -o files.ung file.txt file.tga

The following extracts all files from the archive created above:

ung_x86 -p 12345 -e files.ung