IW4 Zone Asset Finder

This small CLI tool is a very useful ally in building patches for existing zones that are missing assets, or finding which zone to include in your zone_source to obtain a specific asset.

How to use

You can download a release in the Releases section or build one yourself. Once you have a .exe, put it at the root folder of iw4x. This tool needs the latest version of iw4x (zonebuilder) to work. You can then launch the program.

Useful commands

• HELP => Displays a list of all available commands
• UPDATE => This is an important command, and the first one you should fire before doing anything else. This function generates a dependency graph of all assets, used by every map zone (coop and mp). It's a slow but necessary operation, which will then make finding assets between zones almost instantaneous. This process will load and list the assets of each appropriate zonefiles and build a dependency graph from it. You only need to fire it once, and then the graph will be stored in iw4x folder.
• SEARCH => Searches for an asset by name, with a lose text search (imprecise names are allowed). Example:

> SEARCH bushtree

For search term "bushtree" :
Found in the following zones:

image:~foliage_pacific_bushtree01_b~598da624
    mp_afghan
    mp_arkaden_sh
    mp_awp_arena
    mp_battlecity_mountains
    mp_battlecity_mountains_td
    mp_boneyard

• FIND => Finds an asset by exact type and name. The format is: type:name. Example:

> FIND xmodel:com_barrel_metal

For asset "xmodel:com_barrel_metal" :
Found in the following zones:

xmodel:com_barrel_metal
    mp_strike_sh
    mp_strike

• BUILDREQ => This command will build an optimized zone_source.csv with a minimal set of imports for every asset you give it. For example, if you give it three models, present in multiple maps, it will generate a zone source containing these models & the minimal set of maps required to build this source. The format is: "type:name type:name type:name ..." (enclosed with a " character). Example:

> BUILDREQ "xmodel:com_barrel_metal xmodel:com_barrel_shard1 material:mc/mtl_barrel_tan"

The following dependencies are suggested: mp_strike(2 assets), mp_highrise(1 assets),

Source requirements:
require,mp_strike
require,mp_highrise

xmodel,com_barrel_metal
xmodel,com_barrel_shard1
material,mc/mtl_barrel_tan

• IWDFILES => Lists the IWD files (iwi + streamed sounds) used by a map, and outputs them in mapname_iwd.txt.