README.md

⚒ Dojima

Dojima is a command line tool to convert NetImmerse / Gamebryo NIF files from the game « Way of the Samurai 4 » to glTF 2.0.

Features

• mesh hierarchy (Characters),
• float16 buffers (Maps, Items, Accessories & Weapons),
• materials,
• bones,
• skeletal animation,
• facial animation,
• extra properties.

Quick start

# Clone the project.
git clone https://github.com/tcoppex/dojima

# Compile using Ninja as generator (optional).
cmake dojima -B BUILD/dojima -G Ninja -DCMAKE_BUILD_TYPE=Release
cmake --build BUILD/dojima

# Run the cli converter.
#./dojima/bin/nif2gltf $WOTS4_PATH/Common/Character/Model/Pack/Dojima01.nif

Acknowledgment

Dojima is shipped with modified versions of its third parties in accordance to their respective license. They are :

• niflib : library for nif IO.
• tinygltf : library for glTF 2.0 IO (using stb_image and json.hpp).
• half.hpp : Half-precision floating-point library.
• s3tc : Routines for DXT1/DXT5 decompression.

ACQUIRE's Way of the Samurai 4 can be acquired from steam here.

Unlicense

Dojima is released under The Unlicense.