Dalamud FAQ
Table of Contents
Info
- How do I install/enable plugins?
- How do I enable plugin test builds?
- What is the command for <insert plugin here>?
- How can I access Dalamud if I play with a controller?
- How do I turn Dalamud Staging on or off?
- How do I reset dalamud/plugin window locations?
- How do I manually delete plugins?
- Why can’t I find a plugin?
Troubleshooting
- I get an error message when trying to install/update/disable a plugin
- Reshade and its variants don’t work or Dalamud UI fails
- How do I fix plugins that rely on Dalamud provided opcodes?
- All my plugins basically stopped working
Misc
- Do not expect XL/Dalamud/Plugin updates on patch day releases
- Remember the patches, no matter how small, can break plugins
Q: How do I install/enable plugins?
Not sure how to install plugins? Just type /xlplugins
in-game after you see that the in-game hook has loaded.
Q: How do I enable plugin test builds?
- Type
/xlsettings
in game. - Go to the
Experimental
tab. - Click the checkbox for
Get plugin testing builds
. - Click
Save
/Save and Close
.
- NOTE: Testing plugins will have bugs, issues, crashes, and may even change dramatically before final release.
For troubleshooting, please keep questions/comments/issues in the plugin-testing channel on our Discord server.
Q: What is the command for <insert plugin here>?
Plugins will list their command(s) from the plugin installer window (/xlplugins
). The command /xlhelp
will print all commands in your chat.
Q: How can I access Dalamud if I play with a controller?
You can toggle the controller mode with Left Bumper and clicking in Left Stick (L1 and L3) allowing you to navigate among the Dalamud UI.
In this mode you can also open and close the Plugin Installer with Right Stick (R3).
Q: How do I turn Dalamud Staging on or off?
In game (if you can still launch)
- Type
/xldev
in game. - Click on the Dalamud menu on the top of the screen.
- Select/unselect the settings as wanted.
- Relaunch the game.
Out of game (when you get crashes)
- Close the game.
- Go to
%AppData%\XIVLauncher\
and opendalamudConfig.json
in your text editor of choice. - Go to the line that says
"DalamudBetaKey":
. Change the value to"BETAKEYHERE"
to enable Dalamud Staging, andnull
(no quotes) to disable Dalamud Staging. - Save the file.
- Launch the game.
- This is for developers, not users. Plugin testers should only use it when specifically stated. You should expect to encounter issues and crash more often on staging builds. Use with caution.
- NOTE: After enabling Dalamud Staging, you may have to wait for Dalamud to be redownloaded.
- NOTE 2: You should replace the
BETAKEYHERE
entry with a real beta key. It requires the quotes. - NOTE 3: Make sure there are no quotes when setting
DalamudBetaKey
to null.
Q: How do I reset dalamud/plugin window locations?
- Close the game.
- Go to
%AppData%\XIVLauncher\
. - Delete
dalamudUI.ini
. - Start the game.
Q: How do I manually delete plugins?
- Close the game and XIVLauncher.
- Go to
%AppData%\XIVLauncher\installedPlugins
. - Remove the folder[s] for the plugin[s].
- Go to
%AppData%\XIVLauncher\devPlugins
. - Remove all manually installed plugins. (Check if they have a third party repo, or reinstall them later.)
- Start the game.
- NOTE: You may not have any manually installed plugins. That’s fine.
Q: Why can’t I find a plugin?
Plugins often have to be updated for new patches. Please be patient if it’s only been a few days or weeks - the plugin will often return. There are no estimates nor SLAs, and are subject to the developer’s time/interest/motivation. You can view this site to see which plugins are currently available.
Q: I get an error message when trying to install/update/disable a plugin
Please give us more information so we can help troubleshoot why this is happening to you.
- Which plugin is it?
- Did a previous version work, and do you know what version it was?
- Does deleting the plugin and trying a fresh install work?
- Can you please provide your dalamud.txt file?
Q: Reshade and its variants don’t work or Dalamud UI fails
- Go to
(your game installation folder)\game
. - Make sure the game is closed.
- If there is a file called
d3d11.dll
ordinput8.dll
, rename it todxgi.dll
. - Relaunch the game.
If this doesn’t help, please contact us in our Discord server.
Q: How do I fix plugins that rely on Dalamud provided opcodes?
Certain plugins and features (Universalis updates, PennyPincher, and more) require knowing about the FFXIV client’s current opcodes. These change every patch and can sometimes take more time to sort out before a Dalamud update for a new patch is ready.
If you need to refresh your opcode information after it was updated, please relaunch the game. Dalamud will check for updated definitions when it is launched.
Q: All my plugins basically stopped working
There can be a number of things causing this, and we’ll need to get more information from you!
If possible, please join our Discord server and ask in our support channels. We’ll probably need your output.log
and/or dalamud.log
file to investigate the cause.
It is also helpful to know if you have any additional addons/injectors/mods such as ReShade/GShade, RivaTuner/RTSS/MSI Afterburner, any on-screen-displays/overlays, or mods installed via TexTools, as these can also contribute to crashing or conflicts.
Do not expect XL/Dalamud/Plugin updates on patch day releases
Please remember that many of the developers have school/jobs/both and live across a variety of time zones. Things will be updated when they can be. The notion that “XL could be gone at any time” still exists.
Remember the patches, no matter how small, can break plugins
If you’re experiencing crashes once Dalamud is whitelisted for a patch, you will want to disable/delete plugins and wait for updates.
Plugins that rely on opcodes may take a little longer than ones ones that rely on hooks in some cases, but it ultimately depends on how much the FFXIV client changed.
Want to add a new FAQ entry? Please use the template below and PR to the main FAQ repo:
### Q: Basic Title
(FAQ content)
---
Then add it to the Table of Contents using - [Name / Title here](#anchor here)
.