nwn-lib-d ~master
Library & tooling for Neverwinter Nights 2 resource files
To use this package, run the following command in your project's root directory:
Manual usage
Put the following dependency into your project's dependences section:
nwn-lib-d
Multi-platform D library & tooling for handling Neverwinter Nights 1 & 2 resource files
Features
Command-line tools
nwn-lib-d tools are a set of command-line tools for manipulating Neverwinter Nights 2 files (and some NWN1 files). They are multi-platform (usable on Windows or GNU/Linux) and do not require the game to be installed.
[Download nwn-lib-d tools](https://github.com/CromFr/nwn-lib-d/releases)
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 json_minified
:whitecheckmark: :whitecheckmark: Same as json
but minifiedjson_legacy
:whitecheckmark: :whitecheckmark: Json, compatible with Niv nwn-lib pretty
:x: :whitecheckmark: Human-readable - Pros
- Pretty fast
- GFF nodes keeps their original ordering, making diffs very consistent
- Automated GFF modifications (set / add / remove nodes)
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-2da
- Check 2DA format
- Re-format / fix issues
- Merge rows into an existing 2DA
nwn-erf
- Create, extract or view ERF files (hak, erf, mod, pwc) 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.
- Memory efficient (files are streamed, not copied into memory)
nwn-trn
- TRN/TRX experimental tool:
trrn-export
: Export the terrain mesh, textures and grasstrrn-import
: Import a terrain mesh, textures and grass into an existing TRN/TRX filewatr-import
: Export water meshwatr-import
: Import a water mesh into an existing TRN/TRX fileaswm-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 objaswm-export
: Export walkable walkmesh into a wavefront objaswm-import
: Import a wavefront obj as the walkmesh of an existing TRX filebake
: Bake an area (prototype, placeables and walkmesh cutters are not supported)
nwn-srv
- Interact with NWN2 server:
- Measure latency (ping)
- Query server info and status
nwn-bdb
- View/search Bioware/foxpro database content (dbf + ctx + fpt) using regular expressions.
D Library
[API reference](https://cromfr.github.io/nwn-lib-d/docs)
- Supported files:
- GFF (ifo, are, bic, uti, ...)
- TLK
- 2DA
- TRN (trn, trx)
- Foxpro databases (dbf + ctx + fpt)
- DDS (limited support)
- MDB (limited support)
- Other features:
- NWN2Server querying
- Several NWScript functions re-implementations
Tips & tricks
Generate git diff from GFF & TLK files
- 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
- 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 or ldc2 (D language compiler)
- dub (D build system)
Build
# Build library
dub build
# Build nwn-gff tool
cd tools/nwn-gff
dub build
# Eventually you can append --build=release
dub build --build=release
- ~master released 8 months ago
- CromFr/nwn-lib-d
- GPL-3.0
- Copyright © 2016, Thibaut CHARLES
- Authors:
- Sub packages:
- nwn-lib-d:benchmark
- Dependencies:
- gfm:math
- Versions:
-
1.1.1 2024-Jan-08 1.1.0 2023-Oct-31 1.0.6 2023-Oct-12 1.0.5 2023-Sep-09 1.0.4 2022-Nov-28 - Download Stats:
-
-
0 downloads today
-
0 downloads this week
-
0 downloads this month
-
1000 downloads total
-
- Score:
- 1.3
- Short URL:
- nwn-lib-d.dub.pm