MHW Editor Suite

Edit MHW game data.

Note that this requires extracting the game chunk data using
worldchunktool.

Using the Editor

Due to overly simplistic anti-virus detection the releases might be detected as
virus, trojans or similar. This is due to anti-virus software falsely flagging
how pyinstaller bundles applications. See the pyinstaller github for more information.

Download the latest release,
extract and run MHW-Editor-Suite.exe.

The game loads the chunks incremental, and each chunk overwrites files in
previous chunks.
Loosely speaking, the game loads files in chunk0, then loads files in
chunk1 replacing all files it loaded from chunk1, then it loads files
in chunk2 again replacing all files it loaded from chunk0 or chunk1,
until it has loaded all chunks.

So to get the full database (so-to-speak), you should do the same:

• Extract all <GAMEDIR>\chunk\chunk*.bin using worldchunktool.
• Using Windows File Explorer, merge all extracted chunk directories into one:
  • Create a new directory merged
  • Navigate into chunk directory chunk0, select all and copy.
  • Navigate into merged directory, and paste. Wait for completion.
  • Navigate to next chunk directory chunk1, select all and copy.
  • Navigate to merged directory, and paste. In the popup
    “Confirm Folder Replace” choose “Yes”. In the popup “Replace or Skip Files”
    choose “Replace the file in the destination”. Make sure to replace all files. Wait for completion.
  • Repeat for all remaining chunk directories in ascending order, eg.
    chunk2, chunk3, chunk4, chunk5.
• Using windows File Explorer, create a directory my-first-mod.
• Run MHW-Editor-Suite.exe and open directory merged using the menu File -> “Open chunk directory …”.
• Open the directory my-first-mod using the menu File -> “Open mod directory …”.
• Open files from the chunk directory browser, edit them and save them to add or update them to the mod directory
• Open files from the mod directory browser, edit and save them in mod directory.

Supported file formats:

• *.am_dat - updated for Iceborne
• *.bbtbl - updated for Iceborne
• *.eq_crt - updated for Iceborne
• *.eq_cus - updated for Iceborne
• *.gmd - read only
• *.itm - updated for Iceborne
• *.kire - updated for Iceborne
• *.mkit - modify only
• *.mkex - modify only
• *.shl_tbl - updated for Iceborne
• *.skl_dat - updated for Iceborne
• *.skl_pt_dat - modify only
• *.wp_dat - updated for Iceborne
• *.wp_dat_g - updated for Iceborne
• *.wep_glan - modify only
• *.wep_wsl - updated for Iceborne
• *.sgpa - modify only
• *.arm_up - modify only

Setup for Development

The following is only relevant if having this repository checked out for
development.

Requirements

• Python 3.6
• Tests require extracted game files in test/data

Setup

1. Create virtual python env
2. Run pip install requirements.txt
3. Activate virtual env
4. Run src/mhw_armor_edit/suite.py

Build

1. Create virtual python env
2. Run pip install requirements.txt
3. Activate virtual env
4. Run pyinstaller suite.spec
5. Result is application in dist/MHW-Editor-Suite