NOTE: Before reading this guide, determine where your World at War root directory is located.
Non-Steam Install: C:\Program Files (x86)\Activision\Call of Duty World at War\
Steam Install: C:\Program Files (x86)\Steam\steamapps\common\Call of Duty World at War\
For the rest of this guide, it will be assumed that the word "root" refers to the appropriate installation path shown above.
Say 'Yes to all' if Windows asks you about replacing files when dragging files into your root directory.
Download the latest version of WeaponsEditor++ and place it anywhere on your computer. If there is a newer version of the program available, it will notify you upon launch.
Open UGX WeaponsEditor++.exe. Open a Windows Explorer window and navigate to wherever your weaponFile is which you would like to edit. All the stock World at War weaponFiles are in root/raw/weapons/sp, but don't edit them there! Copy them to your root/mods/mapname/weapons/sp folder to edit them.
Drag the desired weaponFile onto the "Drop Zone" of UGX WeaponsEditor++.
As of v1.0.0 of the program there are additional ways of opening weaponFiles:
Once you have opened a valid weaponFile, the program will be populated with all of the settings for the weapon. You can freely make any desired changes without worrying about the original file being overwritten - changes will only be saved if you use the Save button.
UGX WeaponsEditor++ has a search feature to quickly jump to settings. This should be a major productivity boost for anyone who is editing the same setting(s) for multiple files
To use the search box, simply start typing the name of the setting. If an exact match for the setting is found, it will be displayed directly in the searchbox. Any close matches will be displayed in a dropdown box below the search. You can click any of the settings you see to select them for the search box. Hit enter to jump to the setting.
UGX WeaponsEditor++ features over 200 tooltips which attempt to aid you in discovering what the settings available to you are actually used for. To learn what any setting in the program does, hover over it (not the text label, the setting box itself) and read the description which appears. If you believe one of the tooltips is incorrect, please send a PM to treminaor on the forum.
Once you have finished editing the weaponFile, you can either save the changes to the file you have open with the Save button, or you can save it as a new weaponFile with the Save As button. If you accidentally close UGX WeaponsEditor++ before saving your changes, it will warn you before closing the program.
UGX WeaponsEditor++ has an "Advanced Mode" which can be toggled on and off via the check box above the save buttons. As it's tooltip states, Advanced Mode allows you to edit/add any setting for the currently opened weapponFile, regardless of if the setting was originally in the file. This is mainly used to convert a weapon to a different weaponClass (for instance, turning a colt into a grenade launcher). Without Advanced Mode, you would not be able to add the needed class settings to do these conversions.
It is also useful for adding certain settings to the weaponFile which are actually supported by the class, even if not originally available in the weaponFile. For example, you can add "Fire Type" to projectile weapons, even though the files don't have this setting in them. There are other settings which will work like this - try for yourself and you might be surprised! Don't be afraid to add settings which might not work with the current weaponClass - if they are not supported they will be ignored by the engine.
If you would like to port a weapon from Black Ops 1 but don't want to waste time transferring all of the state timers, damage stats, ammo stats, model settings, etc from the BO1 weaponFile to a World at War weaponFile, you can use the Convert to CoD4/5 button to make a BO1 weaponFile compatible with CoD4/5. It removes most of the "ikHandle" settings and some other useless Black Ops-specific settings which were making the weaponFile too long to be parsed by the World at War engine. Be sure to use Save or Save As after converting your weaponFile, otherwise the changes will not be made!
If the program crashes for any reason or does not do something correctly, please take any relevant screenshots and send a PM to treminaor on the forum so that he can address the problem and release an update to the program.