INSTALL PENUMBRA

Install Penumbra for FFXIV

Download the latest stable files or follow the recommended Dalamud installation method below.

Latest Stable Open Source Repository Updates

Download Penumbra

Choose the main plugin package or download the source code if you need it for development.

Current stable version 1.6.1.12
DEVELOPERS

Source Code (ZIP)

Version 1.6.1.12

Complete Penumbra source-code archive.

Download .zip
DEVELOPERS

Source Code (TAR.GZ)

Version 1.6.1.12

Source-code archive in TAR.GZ format.

Download .tar.gz

Recommended for most players: install Penumbra through Dalamud's Custom Plugin Repository so plugin updates are easier to manage.

Make Sure Dalamud Is Ready

Penumbra works as a Dalamud plugin, so you need a working Dalamud environment before installing it.

Dalamud Available

Make sure Dalamud loads correctly when you start Final Fantasy XIV.

Required

FFXIV Ready

Start the game normally and confirm Dalamud is accessible before continuing.

Required

How to Install Penumbra

Follow these steps to add the Penumbra repository and install the plugin through Dalamud.

1

Open Dalamud Settings

Launch FFXIV with Dalamud enabled. Open the Dalamud menu and select Settings .

2

Open the Experimental Settings

In Dalamud Settings, open the Experimental section where Custom Plugin Repositories can be configured.

3

Add the Penumbra Repository

Copy the repository URL from the box below and add it to Dalamud's Custom Plugin Repositories list.

4

Install Penumbra

Open the Dalamud Plugin Installer, search for Penumbra , and install the plugin.

5

Verify the Installation

Confirm that Penumbra appears in your installed plugins and loads successfully before moving on to setup.

Penumbra Repository URL

Copy this URL and add it to Dalamud's Custom Plugin Repositories.

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

Continue to Setup

Configure Penumbra, collections, assignments and your first mod setup.

Go to Setup Guide
HAVING ISSUES?

Find the Right Fix

If Penumbra is not appearing or loading, open the troubleshooting guides.

View Troubleshooting