# Porting VFX Mods to Another Gear Piece (Preserving All Options) ## Overview >This guide covers the recommended workflow for porting VFX mods from one gear piece to another in FFXIV while **preserving all options within a mod**. This process is especially useful when you have multiple options and need to port them all efficiently. Previously, this required tedious manual search-and-replace for VFX paths and IMC changes, but now you can do this easily with the **FFXIV VFX Port Tool**. [You can also find a video guide here](https://youtu.be/Um3v51oMlYI) --- ## Prerequisites - **Penumbra**: Mod manager, with a mod installed that already has a gear piece with VFX modded. - **Glamourer**: For easily finding the Primary and Variant IDs for the target gear piece. - **FFXIV VFX Port Tool**: Available on [GitHub](https://github.com/ShinoMythmaker/FFXIV-VFX-Port). --- ## Step-by-Step Guide ### 1. Backup Your Mod in Penumbra - Open Penumbra and select the mod you want to port VFX from. - Go to: `Advanced Edits > Merge Mods`. - In the second section, enter a name for your new mod, e.g. `modName_port`. - Click **Select All Options**. - Hit the **Split off Options** button.  > **Result**: > A new mod is created with all your options preserved, ready for VFX porting. --- ### 2. Get Primary and Variant IDs of Target Gear - Open **Glamourer**. - Browse the gearpiece you want to port the VFX to. - In the item dropdown, you’ll see two numbers to the right of the item name: - **Primary ID** - **Variant ID** - **Write these down** for use in the next steps.  --- ### 3. Download & Install FFXIV VFX Port Tool - Head to: [ShinoMythmaker/FFXIV-VFX-Port](https://github.com/ShinoMythmaker/FFXIV-VFX-Port) - Download the **installer** (recommended) or the **portable** version. - If using the installer, follow the prompts. - If Windows warns you, click **More Info > Run Anyway** (the tool is open source and safe). - Install or extract the tool.  --- ### 4. Open Your Mod in FFXIV VFX Port - Launch the **FFXIV VFX Port Tool**. - Select your **Penumbra mod folder**. - Search for your **newly created mod** (`modName_port`). - Select it to see a list of all gearpieces in the mod that have VFX.  --- ### 5. Begin the VFX Port - Find the gearpiece whose VFX you want to port. - Click the **two blue arrows** to the right of it. > **A port section will open with several input fields.** --- ### 6. Fill the Port Fields - **Type**: Choose **Accessory** or **Equipment** as appropriate. - **Primary ID**: Enter the value you found in Glamourer. - **Variant ID**: Enter the corresponding Variant ID. - **Slot**: Select the correct slot (e.g. Ears for earrings, Head for hats, etc.). - **VFX ID**: *Recommended*: Leave this as-is unless you know what you're doing. (Changing it can override VFX for other gear.)  --- ### 7. Apply the Port - Click the **green Submit button**. - Wait for the popup message: - **Success**: Continue or close the tool. - **Failure**: Contact ShinoMythmaker for support. - You can repeat this process for additional gear pieces as needed. --- ### 8. Refresh Mod in Penumbra - Go back to Penumbra. - Open your mod’s editor: `Edit Mod > Reload Mod`. - **Redraw your character** in-game to see the changes in effect.  --- ## Notes & Recommendations - **Always back up your mods** before making changes! - The VFX Port Tool is open source. If unsure, review the code on GitHub for peace of mind. - For most users, **do NOT change the VFX ID** unless you specifically need to. - If you encounter issues or errors, contact ShinoMythmaker via GitHub. --- *Guide by ShinoMythmaker. If this was helpful, consider linking this page for future reference!*