How to Install Penumbra FFXIV Testing: Safe Setup, Backup, and Rollback Guide

A Penumbra testing build is an early version of the FFXIV mod loader that may include post-patch compatibility fixes, upcoming features, or changes still being tested. It can be useful when the stable version is unavailable after a game update, but it may also cause crashes, broken collections, or mod-loading issues.

This guide explains how to install Penumbra FFXIV testing safely, when to use a testing build, how to back up your configuration, how to return to stable, and how to avoid common installation mistakes.

Penumbra is third-party software and is not officially supported by Square Enix. Testing builds have additional risk. Use them only if you understand that they may be unstable, and follow current FFXIV rules and official guidance.

Quick Answer: How to Install Penumbra Testing

To install a Penumbra testing build safely:

1. Back up your Penumbra configuration and important mods.
2. Open FFXIV through your normal Dalamud-enabled launcher.
3. Open the Dalamud Plugin Installer with:

/xlplugins

4. Search for Penumbra.
5. Check whether the plugin page offers an official testing-build option.
6. Install the testing version only from the official Penumbra repository or verified project channel.
7. Restart FFXIV fully.
8. Test Penumbra with a small, simple collection before enabling all mods.

Do not install random DLL files, unofficial “instant patch fixes,” or unknown custom repositories.

What Is a Penumbra Testing Build?

A Penumbra ffxiv testing build is a pre-stable version of the plugin. It is usually intended for users who can test new changes and report issues clearly.

Testing builds may include:

• Early game-patch compatibility.
• Bug fixes not yet in stable.
• Changes to mod import behavior.
• Collection-management improvements.
• File-redirection fixes.
• New Advanced Editing tools.
• Compatibility updates for related plugins.

Testing does not mean “early access” to a guaranteed finished release. It means the build may change, break, or require further fixes before becoming stable.

The Penumbra releases page includes both regular releases and versions labeled as testing builds.

Should You Install Penumbra Testing?

A testing build can be appropriate if:

• The stable build is unavailable after an FFXIV patch.
• The Penumbra team or support staff asks users to test a specific build.
• You understand basic troubleshooting.
• You have working backups.
• You can test with a small mod collection first.
• You are willing to report reproducible problems.

You should wait for stable if:

• You are new to Penumbra.
• Your mod collection is large or complex.
• You rely on many body, texture, gear, or appearance mods.
• You do not have backups.
• You do not want to troubleshoot crashes or conflicts.
• You only need normal cosmetic mod use.

A Penumbra community response specifically notes that testing is not the same as early access and recommends waiting for stable if you expect a fully working public release.

Before Installing Penumbra Testing

Back up your setup first. This is the most important step.

Save copies of:

• Penumbra collections.
• Mod configuration files.
• Your active mod folder.
• Custom texture edits.
• Personal .pmp exports.
• Screenshots of priority settings.
• Important body, face, tattoo, hair, and gear mod options.

A Penumbra community discussion notes that rolling backups are stored in the XIVLauncher Penumbra backup location on Windows.

Also create a separate backup folder outside your active mod directory. Do not rely on only one backup.

How to Install Standard Penumbra First

If Penumbra is not installed at all, install the official stable version first.

The official Penumbra project instructions describe this process:

1. Open Dalamud settings with:

/xlsettings

2. Go to the Experimental tab.
3. Add the official Penumbra repository URL.
4. Save the repository settings.
5. Open the plugin installer with:

/xlplugins

6. Search for Penumbra.
7. Install it from the available plugins list.

The official repository URL listed by the Penumbra project is:

https://raw.githubusercontent.com/xivdev/Penumbra/master/repo.json

After installing, open Penumbra and complete its initial setup, including selecting a mod directory.

How to Install a Penumbra Testing Version

The exact testing-build controls can change with Dalamud and Penumbra releases. Use only the testing option exposed through the verified Penumbra plugin listing or the project’s official support channels.

Step 1: Open the Dalamud Plugin Installer

In-game, run:

/xlplugins

Dalamud’s official FAQ identifies /xlplugins as the command for installing and enabling plugins after the game hook loads.

Step 2: Find Penumbra

Search for:

Penumbra

Open the plugin details page rather than installing a similarly named third-party plugin.

Step 3: Look for the Official Testing Option

If the current Penumbra listing provides a button or menu option such as:

Install Testing Version

or:

Use Testing Build

read the displayed warning before selecting it.

Only continue when:

• The listing is from the official Penumbra repository.
• The testing build is currently offered through the plugin interface.
• You have already backed up your configuration.
• You understand that it may be unstable.

Do not add a random “testing repo” URL from a YouTube comment, Discord screenshot, or re-upload site.

Step 4: Install and Restart Fully

After installation:

1. Close FFXIV completely.
2. Start the game again through your normal launcher.
3. Open Penumbra.
4. Confirm that the installed version is the expected testing build.
5. Verify that your mod directory is still configured.
6. Check that your active collection is intact.

A full game restart is safer than only relogging after a testing-build installation.

How to Check If You Installed the Testing Version

