Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/dcnick3/shindatautil

This is an utility for working with game files of Higurashi no Naku Koro ni and Kono Subarashii Sekai ni Shukufuku wo! Kibou no Meikyuu to Tsudoishi Boukenshata Plus (see branch konosuba) visual novels released for Nintendo Switch.
https://github.com/dcnick3/shindatautil

game-tool higurashi konosuba reverse-engineered reverse-engineering visual-novel

Last synced: 2 months ago
JSON representation

This is an utility for working with game files of Higurashi no Naku Koro ni and Kono Subarashii Sekai ni Shukufuku wo! Kibou no Meikyuu to Tsudoishi Boukenshata Plus (see branch konosuba) visual novels released for Nintendo Switch.

Awesome Lists containing this project

README 

        
 

# Overview



This is an utility for working with game files of Higurashi no Naku Koro ni visual novel released for Nintendo Switch.



There's also a `konosuba` branch with support for konosuba's flavour of scenario and some more texture formats



## Usage



`dotnet run subcommand subcommand-args`



Subcommands:



- `rom-list romname` - list files in a rom



- `rom-extract-all [--regex=filename_regex] romname destination-directory` - extract raw files (optionally filtered by regex) from rom



- `rom-extract-all-with-decode [--regex=filename_regex] romname destination-directory` - extract files (optionally filtered by regex) from rom, decoding known formats



- `[rom-]pic-decode [romname] picname outname` - decode a PIC file (optionally from rom) to png



- `[rom-]sound-remux [romname] nxaname outname` - remux a NXA file (optionally from rom)to opus



- `[rom-]font-extract [romname] fntname outname` - extract an FNT file (optionally from rom) to a bunch of png files



- `[rom-]txa-extract {--ignore-file-size} [romname] txaname outname` - extract an TXA file (optionally from rom) to a bunch of png files. `ignore-file-size` makes the tool ignore the file size specified in txa header



- `[rom-]sysse-extract [romname] syssename outname` - extract a sysse.bin file (optionally from rom) to a bunch of wav files



- `[rom-]bustup-extract [romname] bustupname outname` - extract a BUP file (optionally from rom) to a bunch of png files



- `[rom-]mask-extract [romname] mskname outname` - extract a MSK file (optionally from rom) to a png file



- `[rom-]scenario-decompile [romname] snrname outname` - disassemble an SNR file (optionally from rom) to a listing, a json file containg head data and raw dump of code section



- `scenario-build asmdir outname` - build an SNR file from a listing and json file containing head data (same structure as decompiler)



- `rom-replace-file origrom srcfile targetname outrom` - quickly replace a file in ROM by another one. Does not remove previous file contents, so avoid using this repeatedly



- `rom-build outrom [infile targetname]...` - build a ROM from scratch from specified pairs of source files and their target names



- `rom-build-from-dir outrom indir` - build a ROM from scratch from specified root directory. All files in the directory will be put to the rom with the same name



- `txa-encode srcdir outtxa` - build a TXA from the specified directory (needs an `index.txt` file to function)



- `scenario-layout [--ignore-logset] fntfile asmfile outasmfile` - transform the specified scenario asm file, doing word wrapping according to mixed English/Japanese rules. Specify `--ignore-logset` to make the layouter not modify messages of `LOGSET`. Useful, as the original game script has a typo there (`r@` vs `@r`).



- `pic-encode {--origin origin} {--quantize} {--dither} {--lossless-alpha} inpng outpic` - encode a png file into PIC, setting the origin as specified by `--origin` (default - `Bottom`). Optionally --quantize the colors to 256 using Wu's algorithm to allow to use more effective dict encoding. Add --dither to also apply dithering, improving the overall resulting look, but increasing the file size slightly. You can also specify --lossless-alpha not to apply dithering to alpha channel. This will reduce the stress on ditherer and will increase the overall number of colors, but, obviously, will increase file size.



- `pic-encode-roundtrip {--quantize} {--dither} {--lossless-alpha} inpng outpng` - encode a png file into PIC and decode it back. Allows to test the results of lossy compression. Also prints encoded size and Mean Square Error between the original and encoded image.



## Tests



Tests require the game data (most notably - `data.rom` and `patch.rom`). 



```bash

$ sha1sum data.rom patch.rom

66ce63758e955eed385f8d5c9d90698d5428e369  data.rom

3dc7e123e23fcbe2058b25ca011849e4aef252c5  patch.rom

```