Game Studio / Tools / IFF inspection
SWG IFF Viewer
Inspect SWG IFF hierarchy, tags, offsets, sizes, previews, and enhanced DTII schema information without modifying the source file.
Visual Studio Code extension
Install, use, and troubleshoot SWG IFF Viewer.
Use this guide to install version 1.0.2, learn its commands and settings, and follow the main workflows.
Installation
Recommended
Visual Studio Marketplace
- Open the extension's Marketplace page.
- Choose Install and allow Visual Studio Code to open.
- Confirm the publisher is Wasted Potential Studios LLC and the extension ID matches the value on this page.
- Reload Visual Studio Code if prompted.
Manual install
Manual VSIX
- Download the version 1.0.2 VSIX from WPS.
- In VS Code, run Extensions: Install from VSIX... from the Command Palette.
- Select
wps-swg-iff-viewer-1.0.2.vsix. - Reload Visual Studio Code if prompted.
code --install-extension wps-swg-iff-viewer-1.0.2.vsix SHA-256F25A77320BA395F57704DC82C95D3AECC4DF15DA126E977C3565086EE80CE182
Inspect an IFF in VS Code
- Right-click an .iff file and choose SWG: View IFF File.
- Review the file type, byte size, version, form and chunk counts, and unique tags at the top of the panel.
- Expand the structure tree to inspect nested FORM/chunk tags, offsets, sizes, extracted strings, and data previews.
- For DTII files, review the column names, types, and row count. Use the optional CLI when you need row output in a terminal.
Note: The viewer is read-only and does not write to the selected IFF.
Commands
| Command | Where | What it does |
|---|---|---|
SWG: View IFF Fileswg-iff-viewer.viewIFF | .iff Explorer/editor context menus and Command Palette | Opens the selected IFF in the extension's read-only webview. |
Settings
Open VS Code Settings and search for the extension name or paste a setting key into the search box.
| Setting | Type / default | Purpose |
|---|---|---|
swg-iff-viewer.enableCli | Boolean Default: true | Enables the optional wps iff-viewer terminal command. |
swg-iff-viewer.cliMaxRows | Number: 1-200 Default: 20 | Limits the number of DTII DataTable rows printed by the terminal command. |
Viewer scope
Shows generic IFF structure, with detailed DataTable information for DTII files.
The graphical view reports DTII schema and counts; it does not render every DataTable row. The CLI can print DTII rows up to cliMaxRows.
Optional wps terminal command
With enableCli on, restart the terminal after installation before using the command.
- The command prints the nested IFF chunk tree.
- For DTII DataTables, it also prints rows up to the cliMaxRows setting.
- If the command is unavailable, the graphical VS Code command still works; reinstall the Marketplace package or VSIX and restart VS Code before trying the terminal again.
- Set enableCli to false when you do not want the terminal command enabled.
wps iff-viewer path/to/file.iff Troubleshooting
- Large files, especially above roughly 50 MB, can take several seconds to parse and render.
- Unknown proprietary chunks remain visible structurally but may have limited semantic previews.
- If the view fails, confirm the file has a valid IFF header and is not truncated.
- Use IFF Deconstructor only for supported DTII DataTables; the viewer recognizing a generic form does not mean that form can be converted to .tab or XML.
Privacy & license
This extension does not send extension data or telemetry to WPS.
SWG IFF Viewer version 1.0.2 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.2 as a VSIX, or get the bundle with all six tools.