How To Export Your Equipped Gearswap Sets In Final Fantasy XI

Quickly export your currently equipped gear in Final Fantasy XI directly into a clean, syntax-perfect Lua format by executing the double-slash gs export command in your game window. This process instantly generates a structured text file containing all sixteen active equipment slots, saving it directly to your Windower addons directory for easy copy-pasting into your custom job scripts.

To optimize your performance in Final Fantasy XI, utilizing the Windower addon Gearswap is essential. Rather than manually typing out complex item names, managing spaces, and dealing with specialized punctuation for all sixteen equipment slots, you can automate this workflow. Manually writing Lua tables is not only time-consuming but also highly prone to spelling errors that can completely halt your script execution during critical endgame encounters.

Prerequisites for FXI Gear Optimization and Scripting

Before executing any automated export commands, you must establish a stable environment that allows Windower to communicate correctly with your Final Fantasy XI client and local storage drives. If your file permissions are locked down or if your addon resources are outdated, the export process will fail to write the necessary files or misidentify your equipped gear.

Ensure you meet the following baseline requirements before proceeding:

• Platform and Client: A fully updated PC installation of Final Fantasy XI running alongside the Windower 4 or Windower 5 launch platform.
• Active Addons: The Gearswap addon must be installed, enabled, and loaded in your Windower console.
• Directory Access Permissions: Windows administrator write-access permissions to your active Windower directory to allow the creation of new files inside the subfolders.
• Current Resource Files: Updated Windower resources to ensure newly released or recently augmented items are recognized by the system parser.
• Required Time: Less than five minutes of configuration and execution time.
• Financial Cost: Entirely free, utilizing open-source community utilities.

Detailed Walkthrough for Saving and Integrating Your Equipped Gear

Follow these systematic steps to dress your character, execute the export sequence, locate the newly generated files on your hard drive, and integrate those gear arrays cleanly into your active job files.

Step 1: Equipping Your Target Gear Set In-Game

Your first action is to physically place your character in the exact gear set you wish to capture. This step ensures that the memory addresses read by the Windower client match the precise items you intend to script.

1. Log into your Final Fantasy XI character and switch to the job associated with the gear set you are building.
2. Open your main game menu, navigate to Equipment, and manually equip every single slot you want to include in this specific set. This includes your main weapon, sub-weapon, ranged weapon, ammo, head, neck, left ear, right ear, body, hands, left ring, right ring, back, waist, legs, and feet.
3. If you are exporting an incomplete set, such as a utility set that only swaps out your rings and cape, equip only those items and leave the remaining slots completely empty. Gearswap will only export slots that contain an active item.
4. Verify that all items are fully loaded from your Wardrobes. If an item is still loading or flagged with a red circle because it is stored in a closed inventory bag, the export process will skip that specific slot.

Warning: Never attempt to export your gear immediately after zone transitions or upon initial login. Wait at least ten seconds for the client to fully synchronize your inventory wardrobes with your local system memory, or the export tool may write empty values for several slots.

Step 2: Executing the Gearswap Export Tool

Once your character is wearing the correct gear, you will run the export command. This can be done through the standard chat bar or directly within the Windower console interface.

1. Press Space or Enter to open your in-game chat prompt.
2. Type the following exact command: //gs export and then press Enter.
3. If you prefer using the Windower console, press the tilde key to drop down the console command line, type: gearswap export and press Enter.
4. Watch your system chat log for a confirmation message. Gearswap will output a line of text indicating that the export was successful, displaying the exact name of the newly created file.
5. If you require a different file format, such as the legacy XML format used by older tools like Spellcast, you can customize your output by typing: //gs export xml instead.

Pro-Tip: If you are exporting a set that relies heavily on specific weapon configurations, you can run: //gs export main sub to restrict the export to only your active hands, preventing unnecessary armor data from cluttering your configuration files.

Step 3: Finding Your Exported Lua Files on Your Computer

Now that the system has processed your equipment, you must navigate through your local file directory to retrieve the text document containing your formatted Lua table.

1. Minimize your game client and open your Windows File Explorer.
2. Navigate to the main directory where your Windower program is installed. The default path is typically found under C:/Program Files (x86)/Windower4/.
3. Open the addons folder, locate the folder named GearSwap, and double-click to enter it.
4. Inside the GearSwap directory, open the data folder, and then open the export folder.
5. Look for a file named after your character, appended with the current date and a timestamp. It will look similar to this: CharacterName_2026_03_30_142205.lua.
6. Right-click this newly created file and open it using a clean text editor such as Notepad++, Visual Studio Code, or standard Windows Notepad.

