Repository navigation
VPP Forge 1.22.3
The Red Faction VPP workbench, by Romek (RomekRF).
New in 1.22.3
Turning mipmaps off is now in plain sight when you convert to DDS. Replace with DDS has one Mipmaps list: None first, then Down to 1 × 1 through Down to 128 × 128. It replaces an easy-to-miss checkbox, and VPP Forge remembers None for next time.
Build mipmaps for every DDS from the tree. Hover over Textures · DDS in the tree, click its mipmap button and pick the smallest level. The button hides while you browse a linked VPP, and so now do the Replace with DDS buttons on the TGA and PNG rows, which used to show there and act on the VPP you have open.
Extract To. A new Extract To button sits beside Extract, with Ctrl Shift E and entries in the right-click and Action menus. It asks for one folder and puts everything there, whatever export folders you have set; Extract still sends each type to its own folder. The browser build uses the browser's folder picker where it has one (Chrome and Edge do).
A clearer select-all in the tree. Each type row's select-all button is now a ticked box rather than a bare tick, and hovering the row shows the words Select all.
Fixed: extracting from a linked VPP you were browsing did nothing. Extract offered its files, then looked for them only in the VPP you have open. Extract and Extract all now take the files on screen.
VPP checks flag DDS mip chains the game mishandles. In the maps and mods of one Red Faction install, 16 of 2,329 DDS files had exactly two levels and over a hundred had chains running past the short side. VPP checks now name such files:
- Exactly two levels on a texture over 16 pixels on both sides. Low texture detail skips the top two levels, leaving none, so the texture may show garbage or crash the game. Build mipmaps grows the chain to three or more levels, or cuts it to one if your smallest level or the file's format rules that out.
- Levels past where the short side reaches 1, which Direct3D 11 drops and the legacy renderer never fills, so the texture may show junk far away. Build mipmaps trims them off without recompressing.
- A mip count of zero, which declares no levels at all. Build mipmaps builds a chain, or sets the count to one where it cannot.
- A mipmapped DXT over 16 pixels on both sides whose sides are not multiples of 16. It fails at Low texture detail, and at Medium too when a side is not a multiple of 8. In Alpine that failure is fatal. Resize can round both sides to multiples of 16.
Build mipmaps now names the fix each of these files needs. VPP checks list any it cannot change, such as ATX frames, with the reason.
Title Case labels. The tree, the Type column and the preview panel now read All Files, Static Meshes, DDS Texture and so on.
Updating. If you are on 1.22.1 or 1.22.2, 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.2 is included: Build mipmaps for DDS and TGA, Replace with DDS for TGA and PNG, and textures found in the order the game uses.
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 B95C4304B9396D48AE235DF7CB9B27CC0869C2C91988DB4A720AB9C271C4C7C6
VPPForge-Browser.html 50C04905F2E40CD6710A1FA5A9BB35EF04503A34D688B9EA2D29D6B03AD19737
vppforge.exe 70268C175F8E81F1830D800D6A4C8D5E4436FC3B15784C89790B7EC19AD6F9AA