Substance to XIV is a python plugin for Substance Painter that converts exported textures to XIV TEX format and copies them to a mod folder of your choosing. When the export is done, you have the option to force a Penumbra redraw automatically. It requires Windows and TexTools installed.
The goal is to make exporting textures directly to the game as fast as possible so you can test and tweak them more easily.
To use the plugin effectively you need to export _base _id, _m, _n textures from Substance Painter with all their channels configured properly. You can achieve this with the right channel setup in your texture set and export preset. If you need help with this, I would recommend this resource by
SB! which helps you set up your project and organize your color setting textures as well:
https://www.xivmodarchive.com/modid/111473Beyond that, using the plugin should (hopefully) be self explanatory, but you can hover your mouse over elements on the UI panel to see tool tips with more info on what each setting does, and the GitHub readme explains things in more detail if you need it.
If at any time the plugin isn't doing what you want it to, check the log in the Project tab, it should show info on what it's doing and when there are settings disabled, etc...
---
Installation:
You can download the plugin from GitHub, download is in the releases section.
Plugin is installed like any other python plugin by unpacking it to the Substance Painter plugins directory, you can find detailed instructions in the GitHub readme:
https://github.com/atsuwu/substance_to_xiv#how-to-installβ οΈTo avoid first launch errors, restart Substance Painter after installing.
---
License:
Substance to XIV, Substance Painter plugin that converts exported textures to XIV TEX format and copies them to a mod folder.
Copyright (C) 2026 Atsu.
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see
https://www.gnu.org/licenses/.
---
Final Fantasy XIV Β© SQUARE ENIX CO., LTD. All Rights Reserved.
This project is not affiliated with SQUARE ENIX CO., LTD. in any way.