How to Install Eye Mods in FFXIV Penumbra

Eye mods are one of the easiest ways to customize your Final Fantasy XIV character. They can change iris colors, limbal rings, catchlights, pupils, sclera details, textures, glow effects, or the overall style of your character’s eyes.

This guide explains how to install eye mods in FFXIV Penumbra, from downloading a compatible mod to importing it, assigning it to your character collection, enabling the right option, and fixing common eye-texture problems.

Penumbra is third-party software and is not an official Square Enix tool. Use mods at your own risk, follow FFXIV rules, keep cosmetic changes private and respectful, and download files only from sources you trust.

Table of Contents

Quick Answer: How to Install Eye Mods in FFXIV Penumbra

To install an FFXIV eye mod with Penumbra:

Download a Penumbra-compatible eye mod from a trusted creator.
Open FFXIV and open the Penumbra plugin.
Go to the Mods tab.
Use Import Mod and select the mod file.
Wait for the import to finish.
Enable the eye mod in your active collection.
Select the correct race, gender, face, eye type, and optional color variant.
Refresh your character by changing areas, reopening the Character window, or re-equipping gear.

Penumbra is a runtime FFXIV mod loader that lets users enable and disable mods, manage conflicts, and use collections without directly changing original game files.

What Are FFXIV Eye Mods?

FFXIV eye mods are cosmetic files that change how character eyes appear on your own game client. Depending on the creator and mod package, an eye mod may include:

New iris textures.
Different pupil shapes.
Enhanced catchlights.
Heterochromia options.
Glow or fantasy eye effects.
Realistic eye textures.
Anime-inspired eye styles.
Face-specific eye adjustments.
Race-specific eye variants.
Male, female, or unisex options.

Most eye mods are texture replacements. They typically affect only the selected character race, face, and eye material path defined by the mod.

Before You Install an Eye Mod in Penumbra

Check compatibility before importing anything.

A mod page should clearly state:

Supported FFXIV game version or update status.
Supported race or races.
Supported gender.
Supported face number.
Whether it changes both eyes or one eye.
Whether it supports heterochromia.
Required body, face, or texture framework, if any.
Whether it is packaged for Penumbra.
Whether the creator permits edits, conversions, or personal changes.

Do not assume that an eye mod made for one race, face, or gender will work correctly on another.

Step 1: Install and Enable Penumbra

Before installing an eye mod, Penumbra must already be installed and enabled through your FFXIV plugin setup.

Once Penumbra is running, open its interface from the plugin menu or your configured command.

Penumbra supports mod loading without directly modifying the original FFXIV installation and allows mods to be enabled or disabled without restarting the game.

If Penumbra is not installed correctly, fix that first before importing any eye mods.

Step 2: Download a Compatible Eye Mod

Download your chosen eye mod only from a creator or mod platform you trust.

Many Penumbra-compatible mods are provided as:

.pmp files.
.ttmp2 files.
ZIP archives containing an importable mod package.
A folder prepared for manual installation.

Before importing, scan the download and read the creator’s instructions.

Important: Do Not Use Unknown Executable Files

An eye mod should normally contain mod assets and package data—not unrelated programs.

Avoid downloads that ask you to:

Run an unknown .exe file.
Disable security software.
Share your account credentials.
Paste browser cookies or tokens.
Install an unrelated “mod manager.”
Download a file from an untrusted re-upload source.

Step 3: Import the Eye Mod into Penumbra

Open Penumbra and go to the Mods tab.

Look for the import option, which may be labeled similarly to:

Import Mod

Then:

Select the eye-mod package.
Choose the file you downloaded.
Confirm the import location if Penumbra asks.
Wait for Penumbra to finish processing the package.
Find the imported eye mod in your installed-mod list.

The exact button names can vary slightly by Penumbra version, but the workflow remains the same: import the package, find it in the Mods list, and enable it in the appropriate collection.

Step 4: Enable the Eye Mod in Your Active Collection

Importing a mod does not always mean it is active. You must enable it in the collection assigned to your character.

In Penumbra:

Select your active character collection.
Find the newly imported eye mod.
Turn the mod on.
Expand the mod options if it includes multiple variants.
Choose the option that matches your character.

Penumbra uses collections to control which mods apply to which characters or situations. This helps you keep a personal eye mod from affecting every character or NPC.

Step 5: Choose the Correct Eye-Mod Option

Most eye mods include several options. Select the one that matches your character exactly.

Check:

Race.
Gender.
Face number.
Eye type.
Left or right eye.
Standard eyes or heterochromia.
Glow or non-glow variant.
Vanilla-compatible or framework-specific version.
Makeup-compatible or no-makeup version.

Some mods use single groups, where only one option can be active. Others use multi groups, where multiple compatible options can be enabled together. Penumbra supports both group types for mod options.

Example Eye-Mod Option Structure

A creator may organize options like this:

Mod option group	Example choices
Race	Miqo’te / Au Ra / Viera / Hyur
Gender	Male / Female
Face	Face 1 / Face 2 / Face 3 / Face 4
Eye style	Natural / Fantasy / Glow
Color variation	Blue / Green / Purple / Red
Special effect	Catchlight On / Catchlight Off

Always use the creator’s compatibility notes as the final reference.

Step 6: Refresh Your Character Appearance

After enabling the eye mod, FFXIV may not update the texture immediately.

Try one of these refresh methods:

Open and close the Character window.
Change to another gear set.
Re-equip a facewear or head item.
Change areas or teleport.
Reload the active Penumbra collection.
Restart the game only if necessary.

Penumbra notes that changed files can often update after a map change or after closing and reopening a relevant game window.

How to Install Heterochromia Eye Mods in Penumbra

