https://github.com/tcoppex/dojima

⚒ Tool to convert Way of the Samurai 4 NIF files to glTF 2.0.
https://github.com/tcoppex/dojima

converter gamebryo gamemod gltf2 netimmerse nif

Last synced: 7 months ago
JSON representation

⚒ Tool to convert Way of the Samurai 4 NIF files to glTF 2.0.

• Host: GitHub
• URL: https://github.com/tcoppex/dojima
• Owner: tcoppex
• License: unlicense
• Created: 2022-01-11T15:36:44.000Z (over 3 years ago)
• Default Branch: master
• Last Pushed: 2023-10-18T14:38:03.000Z (almost 2 years ago)
• Last Synced: 2025-01-17T00:50:54.648Z (9 months ago)
• Topics: converter, gamebryo, gamemod, gltf2, netimmerse, nif
• Language: C++
• Homepage:
• Size: 1.12 MB
• Stars: 0
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
[![unlicense](https://img.shields.io/badge/Unlicense-%23373737)](https://unlicense.org/)

![language: c++17](https://img.shields.io/badge/c++-17-blue.svg)

![Stage: alpha](https://img.shields.io/badge/-alpha-red)

# ⚒ Dojima

![](https://i.imgur.com/NXNuEpB.png)

**Dojima** is a command line tool to convert NetImmerse / Gamebryo `NIF` files from the games « _Way of the Samurai_ » 3 and 4 to `glTF 2.0`.

#### Features

- [x] mesh hierarchy (*Maps, Characters*),

- [x] float16 buffers (*Maps, Items, Accessories & Weapons*),

- [x] materials,

- [ ] bones,

- [ ] skeletal animation,

- [ ] facial animation

### Quick start

```bash

# 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](https://github.com/niftools/niflib) : library for nif IO. 

* [tinygltf](https://github.com/syoyo/tinygltf) : library for glTF 2.0 IO (*using [stb_image](https://github.com/nothings/stb) and [json.hpp](https://github.com/nlohmann/json)*).

* [half.hpp](http://half.sourceforge.net/) : Half-precision floating-point library.

* [s3tc](https://github.com/Benjamin-Dobell/s3tc-dxt-decompression) : Routines for DXT1/DXT5 decompression.

The games *`Way of the Samurai`* are available on steam [here](https://store.steampowered.com/app/427510/Way_of_the_Samurai_3) and [here](https://store.steampowered.com/app/312780/Way_of_the_Samurai_4/).

### Unlicense

_**Dojima**_ is released under *The Unlicense*.