nl_scan.py is a Python script that scans game files for NaomiLib models and extracts them.
Exported models can be opened in Blender with Blender NaomiLib Importer Addon
- Python 3.x
- Obtain your legally owned game .GDI file and open it with GD-ROM Explorer, inside you will find multiple files that may contain game models. If you are unsure which files contain models, you can extract them all to a temporary folder.
- Download nl_scan.py
- Run
nl_scan.py. A file picker will open — select one or more files to scan. Extraction starts immediately. Models are saved next to the script in a folder named after each scanned file. - To open extracted models in Blender, install and enable Blender NaomiLib Importer Addon
-
Where are textures? Textures are usually stored in separate archives without any header. Two options:
- Dump textures using the Retroarch Flycast core (note: some textures are vertically flipped, which is correct)
- Look for game-specific scripts in this repository
-
No models found!
- When searching for models in a Dreamcast game, be sure to extract files from GD-ROM Explorer first
- Avoid scanning Track.bin — it likely contains scrambled data and will produce false positives or no results
- Files containing models are often named "POLYGON", "POL", "MDL", "MODEL", "OBJ"
- Most Naomi games use DES key encryption and zlib compression — you'll need to either map the structure or open an issue requesting support for a specific game
-
Why are models split into many pieces? This depends on how they are stored in the game. Character models in particular are often split into several parts and will need to be manually reassembled.
-
I want textures/music/sfx for game X Open an issue specifying the game — if it gets enough requests I'll look into it.
https://github.com/NaomiMod/blender-NaomiLib#supported-games
This tool is intended for educational and research purposes only. No compensation has been paid or will be accepted. All rights belong to SEGA. Resources extracted from a legally owned copy are intended for personal use only and any redistribution is forbidden. Contributors of NaomiMod are not responsible for any distribution or illegal use of the extracted files.