tools/

Setup

• Download and install Go
• Download this repository as Zip (or use git clone)
• In the command line, navigate into the repository folder

Tools

Hash Tool

Calculate and crack murmur64a hashes.

• go run ./cmd/tools/hash_tool for a list of options

Crossref-checker

Check if selected game files reference any other game files by hash.

• go run ./cmd/tools/crossref-checker for a list of options

Entity Modder

Create patches using modified entity json exports.

1. Export entities to json
2. Find the entity to modify
3. Edit the json file and change some values
4. Run the entity-json-parser tool to write a patch for any number of entity files

Entity JSON Parser Options

go run ./cmd/tools/entity-json-parser/ --entity-names ... --entities ... [--output <archive-hash>.patch_0] [--levels ...]

--entity-names 0x1234 0x5678 ...

This is a list of entity hashes to be overwritten in the patch

--entities ./path/to/modified1.entity.json ./path/to/modified2.entity.json ...

This is a list of json files to be parsed and saved as the given entity-names in the generated patch

The entity-names and entities lists must either be the same length, or the entities list of files must only include one file. If only a single file is included, every entity in the entity-names list will be overwritten with the same file.

--output 9ba626afa44a3aa3.patch_0

This is the location of the output patch file, which defaults to the boot archive

--levels ./path/to/modified1.level.json ./path/to/modified2.level.json

This is a list of level json files (which must have embedded entity files) that will have their embedded entity file updated in the patch. This is an advanced, optional feature.