Substance Painter to XIV

Version: 1.0.0

  Other by Atsu


Contributor Information:

- TexTools (https://www.ffxiv-textools.net/).
- TexConv (https://github.com/microsoft/DirectXTex).
- Aleks for PenumbraClient class in his Yet Another Addon (https://github.com/Arrenval/Yet-Another-Addon) project.
- Ottermandias for Penumbra (https://github.com/xivdev/Penumbra).
- The Dalamud (https://github.com/goatcorp/Dalamud) team for making all this possible.
- SB! for Substance Painter Export + Colorsetting Resources (https://xivmodarchive.com/modid/111473), color row and color blend material setup.
- This plugin draws inspiration from Substance-Painter-DDS-Exporter (https://github.com/emomilol1213/Substance-Painter-DDS-Exporter) by emomilol1213, as well as the sample plugins from the Substance Painter Python API docs.

Author's Comments:

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/111473

Beyond 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.

Primary File or Link:

Substance to XIV (Github) : [ via github.com ]

Other Files and Links:



History:

loading spinner Loading Mod History...

πŸ‘€ 5.0K
πŸ’Ύ --
πŸ“Œ 19

Last Version Update :
Tue Feb 10 2026 20:32:17 GMT+0000 (Coordinated Universal Time)
Original Release Date :
Tue Feb 10 2026 09:11:05 GMT+0000 (Coordinated Universal Time)

Contributors :
SB!
Aleks

Races :
Unknown
Genders :
Unisex

Similar Mods

Loose Texture Compiler (All In ...

By: Sebby

Type: Other
Genders: Unisex
  127.6K (99)    --    532

Infinity Nikki Rip Resource

By: Crow

Type: Other
Genders: Unisex
  52.8K (43)    --    131

Love and Deepspace Rip Resource

By: Crow

Type: Other
Genders: Unisex
  35.8K (31)    --    77