Nif Eye Fixer

Important: This is not a mod you add to your load order. It is a standalone application that repairs a bug inside the mods you already have installed.Overview

NIF Eye Fixer scans your mods, finds every FaceGen head mesh with the eye ghosting bug, and fixes them all in one click.

Fix your files in place, or export the fixed meshes as a brand new mod.

The Problem

Many NPC face mods for Skyrim SE ship with a subtle rendering bug baked into their FaceGen NIF files. You have probably seen it and never knew the cause:

• A faint ghostly glow or shimmer around NPC eyes
• Eyes that look too bright, washed out, or oddly reflective
• A white haze over the eye area, especially visible on dark-eyed NPCs
• One eye that looks blind while the other looks fine
• Eyes that look fine on some NPCs but wrong on others

The cause is a single wrong setting inside the head mesh: a shader flag called Eye Environment Mapping that belongs on eye meshes, not on face skin. When a face mesh carries this flag by mistake, the game renders an extra reflective layer over the eye region of the face, creating that ghostly look.

This bug is extremely common. In a heavily modded setup with many NPC overhauls, hundreds or even thousands of head NIFs can be affected. Once you fix it, the difference is clear: eyes look natural and clean.

The Fix

The fix is the same one you would apply by hand in NifSkope: clear the incorrect Eye Environment Mapping flag, set the correct Environment Mapping flag, and make sure the standard skin shader flags are in place. NIF Eye Fixer automates it across your entire mods folder.

• Byte-perfect - the NIF parser reads and writes files without altering anything else; only the shader flags change
• Non-destructive - only NIFs that actually have the bug are modified, clean files are never touched
• FaceGen only - the scanner only looks at FaceGen head meshes, so weapon and armor NIFs that legitimately use this flag are never touched
• Verifiable - run the scan again after fixing and it will report zero affected files

Features

Scanning

• One-Click Scan - point it at your mods folder and let it work; no NifSkope, no manual editing, no technical knowledge needed
• Content-Based Detection - every NIF is parsed and inspected for the actual shader flag bug, no guessing from file names
• FaceGen Filter - only FaceGen head meshes are scanned, so scans are fast and other meshes are never at risk
• Scan All or One at a Time - sweep your whole mods folder at once, or pick a single mod from a searchable list
• Cancellable - a long scan can be stopped at any time with the Cancel Scan button

Fixing

• Fix In Place - overwrite the affected NIFs directly, right where they live
• Create Fixed Mod - instead of touching your originals, save every fixed NIF into a zip you can install as a separate mod
• Export Report - after fixing, save a Markdown report listing every fixed file, grouped by mod

Quality of Life

• Setup Wizard - supports MO2, Vortex, and manual installs; the wizard tells you exactly which folder to pick
• Detailed Results - see exactly how many files are affected and which mods they belong to, broken down by mod name
• Remembers Your Settings - your mod manager choice and folder path are saved between sessions; just open and scan
• Fast - scans thousands of NIFs with real-time progress and a responsive interface

Requirements

None. NIF Eye Fixer is a standalone desktop application. It does not require SKSE, any Skyrim plugins, or the game to be running.

Installation

1. Download the archive from the Files tab.
2. Extract the folder anywhere you like.
3. Run nif-eye-fixer.exe.

No installer, no dependencies to set up.How to Use

First Run: Setup Wizard

The first time you open the app, a short wizard walks you through three steps:

1. Choose your mod manager - Mod Organizer 2, Vortex, or Manual/Other.
2. Select your folder - the app tells you exactly which folder to pick: your MO2 mods folder, your Vortex staging folder, or your Skyrim SE Data folder.
3. Choose scan mode - scan all mods at once, or pick one mod from a searchable list.

Your choices are saved. Next time you open the app, it skips straight to scanning.

Scanning

Click Scan (or Scan Now on return visits) and the app inspects every FaceGen NIF in your selected folder, with a live progress bar. When it finishes you will see one of two things:

• Your mods are clean - no affected files found, nothing to do
• Affected files found - a summary with the total count and a breakdown by mod name

Fixing

If affected files are found, pick a fix method:

• Fix in place - overwrites the original NIF files directly; click Fix All
• Create fixed mod - saves the fixed NIFs as a zip without touching your originals; click Create Mod and choose where to save it

When the fix finishes you get a full list of everything that was repaired, grouped by mod, plus an Export Report button that saves the list as a Markdown file. Click Scan Again to verify: it should now report zero affected files.

Typical Workflow

1. Open NIF Eye Fixer.
2. Complete the setup wizard (first time only).
3. Click Scan Now.
4. Review the results and pick a fix method.
5. Click Fix All (or Create Mod).
6. Done. Launch Skyrim and enjoy clean eyes.

After installing new NPC mods, just open the app and scan again. It remembers your folder, so it takes seconds.How It Works

For the curious - you do not need to know any of this to use the tool.

The bug - it lives in BSLightingShaderProperty blocks inside FaceGen head NIFs. Bit 17 of Shader Flags 1 (SLSF1_Eye_Environment_Mapping) is incorrectly set on face skin meshes. This flag is meant for eye meshes only; when set on the face, the renderer applies an extra environment map reflection pass over the eye region of the face geometry, causing the visible glow or haze.

The fix - clears bit 17 and sets bit 7 (SLSF1_Environment_Mapping), the correct general-purpose environment mapping flag for skin shaders. It also ensures the standard skin shader flags are present: Specular, Skinned, Receive Shadows, Cast Shadows, Own Emit, Remappable Textures, and ZBuffer Test in Shader Flags 1, plus ZBuffer Write, Double Sided, Assume Shadowmask, EnvMap Light Fade, and Soft Lighting in Shader Flags 2. This matches the flag layout of correctly exported FaceGen heads.

Why it is safe - the NIF parser guarantees byte-perfect roundtrip: a file read and written back without changes is identical to the original, bit for bit. Only the shader flag bytes are altered, and only in files that actually have the bug. Scanning is restricted to FaceGenData\FaceGeom paths, so meshes that legitimately use eye environment mapping (actual eye meshes, weapons, armor) are never candidates.Troubleshooting

The app says "Not a directory"

Make sure you selected the correct folder for your mod manager. For MO2 this is the mods folder (not the MO2 install folder). For Vortex it is the staging folder. Click Change Settings to re-run the wizard.

Scan finds zero affected files but I still see the eye bug

The visual issue may have a different cause, such as a face overlay, an ENB effect, or a problem in an eye mesh rather than the face mesh. This tool specifically fixes the face skin shader flag bug in FaceGen head NIFs.

Fix finished but the bug is still visible in-game

If you use MO2, make sure the fixed files are in the winning mod (highest priority). If another mod overwrites the same NIF, scan that mod too, or adjust your mod priority. If you used Create Fixed Mod, install the zip as a new mod and place it so it wins the conflict for those files.

The scan takes a long time

Very large setups can take a minute or two. The progress bar shows real-time status, the app stays responsive, and you can cancel at any time.