Brief:
Repairs .nif files broken by the Starfield 1.11.33 update - individually or in bulk.

Changelog:


0.1.3-alpha: Newly processed mapping file covers 323,099 meshes - 99.9947% of all meshes referenced in nifs the entire game. Only 17 unmapped. No code changes.
(Unless there are significant bugs or issues, this is basically feature complete)

0.1.2-alpha: This is the one you've been waiting for. See mod changelog for details - You can now run it on a folder tree, in bulk. It's kinda cool to watch - unintended benefit. We have detailed logging and reporting on number of updates as well as number of unmapped meshes. That's right. You can now be almost certain that if the tool says there were no unmapped paths, your model is completely fixed. No additional work.

0.1: Included a custom version of NifSkope that should be capable of _actually_ repairing most models that will break. Source code is available here:

https://github.com/1OfAKindMods/nifskope-sf-mesh/

There is an automated build process under actions where you can find other platforms, but you will need the data file mentioned in the readme.


That's right. It is one .nif at a time, but It actually works and produces otherwise unaltered .nifs. It even tells you how many it updated - harder that one would have expected... but I knew you would ask 😊.


Description:

Current stats (v 0.1.3-alpha):
99.9947% 1:1 match rate. (Some are not referenced, or may be from generated generated lod .nifs)
Of all the meshes referenced in standard nif files, there are only 17 unmapped.



Old game total mesh count: 356,156 (315,534 readable)
New game total mesh count: 356,060 (315,650 readable)
(There are 96 fewer meshes in 1.11.33)


Features:
- Updates .nif files individually or in bulk to ensure compatibility with game versions past 1.11.33
- Bulk mode recursively scans for all .nifs in and under a folder and processes them


Installation:
1. Download the Starfield .nif Mesh Path Migration Tool.
2. Open the nifskope-sf-mesh folder and run nifskope.





Credits:
- The many talented and dedicated individuals working on NifSkope -- this tool is now basically a NifSkope plugin so more credit to them than I.
- Used components of the Starfield Geometry Bridge - Blender Plugin  to develop and scan the source files -- we wouldn't have much custom anything without it and it really is fabulously written code
- ChatGPT for assistance translating my CSharPython'glish code into functional, documented Python.
- All the rest goes to my Lord and Savior, Jesus Christ - for without Him I am nothing.

Disclaimer:
By downloading and using this tool, you agree to absolve the author of any liability for spontaneously transforming hair into sentient spaghetti, exploding He-3 tanks, or attacks by Spacers. Mesh-related mishaps may occur, as the JSON serializer is not able to read all the vanilla nifs.

Known Issues / TODOs:
- (Done) It doesn't support all object types; it will strip off collision and may mess up flags - I can't really be sure. Good news is it always backs up the original. DONE
- DoneReplace blender plugin dll with logic from or integration into fo76utils/ce2utils version of NifSkope, as it is the only tool I'm aware of that can safely and fully roundtrip Starfield nifs (in better condition than vanilla to boot)
- This is bsically untested. I might have slipped and some strange set of circumstances will set your computer on fire. More testing is good.
- Upload to GitHub so the truly talented people can help make it better, if anyone actually cares that is.
- Add utility for performing quick manual lookups
- Add proper logging
- Tool produces a lot of extra output text that needs to be cleaned up



Support:

I refuse to join everyone's stupid Discord server, and nobody else wants to either. STOP CREATING DISCORD SERVERS. Just don't. Stop it seagulls. Stop it now! lol

Use the comments or DMs - but I can't promise anything. I'll do my best