Game Studio / Tools / IFF conversion

SWG IFF Deconstructor

Convert DTII DataTable IFF files into editable .tab or DataTable XML, one file or one immediate folder at a time.

Version1.0.4
RequiresVS Code 1.80.0+
LicenseMIT
Package1.48 MB VSIX

Visual Studio Code extension

Install, use, and troubleshoot SWG IFF Deconstructor.

Use this guide to install version 1.0.4, learn its commands and settings, and follow the main workflows.

Installation

Recommended

Visual Studio Marketplace

  1. Open the extension's Marketplace page.
  2. Choose Install and allow Visual Studio Code to open.
  3. Confirm the publisher is Wasted Potential Studios LLC and the extension ID matches the value on this page.
  4. Reload Visual Studio Code if prompted.
Open Marketplace

Manual install

Manual VSIX

  1. Download the version 1.0.4 VSIX from WPS.
  2. In VS Code, run Extensions: Install from VSIX... from the Command Palette.
  3. Select wps-swg-iff-deconstructor-1.0.4.vsix.
  4. Reload Visual Studio Code if prompted.
Download VSIX
code --install-extension wps-swg-iff-deconstructor-1.0.4.vsix

SHA-25636E642DF87905F2B5F695AD12BCFE39D6721FCB404FA124025C93FE9817F9AE9

Convert a DataTable IFF

  1. Right-click a DTII DataTable .iff file.
  2. Choose SWG: Deconstruct IFF to TAB for tab-delimited source or SWG: Deconstruct IFF to XML for DataTable XML.
  3. Find the generated file beside the original .iff. If openOutputOnSuccess is enabled, VS Code opens it after a successful single-file conversion.
  4. Review column types and values before editing or recompiling the result.

Commands

CommandWhereWhat it does
SWG: Deconstruct IFF to TABswg-iff-deconstructor.deconstructToTAB .iff Explorer/editor context menus Writes a tab-delimited DataTable beside the selected IFF.
SWG: Deconstruct IFF to XMLswg-iff-deconstructor.deconstructToXML .iff Explorer/editor context menus Writes DataTable XML beside the selected IFF.
SWG: Deconstruct All IFF Files in Folderswg-iff-deconstructor.deconstructFolder Folder Explorer context menu Converts immediate .iff children using the configured default output format.
SWG: Configure IFF Deconstructor Settingsswg-iff-deconstructor.configureSettings Command Palette Opens the extension's VS Code Settings page.

Settings

Open VS Code Settings and search for the extension name or paste a setting key into the search box.

SettingType / defaultPurpose
swg-iff-deconstructor.defaultOutputFormat String: tab or xml
Default: tab
Chooses the format used by the folder command.
swg-iff-deconstructor.outputLocationNot used in 1.0.4 String: same or custom
Default: same
Output is written beside the input.
swg-iff-deconstructor.customOutputPathNot used in 1.0.4 String
Default: Empty
Output is written beside the input.
swg-iff-deconstructor.showNotifications Boolean
Default: true
Shows conversion progress, success, and failure messages.
swg-iff-deconstructor.openOutputOnSuccess Boolean
Default: true
Opens the generated document after a successful single-file conversion.

Supported IFF scope

The parser supports DataTable IFF versions 0000 and 0001 with the DTII, COLS, TYPE, and ROWS structure. It reconstructs either tab-delimited text or DataTable XML.

SupportedNot supported
DTII DataTable IFFMesh (.msh) data
DataTable versions 0000 and 0001Shaders, appearances, skeletons, or animations
Single-file and immediate-folder conversionGeneric decompilation of every SWG IFF form

TAB and XML output examples

TAB output writes column names, type codes, and values as tab-separated rows. XML output writes named column definitions and named cells so the result can be compiled again by a compatible DataTable workflow.

TAB
template_name	level
s	i
object/example.iff	12

XML
<datatable>
  <column name="template_name" type="s" />
  <column name="level" type="i" />
  <row>
    <cell name="template_name">object/example.iff</cell>
    <cell name="level">12</cell>
  </row>
</datatable>

Output and batch behavior

  • Direct commands choose .tab or .xml explicitly.
  • The folder command uses defaultOutputFormat and processes .iff files directly inside the selected folder.
  • Folder conversion is not recursive.
  • Version 1.0.4 writes output beside the source.

Troubleshooting

  • A Not a DataTable IFF error means the file is not a supported DTII DataTable structure.
  • If output is missing, confirm the source is readable, the source folder is writable, and the IFF is not truncated.
  • Use SWG IFF Viewer first when you are unsure of the file's form type.
  • Very large files can take longer to parse, and custom or unknown DataTable type encodings may not round-trip as expected.

Privacy & license

This extension does not send extension data or telemetry to WPS.

SWG IFF Deconstructor version 1.0.4 is distributed under the MIT License. Keep backups when converting or generating files.

Get one tool or the complete suite

Use Marketplace for updates, download version 1.0.4 as a VSIX, or get the bundle with all six tools.