RF:G Editing Main Page

This will serve as a landing page for all resources related to Red Faction: Guerrilla editing, including both the original Steam Edition and the Re-Mars-tered Edition.

External Links

Community

• Faction Files Community Discord - Active Red Faction series community Discord with #map-mod-development channel for community development discussion

Downloads

• FactionFiles.com - Custom mods, tools, patches, and reference material
• Nexus Mods - Custom mods

Documentation

• RF:G Map organization

Core Concepts

• Red Faction: Guerrilla's level editor is CLOE, which is not publicly available.

Red Faction: Guerrilla File Formats

• .xtbl - XML table files are used to store properties or attributes in Red Faction: Guerrilla. Overall, their function is similar to the .tbl files of Red Faction and Red Faction II.
• .scriptx - Internal script engine file, commonly used for missions and activities
• .dtodx - Weather/lighting file for maps that controls things like fog, tint, ambient colour, eye adaption, bloom, cloud color and speed
• .gtodx - Skybox file for maps that controls things like the sun texture, moon positions and if the horizon mountain texture is enabled
• .vpp_pc - Packfile
• .rigx - Rig
• .str2_pc - Texture Packfile
• .rfgzone_pc - Map zone
• .layer_pc - Map zone
• .cpeg_pc, cvbm_pc - Texture cpu file
• .gpeg_pc, gvbm_pc - Texture gpu file
• .asm_pc - Streaming index
• .csmesh_pc - Static mesh cpu file
• .gsmesh_pc - Static mesh gpu file
• .ccmesh_pc - Character mesh cpu file
• .gcmesh_pc - Character mesh gpu file
• .ccar_pc - Vehicle mesh cpu file
• .gcar_pc - Vehicle mesh gpu file
• .anim_pc - Animation
• .cchk_pc - Destructible object cpu file
• .gchk_pc - Destructible object gpu file
• .cefct_pc - Visual effect cpu file
• .gefct_pc - Visual effect gpu file
• .cfmesh_pc - Foliage mesh
• .cstch - Terrain clutter mesh cpu file
• .gstch - Terrain clutter mesh gpu file
• .cterrain_pc - Terrain zone cpu file
• .gterrain_pc - Terrain zone gpu file
• .ctmesh_pc - Terrain subzone cpu file
• .gtmesh_pc - Terrain subzone gpu file
• .fsmib - Fullscreen map data
• .fxo_kg - Shader
• .le_strings - Steam localization strings
• .rfglocatext - Localization strings
• .mat_pc - Render material
• .morph_pc - Animation Morph
• .vint_doc - UI
• .sim_pc - Cloth sim
• .xgs_pc - Sound config
• .xsb_pc - Soundbank
• .xwb_pc - Wavebank
• .aud_pc - Audio categories
• .vf3_pc - Font
• .vfdvp_pc - ?
• .rfgvp_pc - ?

Red Faction: Guerrilla File Structure

X:\SteamLibrary\steamapps\common\Red Faction Guerrilla Re-MARS-tered\data\

The two most important files for modding most of RF:G are misc.vpp_pc & table.vpp_pc

• activities.vpp_pc contains textures related to singleplayer activities
• anims.vpp_pc contains animation files
• chunks.vpp_pc unknown use however contains .rfgchunkx files
• cloth_sim.vpp_pc contains cloth simulation files
• decals.vpp_pc contains decal textures
• dlc01_l0.vpp_pc singleplayer DLC map
• dlc01_l1.vpp_pc unknown
• dlc01_precache.vpp_pc similar to mp_common.vpp_pc but for the singleplayer DLC map
• dlcp01_activities.vpp_pc contains textures related to singleplayer DLC activities
• dlcp01_anims.vpp_pc contains animation files for singleplayer DLC
• dlcp01_cloth_sim.vpp_pc contains cloth simulation files for singleplayer DLC
• dlcp01_effects.vpp_pc contains visual effect files for singleplayer DLC, some are .str2
• dlcp01_humans.vpp_pc contains textures and meshes for characters in singleplayer DLC
• dlcp01_interface.vpp_pc contains textures for loading screens in singleplayer DLC
• dlcp01_items.vpp_pc contains textures and meshes for weapons and misc objects found in singleplayer that npcs sometimes use in singleplayer DLC
• dlc01_misc.vpp_pc contains .rig_pc files, the .fsmib file and two .xtbl files related to the singleplayer DLC
• dlc01_missions.vpp_pc contains textures related to singleplayer DLC missions
• dlcp01_personas_en_us.vpp_pc
• dlcp01_vehicles.vpp_pc contains textures and meshes for DLC vehicles
• dlcp01_voices_en_us.vpp_pc
• dlcp02_interface.vpp_pc contains textures for loading screens for multiplayer DLC
• dlcp02_misc.vpp_pc unknown
• dlcp03_interface.vpp_pc contains textures for loading screens for wrecking crew DLC
• dlcp03_misc.vpp_pc unknown
• effects.vpp_pc contains visual effect files, some are .str2
• effects_mp.vpp_pc contains multiplayer only visual effect files, some are .str2
• humans.vpp_pc contains textures and meshes for characters
• interface.vpp_pc contains textures for loading screens in both SP and MP and character portraits in multiplayer
• items.vpp_pc contains textures and meshes for weapons and misc objects found in singleplayer that npcs sometimes use
• items_mp.vpp_pc contains multiplayer only textures and meshes; ctf flags for example
• misc.vpp_pc contains .xtbl files and various other file types.
• missions.vpp_pc contains textures related to singleplayer missions
• mp_common.vpp_pc contains textures shared in multiplayer maps
• mp_xxx.vpp_pc multiplayer maps, excluding mp_common.vpp_pc
• personas_de_de.vpp_pc
• personas_en_us.vpp_pc
• personas_es_es.vpp_pc
• personas_fr_fr.vpp_pc
• personas_it_it.vpp_pc
• personas_ru_ru.vpp_pc
• rfg_cine_00a.bik_xbox2
• rfg_cine_01a.bik_xbox2
• rfg_cine_02a.bik_xbox2
• rfg_cine_03a.bik_xbox2
• rfg_cine_03b.bik_xbox2
• rfg_cine_04a.bik_xbox2
• rfg_cine_05a.bik_xbox2
• rfg_cine_06a.bik_xbox2
• skybox.vpp_pc contains textures related to the skybox like the clouds
• sounds.vpp_pc
• steam.vpp_pc
• table.vpp_pc contains only .xtbl files and will overwrite .xtbl files in misc.vpp_pc
• terr01_l0.vpp_pc singleplayer map
• terr01_l1.vpp_pc unknown
• terr01_precache.vpp_pc similar to mp_common.vpp_pc but for the singleplayer map
• vehicles_r.vpp_pc contains textures and meshes for vehicles
• voices_de_de.vpp_pc
• voices_en_us.vpp_pc
• voices_es_es.vpp_pc
• voices_fr_fr.vpp_pc
• voices_it_it.vpp_pc
• voices_ru_ru.vpp_pc
• wcxxx.vpp_c wrecking crew maps
• zonescript_dlc01.vpp_pc contains .scriptx and .rfgzone_pc files for the singleplayer DLC map
• zonescript_terr01.vpp_pc contains .scriptx and .rfgzone_pc files for the singleplayer map
• xxx.bik pre-rendered custscenes

Red Faction: Guerrilla Tools

• RfgUtil - Used for unpacking most file formats and updating asm_pc files
• Nanoforge C++ - Map editor, texture editor, .xtbl editor and more
• mTools - Drag and drop tool to convert .asm_pc files to XML and vice versa
• RSL - Script Loader
• AsmTool- WIP Tool for modifying asm_pc files used by Red Faction Guerrilla. This is meant to replace hand editing them, which is very error prone and tedious
• SyncFaction - WIP tool for automatically installing the Terraform Patch and eventually replacing the old mod manager
• xdelta UI - GUI for generating .xdelta (binary) patches
• XML Validator - Use this to validate .xtbl edits, any mistakes you make will crash the game
• XML Formatter - Use this to format .xtbl files so they are easier to read
• Mod Manager Re-mars-tered v1.03 - Legacy mod manager
• Volition Table File Editor - GUI for editing .xtbl files
• LUA Validator - Useful for validating RSL scripts for errors, note it's safe to ignore lua5.3: Main.lua:252: attempt to index a nil value (global 'rfg')

Useful Software

• Voidtools Everything - Locate files and folders by name instantly
• Agent Ransack - Bulk search for keywords within unpacked files

Scriptx Functions

• .scriptx functions

Tutorials

• Nanoforge basics - Introduction to Nanoforge and its features.
• Nanoforge xtbl editing - How to edit .xtbl files in Nanoforge.
• Nanoforge Texture Editing - How to edit textures using Nanoforge.