nwn-lib-d ~trx_tool

nwn-lib-d

Multi-platform D library & tooling for handling Neverwinter Nights 1 & 2 resource files

Features

Command-line tools

• nwn-gff
• Read / write GFF files (ifo, are, bic, uti, ...)

  Format	Parsing	Serialization	Comment
  gff	:whitecheckmark:	:whitecheckmark:	NWN binary. Generated binary file match exactly official NWN2 files (needs to be tested with NWN1)
  json	:whitecheckmark:	:whitecheckmark:	Json, compatible with Niv nwn-lib
  json_minified	:whitecheckmark:	:whitecheckmark:	Same as json but minified
  pretty	:x:	:whitecheckmark:	Human-readable

• Pros
  • Fast
  • GFF nodes keeps original ordering
  • Basic GFF modifications
• Cons
  • Limited serialization targets
• nwn-erf
• Create / Extract / View ERF files (erf, hak, mod, ...)
• Pros
  • Allows to set the ERF buildDate field, to create reproducible erf files.
• Cons
  • No support for NWN1 ERF
  • Not very memory efficient

Library

[API reference](https://cromfr.github.io/nwn-lib-d/)

• GFF
  • Read / Write / Modify
• TLK
  • Read only
• 2DA
  • Read only
  • May refuse to parse official 2da when incorrect

Build

Requirements

• dmd (D language compiler)
• dub (D build system)

Build

# Build library
dub build

# Build tools
dub build :nwn-gff

# Eventually you can append --build=release
dub build :nwn-gff --build=release

Command-line usage

./nwn-gff --help

Examples

# Print gff file in console
./nwn-gff -i mycharacter.bic

# Write mycharacter.bic to mycharacter.bic.txt in pretty format
./nwn-gff -i mycharacter.bic -o mycharacter.bic.txt

# Read gff from stdin, write to stdout in pretty format
./nwn-gff -j gff -k pretty