Step 4: Formatting and Pasting the Set Into Your Job Lua Script

The final step is to transition the raw data from your export file into your primary job script so Gearswap can actively use it during gameplay.

1. Open your export file and examine the structured text. You will see a clean list of items enclosed in curly braces, formatted to match Lua syntax.
2. Select the entire array of gear, starting from the opening curly brace down to the closing curly brace, and copy it to your clipboard.
3. Open your main job script file, which is located in your Windower/addons/GearSwap/data/ directory, saved as YourJobName.lua or CharacterName_YourJobName.lua.
4. Scroll down to your set declaration function, which is usually defined under the heading function get_sets().
5. Locate the specific action or state where you want this gear to apply, such as sets.precast.WS for weaponskills, or sets.engaged for your standard melee fighting set.
6. Paste your copied gear table directly into the right side of the equals sign for that set definition, ensuring that all punctuation, commas, and braces remain intact to prevent syntax compilation errors.
7. Save your job script, return to your game client, and reload your settings by typing: //gs reload to apply your changes instantly.

Comparing Gearswap Export Formats and Arguments

The Gearswap export engine is highly flexible, supporting various sub-commands that change both the formatting and the scope of your output file. Choosing the correct argument depends entirely on how you organize your macro files or script frameworks.

Troubleshooting Common Export and Integration Issues

When managing file systems and in-game memory registers, you may occasionally run into errors where files do not appear or items are missing. Use these verified troubleshooting steps to resolve the most common export failures.

The Export Command Returns a Command Unknown Error

• Root Cause: The Windower client has not successfully initialized the Gearswap addon, or the addon has crashed in the background due to a memory leak or an unhandled script error.
• Actionable Fix: Open your Windower console and type: lua load gearswap to manually force-load the system. If it is already loaded but frozen, type: lua reload gearswap to reset the environment. Verify that Gearswap is checked and enabled on your Windower startup profile launcher.

Specific Equipped Items Are Missing From the Exported File

• Root Cause: The item in question is either a newly released piece of equipment not yet cataloged in the Windower resource files, or your local resource database has become corrupted.
• Actionable Fix: Close your game client completely and run the Windower launcher. Allow the updater to check for files and download the latest data packages. If the item still fails to export, check the spelling in-game and manually type the item name into your script file using standard Lua quotation formatting.

The Export Folder is Empty and No File is Generated

• Root Cause: Windows security policies or user account controls are preventing Windower from creating new subdirectories or writing new files to your system drive.
• Actionable Fix: Right-click your Windower application icon, select Properties, go to the Compatibility tab, and check the box to Run this program as an administrator. Alternatively, manually create a folder named export inside your Windower/addons/GearSwap/data/ directory to give the addon a target path to write to.

Your Game Freezes or Lag Spikes When You Run the Command

• Root Cause: You are carrying too many items across all eight of your Mog Wardrobes, causing the search algorithm to time out while querying your current inventory state.
• Actionable Fix: Clean out your active inventories, send inactive gear to your Mog Safe or Storage, and close any unused wardrobe bags from your in-game menu. Run the export command while standing in an uncrowded, low-lag zone such as your Mog House to minimize background network traffic.

Frequently Asked Questions

Can I export my gear sets while playing on a console or non-PC platform?

No, Gearswap is a third-party addon developed exclusively for the PC version of Final Fantasy XI running via the Windower environment. It is impossible to export gear sets or run Lua scripts on original console hardware or vanilla PC configurations that do not support third-party hook engines.

How do I handle augmented items when exporting my equipment?

When you run the export command, Gearswap automatically attempts to capture your item's unique identifier code, which includes its specific augment path. If you are using a modern script library, pasting the exported table will preserve those distinct augment stats so the system can tell the difference between two identical pieces of armor with different augment paths.

What is the difference between gs export and gs export sets?

The standard export command outputs your current equipment as a single flat list of items. Adding the sets argument tells the system to pre-format the code structure as nested tables, making it easier to directly copy and paste the entire block into complex multi-tiered scripting templates without needing to manually reformat the brackets.

Why do some item names in my exported file have strange characters?

Final Fantasy XI uses non-standard text characters for certain foreign names, accents, and special items. Gearswap automatically sanitizes these names into safe UTF-8 text strings during the export process to prevent your Lua scripts from crashing due to unexpected character encoding issues. Keep those unique strings exactly as they are exported.

Optimize Your FXI Setup Today

Now that you know how to instantly export your gear configurations, you can build flawless, high-performance setups for every job in your roster. Take advantage of this streamlined workflow to spend less time troubleshooting broken macros and more time conquering the hardest endgame battlefields Vana'diel has to offer.