Difference between revisions of "NKit"

Revision as of 11:32, 20 September 2019

WIP!!

NKit documentation is WIP. It will be added to as people ask questions and raise issues...

Overview

NKit is a Nintendo ToolKit that can Recover and Preserve Wii and GameCube disc images

Recovery is the ability to rebuild source images to match the known good images verified by Redump

Preserve is the ability to shrink any image and convert it back to the source iso

NKit can convert to ISO and NKit format. The NKit format is designed to shrink an image to it's smallest while ensuring it can be restored back to the original source data. NKit images are also playable by Dolphin

Key Uses

• Unscrub/Rebuild Wii/GC images from scrubbed/header+region hacked/wbfs(file)/iso.dec/iso/gcz to match Redump good images
• Convert Wii/GC images to NKit format (small, playable, reversible) - with optional gcz compression
• Preserve and shrink Scrubbed and Custom images
• Preserve Wii images with controlled removal of update partition

Recovery

• Recover scrubbed, header/region hacked images to match Redump verified images

Preservation - NKit Format

• Convert Redump, Hacks, Scrubbed images to NKit format and back to the original iso data

Features

• Recovery and Preservation of GameCube and Wii images
• NKit Format (smallest format and Dolphin compatible, GC is hardware compatible)
• GC NKit format aligns audio and tgc files to 32k for playability
• Wii NKit format removes hashes and encryption (Dolphin Compatible)
• Reusable library for use in other projects
• Test Mode
• Summary log of all conversions
• Rename images that match Dat file entries to a configurable mask
• Supports 100% of Redump images (Unlicensed, All Regions, Multi Disc etc)
• Scrubbed and Hacked preservation support

Formats

• GCZ support
• ISO.DEC read support
• WBFS read support
• ISO support
• RVT-R Wii ISO read support
• NKit Format support (smallest format and Dolphin compatible)
• Read the above images from Rar/Zip/7zip etc

Recovery Abilities

• Insert missing Wii Update (inc rare extra data), Channel and VC partitions
• Replace Brickblocked Update partitions
• Auto fixes modified disc headers (where the Data header remains intact)
• Fixes rare corrupt Wii partition table (caused by WBM)
• Fixes scrubbed trailing file 0's
• Fixes truncated Wii images (where the Data partition is intact)
• Fixes slightly overdumped images (from descramble tools)
• Fixes Wii Data partitions moved before 0xF800000 to save space
• Fixes compacted GC images
• Fixes moved and reordered GC files
• Fixes modified GC headers (inc. title, region hacks)
• Fixes mod chip modified GC apploaders
• Fixes GC images with non conformant junk
• Fixes modified Wii region and ratings
• Support for GC images with junk not generated with the image ID

Requirements

• Windows | Linux | Mac
• .Net or Mono 4.6.1 (Will be ported to dotnet core 3.0 soon)

Download

NKit v1.1

Documentation

• User Guide - Please read :-)
• FAQ - Coming soon...
• Glossary

Technical

• Discs : GameCube and Wii disc details
• File Systems : Info about the GameCube/Wii filesystems and gaps
• The NKit Format : Detailed information about the NKit Format

History

Version 1.1

• NKit format fix: Fixed a bug when converting Wii to NKit. This was introduced during the last 2 days of development while adding support for a Customs preservation bug.
• Fixed a minor ProcessingApp bug where the output path would be used.

Any Converted NKit Wii images from v1.0 are not corrupt. Just not 100% correct to the format. Reconverting will correct the issue. Make sure NKitReencode is set to true if reconverting images that were made with v1.0.

Version 1.0

A lot of effort has gone in to ensuring this version is as stable and reliable as possible. The NKit Format is stable and reliable. Always use FullVerify as it's always accurate as are the Hashes when CalculateHashes is on. Please report any issues and ask any questions.

• Fixed a bug in the GC Format (This alters 12 of the GC Redump images - just reencode them if you verify against NKit dats)
• Added Wii NKit Format (100% Redump tested, Scrubbed & Custom Support)
• 2 Windows (Sorry Linux & Mac users) GUI Apps added, including file extraction

Version 0.5

First stable version

Future Features

• Release the code (Yes, this WILL happen)
• WBFS output (for easy output for Wii Hardware use)
• CISO reading
• Port the code to dotnet core 3 when it's released (GUIs too)
• Port to Android

Credits

• Johnsanc - Testing, ideas and motivation
• JosJuice - Disc format and Dolphin knowledge
• GerbilSoft - Disc format knowledge (+ RVT-R) (rvthtool / rom-properties)
• Osupka - UltimateUnscrubber code
• LedZeppelin68 - Nasos (ISO.DEC) code
• Wiimm - WIT (WBFS) code
• ToeKnee - Testing
• Dack - Wii Scrubber code
• Scifi76 - Wii Scrubber dll (fst.bin) code
• All the game preservationists out there - hope this saves you some space...