NAME¶

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

SYNOPSIS¶

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:

List all files contained in the archive Chapter1.nwm:

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

Extract all files from the archive foo.mod:

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

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

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

SEE ALSO¶

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

More information about the xoreos project can be found on its website.

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.