Table of Contents
- Install and launch XIVLauncher
- Add repositories
- Install Penumbra and Heliosphere
- Set up Penumbra
- Install mods
This guide details the steps to take in order to get started with Heliosphere and installing mods. If you have previously completed any of the steps listed here, feel free to skip them. If you just want to get started, skip to the next section.
Heliosphere is a mod installer, or more accurately, a mod delivery platform. It takes care of letting you browse and search for mods, then makes installing them a simple, one-click affair. Mods are installed directly into Penumbra, a runtime mod loader. Penumbra is a replacement for TexTools, but unlike TexTools, Penumbra is safe and doesn't modify your game install.
The platform that enables both Penumbra and Heliosphere to work is called Dalamud, which is a plugin framework for FINAL FANTASY XIV. Dalamud is automatically turned on when you launch the game from XIVLauncher (also called FFXIVQuickLauncher).
Naturally, for Heliosphere to work, both XIVLauncher and Penumbra must be installed first. This guide will take care of getting both of those set up for you, as well. Now, let's get started.
Install and launch XIVLauncher
XIVLauncher is necessary to load plugins (e.g. Heliosphere and Penumbra), so we'll install that first.
Download the installer
Click here to download the latest XIVLauncher installer
(or go their
latest release page
Setup.exe). Save it somewhere you can find it, then launch it.
Setup.exe, XIVLauncher will open and ask you where your
game is installed. Go through the setup steps, and make sure "Enable Dalamud" is
Sign in to your account and launch the game.
In order to install Penumbra and Heliosphere, you'll need to add their repositories to Dalamud.
Open Dalamud settings
Log in to a character first.
Press Esc and click on "Dalamud Settings" (or use the
Switch to the experimental tab
Click the Experimental tab at the top of the settings window.
Add Penumbra's repository
Under the third-party repositories section, paste the following URL in the empty text box.
Click the plus (+) button.
Add Heliosphere's repository
Next, paste the following URL in the next empty text box.
Click the plus (+) button.
Click "Save and Close".
Install Penumbra and Heliosphere
This is the last setup step: installing the plugins.
Open the plugin installer
Press Esc and click "Dalamud Plugins" (or use the
Click "All plugins" and either scroll down to or search for Penumbra. Click on Penumbra, then click Install.
Next, scroll up to or search for Heliosphere. Click on it, then click Install.
Set up Penumbra
/penumbra command and follow the tutorial.
You must set a mod directory or mods will not work.
If you still would like more help after the tutorial, you can read the unaffiliated
guide for more
Go back to the main Heliosphere page, find mods you like, and click
Install! Then finish setup in the game. Make sure to enable any downloaded mods in
Penumbra (use the