IW3x-port is a community-driven project that enhances the IW4x multiplayer experience by making it possible to export and convert assets from Call of Duty: Modern Warfare (2007).
The built-in ZoneBuilder tool of IW4x can use models, materials, zones, and other content exported by IW3x-port to convert them into new assets for IW4x.
- Place the
iw3xport.exein yourIW3installation folder, next to theiw3mp.exeandiw3sp.exe. - Start
IW3x-port, it will open up the console window ofIW3. - Export the assets of your choice by running the commands described below.
Another approach is to run iw3xport.exe directly in the terminal.
This way, you can specify start parameters, for example to set certain dvars.
Simply open a terminal in the game directoy and run iw3xport.exe -stdout <commands>.
The Map Porting Utility tool is an easy to use GUI which provides a bridge between IW3x-port and IW4x.
You can choose the assets you want to export by selecting checkboxes and dropdown elements and let the tool do the rest of the work.
Important
Before you can export any asset, it first has to be loaded by the game.
For that, use the loadzone <zone_name> command with the name of a zone that contains the asset.
Then you can use the commands for the assets you want to export.
To export the M14 Sniper:
loadzone scoutsniper
dumpweapon m14_scoped_silencer_woodlandTo export the head icon of the Marines Team:
loadzone mp_backlot
dumpmaterial headicon_americanExample of how to use it in the terminal, with additional parameters:
iw3xport.exe -stdout \
+set iw3x_correct_speculars 1 \
+set iw3x_convert_gsc 1 \
+set iw3x_smodels_fix_method 2 \
+set iw3x_add_care_packages 1 \
+set export_path mods\airlift \
+dumpmap airlift| Name | Description | Example |
|---|---|---|
materialInfoDump |
Prints all Material Names with SortKey, Packed Flags and StateFlags | materialInfoDump |
loadzone <name> |
Loads the specified Zone | loadzone mp_bog |
dumpTeams |
Exports all Teams | dumpTeams |
dumpTechset * |
Exports all Technique Sets | dumpTechset * |
dumpGfxImage <name> |
Exports an Image | dumpGfxImage ~$white-rgbl |
dumpSound <name> |
Exports a Sound | dumpSound vehicle_fire |
dumpWeapon <name> |
Exports a Weapon | dumpWeapon m14_scoped_silencer_woodland |
dumpXModel <name> |
Exports a Model | dumpXModel com_computer_keyboard |
dumpXAnimParts <name> |
Exports an Animation for a Model | dumpxanimpart viewmodel_m14_idle |
dumpMap <name> |
Exports a Map (run map <name> first) |
dumpMap mp_bog |
dumpclipMap_t <name> |
Exports the Collisions of a Map | dumpclipMap_t maps/cargoship.d3dbsp dumpclipMap_t maps/mp/mp_cargoship.d3dbsp |
dumpComWorld <name> |
Exports the Common World of a Map | dumpComWorld maps/cargoship.d3dbsp dumpComWorld maps/mp/mp_cargoship.d3dbsp |
dumpFxEffectDef |
Exports the Effect Definitions of a Map | dumpFxEffectDef smoke_grenade |
dumpGameWorld <name> |
Exports the Game World of a Map | dumpGameWorld maps/cargoship.d3dbsp dumpGameWorld maps/mp/mp_cargoship.d3dbsp |
dumpGfxLightDef <name> |
Exports the Light Definitions of a Map | dumpGfxLightDef light_point_linear |
dumpGfxWorld <name> |
Exports the Graphics World of a Map | dumpGfxWorld maps/cargoship.d3dbsp dumpGfxWorld maps/mp/mp_cargoship.d3dbsp |
dumpMapEnts <name> |
Exports the Dynamic and Scripted Entities of a Map | dumpMapEnts maps/cargoship.d3dbsp dumpMapEnts maps/mp/mp_cargoship.d3dbsp |
dumpMaterial <name> |
Exports the Materials of a Map | Loadscreen: dumpMaterial $levelbriefingCompass: dumpMaterial compass_mp_cargoship |
dumpRawFile <name> |
Exports the Vision Files, Sun and GSC scripts of a Map | Sun: dumpRawFile sun/map_bog.sunGSC Scripts: dumpRawFile maps/mp/mp_bog.gscVision Files: dumpRawFile vision/map_bog.vision |
Note
Each dvar except export_path and iw3x_smodels_fix_method needs to be enabled by passing 1 to it.
Example: iw3x_raise_ceiling 1
| Name | Description |
|---|---|
export_path <path> |
Path where exported assets will be saved. |
iw3x_raise_ceiling |
Raises the map’s ceiling collision so that high-flying killstreaks (like the UAV or AC-130) don’t fly above it and prevent stinger lock-on. |
iw3x_add_care_packages |
Adds care package models and collisions to the map, otherwise they can't be delivered in IW4. |
iw3x_correct_speculars |
Overwrites IW3 speculars with a different color grading that's better suited to IW4's shader model. |
iw3x_smodels_fix_method <1,2> |
How incompatible IW3 static models will be handled:1 - Swapped for an empty model2 - Moved to script_model in entities so they render as scene entitiesOtherwise, nothing will be done. |
iw3x_replace_turrets_with_miniguns |
Replaces IW3 turrets with IW4 miniguns. |
iw3x_extend_culling |
Increases the culling distance for static models so that they are visible at greater distances. |
iw3x_convert_gsc |
Attempts to automatically convert IW3 GSC scripts & createFX to the IW4 format. When it's disabled, scripts are left as is. |
| Number | Name | Description |
|---|---|---|
| 0 | XModelPieces | |
| 1 | PhysPreset | A physical preset is used with XModels to say how a piece of something should behave when fired at or near an explosion, how bouncy it is, etc... Physical properties |
| 2 | XAnimParts | Animations for a set of bones, often used with XModels too. Somewhat esoteric structure with a looot of data, from which the game reconstructs live animations |
| 3 | XModel | A XModel is an ensemble of surfaces, materials, collisions, skeleton and physical properties that constitute a model for the game - with up to 4 LODs |
| 4 | Material | Materials are sets of textures and parameters to apply said textures onto a surface, aswell as reference to a technique set (rendering passes informations) |
| 5 | Technique Set | A technique set is an ensemble of up to 48 techniques (34 for IW3) describing different render passes the game should combine to draw a material. |
| 6 | Image | While image data is streamed, each image has a corresponding GfxImage Asset which contains metadata about the texture |
| 7 | Sound | "Sounds" are in reality sound alias lists, which mean they contain one or more definitions for sounds that should be played (distance, mixing, pitch, etc) |
| 8 | Sound Curve | Simple definition files used by sound aliases to define how the game should behave over a distance |
| 9 | Loaded Sound | A wrapper for a sound that was fully loaded in memory by Miles Sound System |
| 10 | Clipmap (Singleplayer) | A clipmap contains all the collision from the original BSP a level was built from |
| 11 | Clipmap PVS | |
| 12 | Comworld | "Common world" contains pretty much only light positions and definitions, for ambient and omnidirectional lights in the level |
| 13 | Gameworld (Singleplayer) | A mostly empty but mandatory preallocated structure to hold the dynamic glass data from FxWorld once the game started - always empty in map files |
| 14 | Gameworld (Multiplayer) | |
| 15 | Map Entities | "MapEnts" contain a single very long string inherited from Q3 which lists all dynamic and scripted entities of the level, and information about the map triggers for gamemodes |
| 16 | GfxWorld | "Graphics world" contains all the graphical, visual part from the original BSP a level was built from - this data is linked and sometimes reminiscent to the ClipMap data. It contains most of everything that constitutes a level |
| 17 | Light Definition | Parameters that define a light (color, power, direction) |
| 18 | Ui Map | |
| 19 | Font | A font contains materials and the glyph table necessary to draw characters on screen |
| 20 | Menulist | A transient asset that usually doesn't live in memory for too long (?) and contains a list of menus to load, or to unload. E.g. 'ingame menus', 'main menu', etc |
| 21 | Menu | Each menu displayed in the game exists as a singular Menu asset in memory, which itself can reference other menus or share data with other menus from the same zone |
| 22 | Localized Entry | Smallest struct in the game: a localized entry is just a Key and a Translated value. 'MPUI_BOG' => 'Bog' - and that's one whole localized entry asset |
| 23 | Weapon | Weapons are the biggest structs in the game besides GfxWorld and Clipmap, and contain every single thing a weapon need to work in the game - materials, sounds, animations, ... |
| 24 | SndDriver Globals | |
| 25 | Fx | Special effects, used on the map and in weapons and everything else - usually references sounds, materials, etc |
| 26 | Impact Fx | A list of FX |
| 27 | Ai Type | |
| 28 | Mp Type | Might be unused in this form - probably references mptype CSVs during building a level, a mptype being a set of characters to build into a map |
| 29 | Character | Same as Mp Type - usually present as a rawfile (GSC Script) in the final game, this might have been used during level building only |
| 30 | XModelAlias | Same as Character |
| 31 | Rawfile | Rawfiles are all files the game will do case-by-case parsing for - they can be scripts, vision files, anything that usually involve a form of Com_Parse |
| 32 | Stringtable | |
| 33 | Count | |
| 33 | String | |
| 34 | Assetlist |