Open Penumbra and review its version information. Testing builds are often clearly marked in their version label or release information.

You can also check:

• The Dalamud plugin listing.
• Penumbra’s GitHub releases page.
• The current official Penumbra support announcement.
• The plugin changelog or release notes.

The Penumbra project’s release page lists both standard and testing release labels.

What to Test After Installing Penumbra Testing

Do not enable your entire mod library immediately.

Use a small test checklist first:

• Does Penumbra open without errors?
• Is your mod directory detected?
• Is your main collection assigned correctly?
• Can you enable and disable one simple mod?
• Does one gear mod appear?
• Does one face or eye mod appear?
• Does one body or tattoo mod appear?
• Can you switch zones without a crash?
• Does the game remain stable in normal gameplay and Gpose?

Penumbra can apply mod changes after a map change or after closing and reopening a relevant game window.

How to Test a Large Mod Collection Safely

If your normal setup includes many mods, test in stages.

Stage 1: Base Collection

Enable only core mods, such as:

• Your main body mod.
• One face or eye mod.
• One hair mod.
• One simple gear mod.

Stage 2: Texture and Tattoo Mods

Then test:

• Skin textures.
• Face textures.
• Tattoo mods.
• Makeup overlays.
• Eye texture variations.

Stage 3: Gear and Advanced Mods

Finally, enable:

• Large gear packs.
• Animation-related mods.
• Advanced texture replacements.
• Personal mod edits.
• Complex collections.

If something breaks, you will know which category caused the conflict.

How to Roll Back from Penumbra Testing to Stable

If the testing build crashes, breaks collections, or causes visual issues, return to the stable version.

General rollback process:

1. Close FFXIV.
2. Open the Dalamud Plugin Installer after restarting.
3. Open Penumbra’s plugin page.
4. Select the stable release option if available.
5. Remove the testing selection if the interface provides one.
6. Restart FFXIV fully.
7. Confirm that the stable version is running.
8. Restore your backup only if your configuration is damaged.

Do not delete your entire mod directory as the first response to a testing-build problem.

Common Penumbra Testing Installation Problems

Penumbra Does Not Appear in /xlplugins

Check that the official repository was added correctly in Dalamud settings.

Use:

/xlsettings

Then confirm that the official repository is enabled and saved before reopening /xlplugins.

Testing Version Is Not Available

Testing builds are not always publicly available. If the plugin installer does not offer one, wait for an official release or check the official Penumbra support channel.

Do not use an unknown file simply because it claims to be newer.

Penumbra Opens but Mods Do Not Work

Test with one simple mod. Then check:

• Your active collection.
• Mod enablement.
• Mod directory configuration.
• Game patch compatibility.
• Mod priority conflicts.
• Outdated body, face, gear, or texture mods.

A Penumbra update can be compatible even when some individual mods still need updates.

FFXIV Crashes After Installing Testing

Immediately disable the testing build or revert to stable. Then test with minimal mods enabled.

If you report the issue, provide:

• FFXIV version.
• Penumbra testing version.
• Dalamud version.
• Clear error text.
• Steps that trigger the crash.
• Whether the problem occurs with all mods disabled.

Never include private mod files, account information, cookies, tokens, or personal data in a public issue.

Why You Should Avoid Unofficial Penumbra Testing Downloads

Unverified files can create serious problems:

• Malware or credential theft.
• Broken mod configurations.
• Game crashes.
• Corrupted plugin settings.
• Incompatible collections.
• Hidden file changes.
• Loss of personal edits.

Use only project-maintained sources. The Penumbra project provides support through its GitHub and Discord channels.

Best Practices for Penumbra Testing Builds

Follow these practices to reduce risk:

• Install stable whenever possible.
• Use testing builds only when you have a clear reason.
• Back up before every major update.
• Test with a small collection first.
• Keep your mod directory organized.
• Do not update every related plugin at the same time unless required.
• Read release notes and known issues.
• Avoid changing mod priorities during initial testing.
• Keep a stable rollback option.
• Use only official repositories and support channels.
• Review Square Enix’s current mod-related guidance before using third-party tools.

FAQ: How to Install Penumbra FFXIV Testing

Conclusion

To install Penumbra FFXIV testing safely, first install Penumbra from its official repository, back up your configuration, then use the official testing option only when it is visibly available through the verified Dalamud plugin listing or project support channels.

Testing builds can help after large FFXIV patches, but they are not guaranteed to be stable. Start with a minimal collection, test carefully, avoid unofficial downloads, and keep a stable rollback plan ready.

latest post

• How to Force Show an Accessory in Penumbra FFXIV: Fix Hidden Earrings, Necklaces, Bracelets, and Rings
• What Is Mare Synchronos? FFXIV Mod Synchronization, Privacy, and Current Status
• How to Install Eye Mods in FFXIV Penumbra: Complete Beginner Guide
• How to Install Tattoo Mods in FFXIV Penumbra: Complete Beginner Guide
• How to Install a Body Mod in FFXIV Penumbra: Complete Beginner Guide