nwn-lib-d 0.0.9

nwn-lib-d

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

Features

Command-line tools

[Download nwn-lib-d tools](https://cromfr.github.io/nwn-lib-d/)

• 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-tlk
• Serialize TLK files to readable text.

  Format	Parsing	Serialization	Comment
  tlk	:whitecheckmark:	:whitecheckmark:	NWN TLK binary format
  text	:x:	:whitecheckmark:	Human-readable

• nwn-erf
• Create, extract or view ERF files (hak, erf, mod) in a reproducible manner (same content => same checksum).
• Pros
  • By default sets the ERF buildDate field to a 0 value, to create reproducible erf files.
• Cons
  • No support for NWN1 ERF
  • Not very memory efficient (all files are loaded to memory before the erf file is written)
• nwn-bdb
• View/search Bioware/foxpro database content (dbf + ctx + fpt) using regular expressions.
• nwn-trn
• TRN/TRX experimental tool:
  • trrn-export: Export the terrain mesh, textures and grass
  • trrn-import: Import a terrain mesh, textures and grass into an existing TRN/TRX file
  • watr-import: Export water mesh
  • watr-import: Import a water mesh into an existing TRN/TRX file
  • aswm-strip: Reduce walkmesh data size by removing non-walkable triangle & related data. Can reduce LZMA-compressed files to 50% of their non-stripped size (depending on the amount of unused triangles of course).
  • aswm-export-fancy: Export custom walkmesh data into a colored wavefront obj
  • aswm-export: Export walkable walkmesh into a wavefront obj
  • aswm-import: Import a wavefront obj as the walkmesh of an existing TRX file
  • bake: Bake an area (placeables and walkmesh cutters not supported)
• nwn-srv
• Interact with NWN2 server:
  • Measure latency (ping)
  • Query server info and status

Library

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

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

Tips & tricks

Generate git diff from GFF & TLK files

1. Configure Git to use the tools

• Using git command line:

  git config --global diff.gff.textconv "$PATH_TO_NWNLIBD_TOOLS/nwn-gff -i \$1"
  git config --global diff.tlk.textconv "$PATH_TO_NWNLIBD_TOOLS/nwn-tlk -i \$1"

• Or by editing .gitconfig:

  [diff "gff"]
    textconv = 'C:\\Program Files\\nwn-lib-d\\nwn-gff' -i $1
  [diff "tlk"]
    textconv = 'C:\\Program Files\\nwn-lib-d\\nwn-tlk' -i $1

1. Configure your git repository to use GFF / TLK diff by creating .gitattributes file:

#Areas
*.[aA][rR][eE] diff=gff
*.[gG][iI][cC] diff=gff
*.[gG][iI][tT] diff=gff

#Dialogs
*.[dD][lL][gG] diff=gff

#Module
*.[fF][aA][cC] diff=gff
*.[iI][fF][oO] diff=gff
*.[jJ][rR][lL] diff=gff

#Blueprints
*.[uU][lL][tT] diff=gff
*.[uU][pP][eE] diff=gff
*.[uU][tT][cC] diff=gff
*.[uU][tT][dD] diff=gff
*.[uU][tT][eE] diff=gff
*.[uU][tT][iI] diff=gff
*.[uU][tT][mM] diff=gff
*.[uU][tT][pP] diff=gff
*.[uU][tT][rR] diff=gff
*.[uU][tT][tT] diff=gff
*.[uU][tT][wW] diff=gff

#Others
*.[pP][fF][bB] diff=gff
*.[tT][lL][kK] diff=tlk

Build

Requirements

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

Build

# Build library
dub build

# Build nwn-gff tools
dub build :nwn-gff

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