Repository navigation
VPP Forge 1.22.2
The Red Faction VPP workbench, by Romek (RomekRF).
New in 1.22.2
Mipmaps for DDS, down to the level you choose. Build mipmaps is on the right-click menu and in the preview panel. Under Tools it works on the selected DDS and TGA files, or on every one in the VPP when none is selected. For a DDS you pick the smallest level to build down to, from 1 × 1 (the full chain) to 128 × 128, and VPP Forge remembers your choice. Alpine Faction and Dash Faction read the level count from the DDS header and render a chain that stops early, so stopping at 32 × 32 is a real option, not a broken file. A DXT texture keeps its full-size image byte for byte and gets its smaller levels in the same format, so there is no second round of compression loss. Chains are built the way the games read them. The rule you are most likely to meet is that a mipmapped DXT over 16 pixels on both sides needs sides that are multiples of 16. Resize can now round to a multiple of 16 to fix that. A DDS that is a frame of an ATX is left alone, because Alpine turns an ATX down unless all its frames match. A DDS with a DX10 header is left alone too, because neither game loads it.
Replace with DDS, for TGA and PNG, with mipmaps built in. Right-click a TGA or PNG, or use Tools to convert every one in the VPP. Opaque textures still become DXT1 and textures with alpha still become DXT5. Mipmaps are now built in by default, down to the same choice of smallest level. A TGA's own mip files go into the DDS where they still match it, so hand-tuned levels survive, and the separate mip files are then removed. PNG is read the way Alpine reads it, with no colour correction and with the colour under transparent pixels kept, so cut-outs come out without dark fringes. Some textures are left alone and listed with the reason: a frame of an ATX, or a texture with an ATX, DDS, PNG, JPEG or VBM of the same name ahead of it in this VPP. Converting those would change the art the game shows.
TGA mip files. On a TGA, Build mipmaps writes <name>-mip1.tga and <name>-mip2.tga beside it, named and sized exactly as the game looks for them: a hyphen, numbered from 1, the name cut at its first dot, and each level half the size of the one before at the same bit depth. RF already makes its own mipmaps for power-of-two TGAs, though stock RF and the RED editor only do it up to 256 per side. For a 24-bit TGA the game's own levels are correct, so these files are mainly for hand-tuning. For a 32-bit TGA they also fix the alpha along the edges of the two levels they hold, which the game gets wrong. Build mipmaps asks before it replaces a mip file that no longer looks like its texture. It never touches the low-detail skins that stock files name directly. If you run it on an edited stock texture with the game's VPPs linked, fresh mips go into your VPP, so the old art does not show at a distance. Deleting, renaming or resizing a texture never leaves stale mip files behind.
Textures are found in the order the game uses. The texture names above the viewer, the 3D preview and Extract mesh and textures used to disagree about which file a mesh gets. They now share one lookup that follows the game: Alpine's ATX first, then a DDS, PNG or JPEG of the same name, then stock RF's own rules for .tga and .vbm. A format higher in that order wins even when it is in a linked VPP, as it does in game. The texture name shows the file the game actually loads. An ATX shows its first frame on the model and is extracted with its frames and alpha mask. An ATX that Alpine cannot read, or that is missing a frame or its mask, is skipped.
Texture names over 31 characters are flagged. The game stores texture names in 32 bytes and copies them there without checking the length, so a longer name loads wrong or not at all. VPP checks now flag them.
Fixed: Tools › Link VPPs for previews did nothing. It now links the VPPs you choose. Linking the game again no longer adds second copies of VPPs that are already linked. A linked VPP with long file names now shows its whole file list.
Fixed: Resize changed formats it should have kept. A 32-bit TGA stays 32-bit even when its alpha is all opaque. DXT1, DXT3 and DXT5 stay what they were, and a DXT1 cut-out keeps its holes. An uncompressed DDS stays uncompressed, and a mipmapped DDS keeps its smallest level.
Other fixes. In the Resize and mipmap dialogs, Enter on a button presses that button, and shortcuts no longer act on the file list behind the dialog. While a mipmap, resize or conversion batch runs, shortcuts are ignored and autosave waits. If you drop files or open a VPP during the batch, you are asked to try again once it finishes. Undo after a save no longer leaves files that cannot be previewed or saved. Browsing a large VPP no longer keeps every decoded texture in memory. In the desktop app:
- Files stored past the 2 GB mark of a large linked VPP can now be read, and a VPP over 2 GB is no longer handed to the app with a wrong size.
- A browser connection that sends nothing can no longer hang the app.
- Extracting a file named CON, NUL or another Windows device name used to report success and write nothing. It is now refused.
- Saves and settings are flushed to disk before the new file replaces the old one.
Updating. If you are on 1.22.1, VPP Forge tells you this version is out. On 1.20.0 through 1.22.0 the notice is easy to miss, so use Help › Check for updates. On 1.19.0 or earlier, download it from this page.
Everything in 1.22.1 is included: a new release shows its update card the first time it turns up, instead of a toast that faded before most people saw it.
Two ways to run it
VPPForge-Desktop-Win64.zip — the desktop app. Unzip and run vppforge.exe. Installing is optional: the first launch offers to associate .vpp files and add a Start Menu entry, and declining just runs the app.
VPPForge-Browser.html — the whole app in a single file. Open it in Chrome or Edge. Nothing to install and nothing for antivirus to scan. You only lose what needs Windows itself: files open by drag-and-drop rather than double-click, saving downloads a new .vpp instead of writing back over the original, and linking other VPPs for previews needs the desktop app.
vppforge.exe is also published on its own. It is the same file that lives inside the zip, and it is what the in-app updater downloads.
Before you run it
SmartScreen or Defender may warn on first launch because the exe is not code-signed. Choose "More info", then "Run anyway". The browser build avoids this entirely.
SHA-256
VPPForge-Desktop-Win64.zip 6C717627A0A8F8E5F092E5E1826714F94A82499D85B3C1D98B0452FFF8C660C7
VPPForge-Browser.html C68E41A4F2F00BAD6A8C17E309B9551FD2B3A4C1661E2796F49196F888702649
vppforge.exe C8D10C40335AE6BB06577A18EB0DE982319A5A1D865E69DB6B570EE8FE1D9488