NAME

     unerf — BioWare ERF (.erf, .mod, .nwm, .sav) archive extractor

SYNOPSIS

     unerf [options] command archive [file ...]

DESCRIPTION

     unerf extracts BioWare ERF archives, found in many BioWare games as files with the extension
     .erf, .mod, .nwm or .sav.  Moreover, in some games, a .rim file might be an ERF instead of a
     RIM.

     There's several different versions of ERFs.  This tool supports the version V1.0, V1.1,
     V2.0, V2.2 and V3.0.

     Supported features:
     ·   Archives with stripped filenames. The name hash is searched for in a big lookup table.
         If it is not found, the file is listed and extracted as a hexadecimal representation of
         the hash
     ·   zlib-compressed files are supported and transparently decompressed
     ·   Blowfish-encrypted archives are supported and are, provided you know the password,
         transparently decrypted
     ·   Archives that contain full paths are supported.  You can either strip the directory and
         extract the plain filenames, or substitute the directory separator with a ‘=’
     ·   Archives with numerical extension IDs belonging to different games can be aliased
         accordingly.

     Unsupported features:
     ·   XOR-encrypted archives
     ·   Creating directories when extracting archives with full paths.

         Please also note that by stripped the directories of files in these archives, you might
         overwrite already extracted files

OPTIONS

     -h
     --help
           Show a help text and exit.
     --version
           Show version information and exit.
     --nwn2
           Alias file types according to Neverwinter Nights 2 rules.

           Neverwinter Nights 2 reuses a few file extension IDs differently than other BioWare
           games.  To correctly read Neverwinter Nights 2 ERF archives, use this flag.
     --jade
           Alias file types according to Jade Empire rules.

           Jade Empire reuses a few file extension IDs differently than other BioWare games.  To
           correctly read Jade Empire ERF archives, use this flag.
     --pass hex
           Password to decrypt this archive.  This password needs to be specified in hexadecimal
           notation, even if it's an ASCII string.  For example, “4CF223AB” would be a valid
           password string.  “Foobar” would not.
     --nwm file
           Calculate the MD5 of this NWM file to complement the decryption key of a HAK file for
           a Neverwinter Nights premium module.
     command
           i   Display meta-information about the archive
           l   List archive contents
           v   List archive contents with full paths
           e   Extract files to current directory
           s   Extract files to current directory with full name
     archive
           The ERF archive to read.
     file  One or more files to extract.  If none are given, the whole archive is extracted.

EXAMPLES

     View meta-information of the archive Shadowlords1.mod:

           $ unerf i Shadowlords1.mod

     List all files contained in the archive Chapter1.nwm:

           $ unerf l Chapter1.nwm

     List all files, with full path, in the archive areas.erf:

           $ unerf v areas.erf

     Extract all files from the archive foo.mod:

           $ unerf e foo.mod

     Extract the file area1.are from the archive foo.mod:

           $ unerf e foo.mod area1.are

     Extract all files, with full path, in the archive areas.erf:

           $ unerf s areas.erf

     Extract the file areas\area1.are from the archive areas.erf:

           $ unerf s areas.erf areas\\area1.are

SEE ALSO

     erf(1), fixpremiumgff(1), unherf(1), unrim(1)

     More information about the xoreos project can be found on its website: https://xoreos.org/.

AUTHORS

     This program is part of the xoreos-tools package, which in turn is part of the xoreos
     project, and was written by the xoreos team.  Please see the AUTHORS file for details.