What Is FFXIV Penumbra?
FFXIV Penumbra is a Dalamud plugin used to load and manage supported mods for Final Fantasy XIV while the game is running. Instead of permanently overwriting the original game files, Penumbra handles supported visual changes through its own mod-management system.
This makes everyday mod management easier. You can keep your mods in one place, enable or disable them when needed, change their settings, organize different configurations, and control which mod should take priority when two modifications affect the same game resource.
Penumbra is a mod manager. It is not a game launcher and it is not a website for downloading mods.
How Does FFXIV Penumbra Work?
Penumbra runs inside the Dalamud plugin environment. After Penumbra is installed, supported mod packages can be imported into its interface and managed from there. Penumbra keeps track of settings such as whether a mod is enabled, which options are selected, and how its priority compares with other installed mods.
Dalamud and XIVLauncher
Dalamud provides the plugin environment that Penumbra needs in order to run. Many players use XIVLauncher to start Final Fantasy XIV with Dalamud available. Penumbra can then be installed through Dalamud's plugin system.
If you are starting from the beginning, use our Penumbra installation guide first. After installation, continue with the setup guide to configure the important options.
Changes Are Managed at Runtime
Penumbra applies supported visual changes while the game is running. That makes it much easier to test different setups, switch mods on or off, and make adjustments without repeatedly replacing the same files by hand.
What Can You Do With Penumbra for FFXIV?
Penumbra can manage many types of supported visual modifications, including changes involving character appearance, equipment, textures, models, materials, and other game assets used by compatible mods.
If you want to understand the complete workflow, continue to our FFXIV Penumbra mods guide .
Mods, Collections, and Priorities
Three concepts become especially important as your Penumbra setup grows: mods, collections, and priorities. Understanding these makes it much easier to organize your setup and troubleshoot unexpected results.
Why Mod Priorities Matter
Two enabled mods can sometimes affect the same resource. When that happens, priority helps determine which modification should take precedence. This lets you resolve many conflicts without immediately deleting one of the mods.
Collections Keep Setups Organized
Collections allow different groups of enabled mods to be organized separately. Instead of treating your entire mod library as one fixed configuration, you can maintain different setups and assign the appropriate collection where it is needed.
Our Penumbra setup guide covers the basic configuration and collection workflow in more detail.
What Do You Need Before Installing Penumbra?
Before installing Penumbra, you need a working Dalamud environment. Penumbra is installed as a Dalamud plugin rather than as a normal standalone Windows program.
If XIVLauncher and Dalamud are already working, installing Penumbra is relatively straightforward. If you are completely new to the process, start with our Install Penumbra guide and follow the steps in order.
What If Penumbra Is Not Working?
If Penumbra is installed but something is not working correctly, avoid reinstalling everything immediately. Common causes include the wrong collection being active, a mod being disabled, another mod overriding the same resource, an incorrect priority, or a temporary compatibility problem following a game or Dalamud update.
Visit our Penumbra troubleshooting section for problem-specific fixes covering missing mods, collections, conflicts, update problems, and visual issues.