Get Started
PENUMBRA SETUP

Set Up Penumbra for FFXIV

Penumbra is installed — now get it ready to use. This guide walks you through the initial setup, from your mod directory to collections, assignments and mod settings.

Mod Directory Set your mod folder Collections Organize your mods Assignments Choose where mods apply Priorities Handle conflicts
QUICK SETUP PATH

Get Started in 4 Simple Steps

Follow this quick path to get Penumbra ready for your first mod.

1

Open Penumbra

Launch Penumbra from your Dalamud plugin menu.

2

Set Mod Directory

Choose or verify where your Penumbra mods are stored.

3

Select a Collection

Choose the collection you want to use for your mods.

4

Assign and Test

Assign your collection, enable a mod and verify it in game.

STEP 01

Set Your Mod Directory

The mod directory is the location Penumbra uses to store and manage imported mods. Make sure the selected folder is accessible and located somewhere you intend to keep.

Avoid repeatedly moving or renaming your Penumbra mod directory after your setup is working.

Continue to Collections
STEP 03

Assign Your Collection

After choosing a collection, make sure it is assigned where you expect it to be used. Assignments tell Penumbra which collection should apply in a particular context.

1

Choose the collection you want to use.

2

Set the appropriate assignment.

3

Confirm the expected mods are active.

Continue to Mod Settings
STEP 04

Enable and Configure a Mod

Once a mod is imported, enable it in the collection you are using. Some mods also include configurable options that let you choose different variants or features.

Enable the Mod

Make sure the mod is turned on for your active collection.

Review Mod Options

Choose any available options supplied by the mod.

Continue to Priorities
STEP 05

Mod Priority & Conflicts

When multiple enabled mods affect the same game files, Penumbra uses mod priority to determine which result takes precedence.

1 Higher-priority mod
2 Conflicting mod

You normally only need to adjust priority when two enabled mods modify the same files.

Open Troubleshooting
FINAL CHECK

First Setup Checklist

Before adding more mods, confirm that your basic Penumbra setup is working correctly.

  • Penumbra opens successfully.
  • Your mod directory is configured.
  • A collection is selected.
  • The collection is assigned.
  • At least one test mod is enabled.
  • The expected change is visible in game.
WHAT'S NEXT?

You're Ready to Add Mods

Once your basic setup is working, you can start installing and managing mods or troubleshoot anything that still does not behave as expected.

NEXT GUIDE

Install Your First Mod

Learn how to import, enable and manage mods.

Go to Mods Guide