Skip to content

VPP Forge 1.22.0

Choose a tag to compare

@github-actions github-actions released this 27 Aug 22:02
· 45 commits to main since this release

The Red Faction VPP workbench, by Romek (RomekRF).

New in 1.22.0

Models in one VPP, textures in another. VPP Forge can now link other VPPs as read-only sources for previews, so a mesh finds its textures and a character finds its animations even when they live somewhere else entirely. Link them yourself from Tools › Link VPPs for previews, or let the viewer offer it: a model missing textures grows a Find missing textures… button that links the Red Faction install where the stock assets are. Linked files are browsable and can be copied into the open VPP, but never written to.

Open a single asset without a VPP. Double-click a .v3m, .v3c, .vfx, .vbm, .rfa, .mvf or .vf and it opens straight in its viewer, in a compact window with no file list in the way. Explorer names each type properly too — "Red Faction mesh", "Red Faction character", "Red Faction effect" and so on — so a folder of assets sorts by Type the way you would expect.

PNG and JPEG textures. Alpine Faction 1.4 adds them, and VPP Forge reads them: they preview like any other texture and stand in for a mesh's .tga exactly as DDS does. The new ATX format is named and read as text. A VPP holding any of the three says so in VPP checks, since older builds of the game cannot load them.

Resize images. From the preview panel, the right-click menu or Tools, on one image or a whole selection: by percentage or to an exact size, with the aspect linked, and rounding to a multiple of 4 or a power of two. Each file is rewritten in the format it already had, so meshes and levels keep finding it — TGA keeps its bit depth, DDS keeps its DXT flavour and gets a fresh mipmap chain. When TGA → DDS turns a texture away for its dimensions, the message that turned it away now offers to snap it to a multiple of 4 on the spot.

Extracting knows where things go. Give each file type its own folder under Tools › Export folders and extracting sends meshes, textures, animations and levels straight to their own place with no prompt. Right-click adds Extract mesh and textures and Extract only the textures, wherever those textures happen to live.

A character only lists its own animations. RFA files store no bone names, so the animation list used to show every animation in the VPP. It now matches on rig size, which cuts a list of a thousand down to the handful that belong to the character on screen.

Clicking a texture no longer loses the model. Texture names above the 3D viewer open in a lightbox over the model instead of navigating away, so several can be checked in turn and Esc lands back on the mesh.

Fixed: saving a large VPP could fail with "Array buffer allocation failed". The writer assembled the whole archive in one allocation, which needs roughly twice the file size in a single contiguous block. It now streams the parts, so VPPs of any size the format allows will save.

It is a 3D viewer

Click a file inside the VPP and it renders, with no need to open anything in the editor:

  • V3M static meshes with their textures. Orbit, zoom and pan, wireframe, LOD switching, and a PNG snapshot.
  • V3C characters as real skeletons that play their animations. Pick any RFA on the matching rig and watch it run, with Play/Pause, a scrubber and a time readout, or select an RFA directly to preview it on a matching character.
  • VFX effects with their textures, playing morph, per-frame and keyframed transforms, and UV animation.
  • VBM animated textures playing on the models that use them.
  • Model dimensions in RF units (metres), and the list of textures a mesh references with one click to select the mesh and everything it needs.

Alongside the TGA, DDS, PNG, JPEG, PCX, VBM and VF font viewers, the table editor and RFL level info, most Red Faction assets can be inspected without another tool.

Textures and animations no longer have to be in the same VPP. Link the ones that hold them, or let the viewer link the game for you, and previews resolve across all of them. The open VPP always wins, the way the game overrides stock files.

Updating itself

VPP Forge checks for new releases in the background and tells you when one is out, with a note on the Help menu. Help › Check for updates downloads the new version, installs it and restarts, with no reinstall. You are warned to save your work first, and an open VPP with unsaved changes asks a second time.

If you are on 1.19.0 or earlier, this is the last version you need to download by hand.

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.

Editing and building

Byte-exact VPP v1 writer verified against the retail files. Separate Save (in place, Ctrl S) and Save As. Autosave writes opened VPPs to disk, and the first overwrite of a session leaves a .vpp.bak.

Editing. Undo/redo, duplicate, copy names, drag-select, select-all per type, full keyboard navigation, filtering, reordering, rename in place, extract to a folder of your choosing.

Textures. One-click "Replace all TGA with DDS" with automatic DXT1/DXT5 by alpha, a progress bar, and refusal of sizes the game's D3D11 renderer rejects. Resize any image in place. VPP checks flag existing DDS files with dimensions that are not multiples of 4, which crash the renderer on map load.

Interface. Classic toolbar and File/Action/Tools/Help menus, swappable panel sides, light and dark themes, recent files.

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  D5F2044443A47B5E552C33B896777FD4215D10A0BBB5FF3DFB6F2BA27D7A27FD
VPPForge-Browser.html       164B3183EA6793E9CCA99A7FCA8F8CD6E13DBA6BB0D23809732BE9C6F0DC2322
vppforge.exe                7D707510D6E8C82A4D860AA7AEFBB99AB2F50BCF374D915F90F9E413E99C9876