Restart the Game
Close FFXIV completely, relaunch it and check again.
TROUBLESHOOTING
Something Not Working? We'll Help You Fix It.
Running into problems with Penumbra? Start with the quick checks below, then choose the issue that best matches what you're seeing.
Clear Solutions
Step-by-step fixes
Start Simple
Check the basics first
Stay Organized
Find the right issue quickly
START HERE
Try These Quick Fixes First
A few basic checks can resolve many common Penumbra problems.
Check Your Setup
Confirm Penumbra loads and your mod directory is available.
Verify Your Mods
Check the active collection, enabled state and mod priority.
Check for Updates
Make sure Penumbra and related components are up to date.
COMMON ISSUES
What's the Problem?
Choose the issue that most closely matches what is happening in your game.
Mods Not Showing In Game
Mods are installed but
not appearing in FFXIV.
Game Crashes or Won't Launch
Startup problems,
crashes or related errors.
Missing or Invalid Files
Problems involving mod files,
folders or paths.
Collection Issues
Mods are not applying
in the collection you expect.
Mod Conflicts
Multiple enabled mods
are affecting the same files.
Update Problems
Something stopped working
after a Penumbra or game update.
01
MOD VISIBILITY
Mods Not Showing In Game
If a mod is installed but nothing changes in game, check whether the mod is enabled and whether the correct collection is currently assigned.
- Confirm Penumbra is loaded.
- Confirm the mod appears in Penumbra.
- Make sure the mod is enabled.
- Verify the correct collection is active.
- Check whether another mod overrides it.
02
GAME STARTUP
Game Crashes or Won't Launch
If the game began crashing after changing your mod setup, reduce the number of possible causes before making more changes.
- Restart FFXIV completely.
- Disable the most recently changed mod.
- Test again with fewer active mods.
- Check whether Penumbra and Dalamud are loading normally.
03
FILES & DIRECTORIES
Missing or Invalid Files
File-related issues often happen when mod files have been moved, removed or the configured mod directory is no longer available.
- Verify your configured mod directory.
- Confirm the mod files still exist.
- Avoid manually moving individual mod folders.
- Re-import the affected mod when necessary.
04
COLLECTIONS
Collection Not Working
A mod can be enabled in one collection while your current character or context is using another collection.
- Identify which collection contains the mod.
- Make sure that collection is assigned correctly.
- Verify the mod itself is enabled there.
- Test the collection again in game.
05
MOD PRIORITY
Resolve Mod Conflicts
When multiple enabled mods change the same files, their order or priority determines which result takes precedence.
- Identify the mods affecting the same item.
- Decide which mod should take precedence.
- Adjust priority or disable the conflicting mod.
- Check the result again in game.
06
AFTER AN UPDATE
Problems After an Update
If something stops working immediately after an update, first determine whether the issue affects Penumbra itself or only a particular mod.
- Restart FFXIV after the update.
- Confirm Penumbra loads normally.
- Test the affected mod by itself.
- Check whether the mod needs its own update.
A QUICK REMINDER
Start With the Simplest Check
Troubleshooting is much easier when you change one thing at a time instead of changing several settings together.
Take It Step by Step
Test after every change.
Keep Files Organized
Avoid moving working mod folders.
Isolate the Problem
Disable likely conflicts one at a time.
STILL STUCK?
Get More Help
If the problem is still not clear, continue with the focused guides or contact us with the details of the issue.