File information
Created by
JMPZ11 - fo76utilsUploaded by
jmpz11Virus scan
About this mod
Fixes custom 3D models broken by the Starfield 1.11.36 major update in a couple clicks.
Updates .nif files - individually or in bulk - containing references to vanilla meshes prior to 1.11.36,
Now with (basically) full coverage - 99.9947% (Captured June 2024)
- Permissions and credits
- Changelogs
- Donations
Repairs .nif files broken by the Starfield 1.11.36 update - individually or in bulk.
Source Code:
https://github.com/JMPZ11/nifskope-sf-mesh/
Stats:
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.36
- Bulk mode recursively scans for all .nifs in and under a folder and processes them
- Bulk convert a folder tree of nifs to internal geometry and/or sanitize
Installation:
1. Download the Starfield .nif Mesh Path Migration Tool.
2. Open the nifskope-sf-mesh folder and run nifskope.exe.
3. Options->Settings->Resources
3a. Games tab
If the Starfield Row says "Game Not Found," browse to your game executable folder (not the data folder). For steam it is usually
C:\Program Files (x86)\Steam\steamapps\common\Starfield
3b. Paths tabClick the Add Folder Button and browse to your Starfield Data folder. For steam this is usually
C:\Program Files (x86)\Steam\steamapps\common\Starfield\Data
Note: You could add your My games data folder as wellUsage:
Many apologies, I think I fell asleep while writing this, and forgot to finish it 🤦
IMPORTANT PROCESS UPDATE:
The mesh path repair spell does not work when the "Convert to internal geometry on load" option is enabled. So you must disable this option before using the repair spell. I just found out today, so I apologize.
Fix the mesh paths
- Disable "Convert to internal Geometry on load" under Settings->NIF
- Disable Auto-Sanitizie on Save in the File menu
- Go to spells, bulk update mesh paths
- Select the folder for the mod you need to fix, hit go.
- After it finishes the last .nif, Nifskope will act like you need to save, and you can, but you don't need to.
Convert to Internal Geometry (And Sanitize) in Bulk
(Technically optional, but recommended)
- ENABLE "Convert to internal Geometry on load" under Settings->NIF
- ENABLE The Auto-Sanitizie on Save checkbox in the File menu if so desired
- Go to spells, bulk Open and Save - again browse to the same folder and go
Note: If any issues are encoutered, there will be popups. Most of them are informational - just let them stack up and close the porgram when it is done to be rid of the popups. Note2: This spell does no logging
I recommend leaving those options enabled most of the time nowadays.
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:
- Dialogs are not suppressed during bulk processing and cannot be dismissed until complete. It is annoying, but doesn't seem to impact functionality.
- It should not be necessary for nifskope to fully load and render each file - I just couldn't get saves to work if I didn't and I was in a hurry. Someone familiar with the project could likely optimize the performance dramatically.
- Add utility for performing quick manual lookups
Changelog:
For 0.4.3 and newer, see the Nexus changelog
0.4.2: Updated included NifSkope version that can convert .nifs to internal geometry, no longer requiring separate .mesh files and fully mitigating the risk of it happening again! All credit and praise belongs to the folks behind NifSkope 🎉🎉
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: