RF:G Editing Main Page

	This page is part of the Red Faction: Guerrilla Editing Knowledgebase
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
Nexus Mods Re-Mars-tered - Custom mods

Documentation

RF:G Map organization
Nanoforge basics
Zone file format docs - Describes the zone format used by RFG in more detail

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

\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 for singleplayer activities
anims.vpp_pc - contains animation files
chunks.vpp_pc - unknown use however contains .rfgchunkx files and seems to be related to the preload_chunks.xtbl file
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 - only contains a blank asm_pc file
dlc01_precache.vpp_pc - similar to mp_common.vpp_pc but for the singleplayer DLC map
dlcp01_activities.vpp_pc - contains textures for 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 & thumbnails in singleplayer DLC
dlcp01_items.vpp_pc - contains textures and meshes for weapons, character props and misc objects in singleplayer DLC
dlc01_misc.vpp_pc - contains .rig_pc files, the .fsmib file and two .xtbl files for 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 singleplayer DLC vehicles
dlcp01_voices_en_us.vpp_pc -
dlcp02_interface.vpp_pc - contains textures for loading screens & thumbnails for multiplayer DLC
dlcp02_misc.vpp_pc -
dlcp03_interface.vpp_pc - contains textures for loading screens & thumbnails for wrecking crew DLC
dlcp03_misc.vpp_pc -
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 in both singleplayer and multiplayer
interface.vpp_pc - contains textures for loading screens & thumbnails in both SP and MP and character portraits in multiplayer
items.vpp_pc - contains textures and meshes for weapons, character props and misc objects in both singleplayer & multiplayer
items_mp.vpp_pc - contains multiplayer only textures and meshes
misc.vpp_pc contains .xtbl files and most other file types
missions.vpp_pc - contains textures for singleplayer missions
mp_common.vpp_pc - contains textures shared between multiplayer maps
mp_xxx.vpp_pc - multiplayer maps, excluding mp_common.vpp_pc
mpdlc_xxx.vpp_pc - DLC multiplayer maps
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 for the skybox like the clouds
sounds_r.vpp_pc - contains .xmb_pc sound files
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 - singleplayer map
terr01_precache.vpp_pc - similar to mp_common.vpp_pc but for the singleplayer map
vehicles_r.vpp_pc - contains textures and meshes for singleplayer 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 singleplayer DLC map
zonescript_terr01.vpp_pc - contains .scriptx and .rfgzone_pc files for singleplayer map
xxx.bik - pre-rendered custscenes

Scriptx Functions

.scriptx functions

Primitive data types & limits

Floats (floating decimal points): Max value 3.4028237 and move the decimal place right 38 times. Examples: 1.0, 0.0
Integer (whole number that could hold a zero, positive or negative value): Max value 2147483647
Boolean (truth value with two constants objects True and False , basically a toggle to enable or disable something using "true" or "false"): Examples: <Unlocks_Cheat>True</Unlocks_Cheat>, <Unlocks_Cheat>False</Unlocks_Cheat>
String (represents a sequence or characters/text): Example: <string>OldCoot</string>

sounds_r.vpp_pc Info

S16 = Signed 16 bit
LE = Little endian
2CH = 2 channels (stereo)

   * destruction.xwb_pc - unknown
   * dlc01_voc_d01offcam.xwb_pc.en_us.xwb_pc - unknown               
   * dlc01_voc_spe_d01dan.xwb_pc.en_us.xwb_pc - unknown              
   * dlc01_voc_spe_d01msm01.xwb_pc.en_us.xwb_pc - unknown            
   * dlc01_voc_spe_d01msm02.xwb_pc.en_us.xwb_pc - unknown            
   * dlc01_voc_spe_d01msm03.xwb_pc.en_us.xwb_pc - unknown            
   * dlc01_voc_spe_d01msm04.xwb_pc.en_us.xwb_pc - unknown            
   * dlc01_voc_spe_d01msm05.xwb_pc.en_us.xwb_pc - unknown            
   * dlc01_voc_spe_d01msm06.xwb_pc.en_us.xwb_pc - unknown            
   * dlc01_voc_spe_d01rfc.xwb_pc.en_us.xwb_pc - unknown              
   * dlc01_voc_spe_d01sam_pcm01.xwb_pc.en_us.xwb_pc - unknown        
   * dlc01_voc_spe_d01vasha_safe.xwb_pc.en_us.xwb_pc - unknown       
   * mov_foley.xwb_pc - unknown                                       
   * mov_jet_pack.xwb_pc - unknown                                    
   * mov_male.xwb_pc - unknown                                        
   * mov_npc_male.xwb_pc - unknown                                    
   * mp_backpacks.xwb_pc - S16, LE, 2CH. Intermittent static starting ~28sec                  
   * mp_wep.xwb_pc - S16, LE, 2CH. Static at start and end                                           
   * mus_briefings.xwb_pc - S16, LE, 2CH.      
   * mus_demomaster.xwb_pc - S16, LE, 2CH.      
   * mus_frontend.xwb_pc - S16, LE, 2CH.        
   * mus_multiplayer.xwb_pc - S16, LE, 2CH.     
   * mus_progression_01.xwb_pc - S16, LE, 2CH. Static at start, may be header 
   * mus_progression_02.xwb_pc - S16, LE, 2CH.  
   * mus_progression_03.xwb_pc - S16, LE, 2CH.  
   * mus_sting.xwb_pc - S16, LE, 2CH. 
   * obj_shared_ambient.xwb_pc - unknown
   * obj_shared_dth.xwb_pc - unknown     
   * obj_shared_exp.xwb_pc - unknown
   * obj_shared_impact.xwb_pc - unknown 
   * scripted_raids.xwb_pc - unknown    
   * system.xwb_pc - S16, LE, 2CH. Mostly static, valid sound in middle            
   * system_mp.xwb_pc - unknown         
   * veh_civ_bus.xwb_pc - S16, LE, 2CH. Some static, some valid sound.       
   * veh_civ_car1.xwb_pc - S16, LE, 2CH. Some static, some valid sound.          
   * veh_civ_car2.xwb_pc - S16, LE, 2CH. Some static, some valid sound.          
   * veh_civ_car3.xwb_pc - S16, LE, 2CH. Some static, some valid sound.        
   * veh_civ_flat.xwb_pc - unknown    
   * veh_civ_flat2.xwb_pc - unknown
   * veh_civ_fuel.xwb_pc - S16, LE, 2CH. Some static, some valid sound.        
   * veh_civ_hauler.xwb_pc - S16, LE, 2CH. Some static, some valid sound.      
   * veh_civ_taxi.xwb_pc - S16, LE, 2CH. Some static, some valid sound.        
   * veh_civ_trash.xwb_pc - S16, LE, 2CH. Some static, some valid sound.       
   * veh_civ_walker.xwb_pc - S16, LE, 2CH. Some static, some valid sound.      
   * veh_edf_aax.xwb_pc - S16, LE, 2CH. Mostly static, some valid sound at end.        
   * veh_edf_abx.xwb_pc - S16, LE, 2CH. Mostly static, some valid sound at end.                 
   * veh_edf_apc.xwb_pc - S16, LE, 2CH. Some static, some valid sound.       
   * veh_edf_atank.xwb_pc - S16, LE, 2CH. Some static, some valid sound.     
   * veh_edf_htank.xwb_pc - S16, LE, 2CH. Some static, some valid sound.     
   * veh_edf_mtank.xwb_pc - S16, LE, 2CH. Some static, some valid sound.     
   * veh_edf_scout.xwb_pc - S16, LE, 2CH. Some static, some valid sound.     
   * veh_edf_staff.xwb_pc - S16, LE, 2CH. Some static, some valid sound.     
   * veh_edf_staffh2h.xwb_pc - S16, LE, 2CH. Some static, some valid sound.  
   * veh_edf_supply.xwb_pc - S16, LE, 2CH. Some static, some valid sound.    
   * veh_mar_jetter.xwb_pc - S16, LE, 2CH. Some static, some valid sound.  
   * veh_mar_raider.xwb_pc - S16, LE, 2CH. Some static, some valid sound.  
   * veh_min_atv.xwb_pc - S16, LE, 2CH. Some static, some valid sound.  
   * veh_min_bull.xwb_pc - S16, LE, 2CH. Some static, some valid sound.  
   * veh_min_dtruck.xwb_pc - S16, LE, 2CH. Some static, some valid sound.  
   * veh_min_etruck.xwb_pc - S16, LE, 2CH. Some static, some valid sound.  
   * veh_min_jetter.xwb_pc - S16, LE, 2CH. Some static, some valid sound.  
   * veh_min_pickup.xwb_pc - S16, LE, 2CH. Some static, some valid sound.  
   * veh_min_rover.xwb_pc - S16, LE, 2CH. Some static, some valid sound.  
   * veh_min_roverwk.xwb_pc - S16, LE, 2CH. Some static, some valid sound.  
   * veh_min_supply.xwb_pc - S16, LE, 2CH. Some static, some valid sound.  
   * veh_min_supplyrt.xwb_pc - unknown
   * veh_min_wlklg.xwb_pc - S16, LE, 2CH. Some static, some valid sound.  
   * veh_min_wlkmd.xwb_pc - S16, LE, 2CH. Some static, some valid sound.  
   * veh_shared.xwb_pc - S16, LE, 2CH. Some static, some valid sound.  
   * walla.xwb_pc - unknown
   * weather.xwb_pc - S16, LE, 2CH.
   * wep_rfg.xwb_pc -  S16, LE, 2CH. Mostly valid, some static

RfgUtil Guide

Unpacking [Placeholder]
Repacking [Placeholder]
Command arguments [Placeholder]
Scripts [Placeholder]
Updating .asm_pc files [Placeholder]

Misc Notes

When repacking .vpp_pc files don't compress and/or condense them if they weren't like that in the vanilla game, it will cause the game to crash. Eg: items.vpp_pc, interface.vpp_pc, map files etc. See the table below:


Filename	Alignment	Compressed	Condensed
ALL .str2	0	Yes	Yes
MOST .vpp_pc	2048	No	No
dlc01_precache.vpp_pc	2048	Yes	No
dlcp01_misc.vpp_pc	2048	Yes	No
misc.vpp_pc	2048	Yes	No
mp_common.vpp_pc	2048	Yes	No
steam.vpp_pc	2048	Yes	No
terr01_precache.vpp_pc	2048	Yes	No
zonescript_dlc01.vpp_pc	2048	Yes	No
zonescript_terr01.vpp_pc	2048	Yes	No
dlc01_l1.vpp_pc	0	No	No
dlcp01_voices_en_us.vpp_pc	0	No	No
dlcp02_misc.vpp_pc	0	Yes	No
anims.vpp_pc	16	Yes	Yes
table.vpp_pc	64	Yes	Yes
skybox.vpp_pc	4096	No	No
dlcp01_personas_en_us.vpp_pc	4096	No	No

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 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
Notepad++ - Good text editor for manually editing .xtbl files, set language as XML

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.