Heterochromia eye mods give your character different colors or styles in the left and right eye.

To install one successfully:

Confirm the mod supports your character’s face and race.
Import the mod into Penumbra.
Enable the main eye-texture option.
Select the heterochromia variant if the mod includes one.
Disable any conflicting eye mod that changes the same face texture.
Refresh your character model.

If both eyes show the same color, you may have selected the standard eye option instead of the heterochromia option.

How to Install Glow Eye Mods in FFXIV Penumbra

Glow eye mods can look dramatic in Gpose, low-light areas, and screenshots. However, they may conflict with reshade presets, face textures, eye reflections, or other material edits.

For glow eye mods:

Start with the creator’s recommended version.
Test the effect in normal lighting and Gpose.
Check whether the mod includes a subtle and bright version.
Disable any other eye glow or face material mod.
Avoid stacking two eye texture mods unless the creators state they are compatible.

How to Install Eye Mods for Specific Races

Eye textures are often race-specific because FFXIV face and eye materials vary between character models.

Miqo’te Eye Mods

Check whether the mod supports your chosen face, eye shape, and clan. Some Miqo’te mods include additional catchlight or pupil options.

Au Ra Eye Mods

Au Ra eye mods may include race-specific iris, limbal ring, or scale-adjacent texture adjustments. Confirm whether the mod supports male or female Au Ra and your selected face.

Viera Eye Mods

Viera eye mods may need face-specific options because ear, eye, and face textures can vary. Test them with your hairstyle and head gear.

Hyur, Elezen, Lalafell, Roegadyn, and Hrothgar Eye Mods

Always check race, gender, face number, and mod version. A mod can import successfully but still look wrong when applied to an unsupported face.

Penumbra’s advanced editing documentation explains that race and gender can require dedicated models or materials, which is why creator-provided race options matter.

Why Is My Eye Mod Not Showing?

If your eye mod is enabled but does not appear, work through this checklist.

Check the Active Collection

Make sure the collection containing the eye mod is assigned to your character.

Check the Correct Face and Race Option

A face 1 texture may not affect face 3. Select the exact option intended for your character.

Disable Other Eye Mods

Two eye mods often replace the same texture path. In that situation, one mod may override the other.

Check Mod Priority

If multiple mods affect the same files, Penumbra uses mod order and option priority to resolve the conflict. Change the priority carefully and test again.

Refresh the Character Model

Teleport, reopen a character-related window, or reload the collection.

Update the Mod

An outdated eye mod may not work properly after an FFXIV patch or graphics update. Check the creator’s official page for an updated release.

Common FFXIV Eye Mod Problems and Fixes

Eye Mod Looks Black, White, or Missing

This can happen when the texture is incompatible, corrupted, outdated, or overridden by another face mod.

Try:

Disable all other face and eye mods.
Enable only the eye mod.
Choose the correct race, gender, and face option.
Reimport the original mod package.
Check for a game-version update from the creator.

The Wrong Eye Color Appears

You may have selected the wrong option group. Recheck color, glow, left-eye, right-eye, and heterochromia settings.

The Eye Mod Changes NPC Eyes

Your mod may be active in a broader collection than intended. Assign it to a personal collection instead of a general collection.

Face Makeup or Face Texture Disappears

The eye mod may replace a broader face texture rather than an eye-only texture. Check whether the creator provides a makeup-compatible version.

The Mod Works in Gpose but Not Normally

Refresh your character outside Gpose, verify your Penumbra collection assignment, and check for a conflict with another appearance plugin or mod.

How to Remove an Eye Mod from Penumbra

To remove an eye mod safely:

Disable the mod in your active collection.
Refresh your character model.
Confirm that the vanilla eyes have returned.
Delete the mod from Penumbra only if you no longer need it.
Keep a backup if you plan to reinstall it later.

Disabling a mod first helps you confirm that it was the source of the visual change.

Best Practices for Installing FFXIV Eye Mods

Follow these best practices for a clean Penumbra setup:

Download only from reputable creators and platforms.
Read the full mod description before importing.
Keep an organized folder of original mod downloads.
Use one eye texture mod at a time unless compatibility is confirmed.
Assign eye mods to a character-specific collection.
Test new mods without other face mods enabled.
Back up your Penumbra settings before major changes.
Respect creator permissions, credits, and redistribution rules.
Keep modded screenshots private and respectful.
Do not use cosmetic modding to disrupt or deceive other players.

FAQ: Install Eye Mods FFXIV Penumbra

How do I install an eye mod in Penumbra?

Import the mod from Penumbra’s Mods tab, enable it in your active collection, and choose the race, face, and eye option that matches your character.

Why is my eye mod not working?

The most common causes are incorrect face options, a disabled collection, a mod conflict, outdated files, or an appearance-refresh delay.

Can I use more than one eye mod at once?

Usually, no. Most eye mods replace the same eye texture path, so one can override the other. Use one main eye mod unless the creators confirm compatibility.

Do I need to restart FFXIV after installing an eye mod?

Usually not. Try refreshing the character model first by teleporting, reopening the Character window, or reloading your Penumbra collection.

Can eye mods affect other players?

Normally, cosmetic mods are local to your client. Keep in mind that third-party synchronization tools and shared screenshots introduce privacy, consent, and rule-compliance concerns

Conclusion

Installing eye mods in FFXIV Penumbra is simple once you follow the right order: download a trusted, compatible mod; import it through Penumbra; enable it in the correct collection; select the matching race, face, and eye option; then refresh your character model.

For the best results, use one eye mod at a time, test for conflicts, respect creator permissions, and keep your Penumbra collection organized. A carefully chosen eye mod can make your FFXIV character feel more personal while keeping your setup clean and easy to manage.