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.

Debian                                            June 27, 2018                                         UNERF(1)