This is Warriorstar's branch of the excellent ZHM5Randomizer. It includes a
handful of new randomization types, as well as the CUSTOM
mode which allows
for modifying random generation via the configuration file.
Download the latest preview release, and install as described in the
original README below. To configure CUSTOM
mode, follow the instructions in
hitman_randomizer.toml
, which should have been unzipped in HITMAN2/Retail
.
This mod does not work with Freelancer mode.
I have no plans to make it work with Freelancer mode. Attempting to use this mod in Freelancer mode may cause crashes or loss of items and weapons. I am not responsible for any loss of progress in Freelancer mode due to use of this mod. Do not file issues about Freelancer mode. Do not bug me or ask me any questions about Freelancer mode.
There are four "inventories" that the Randomizer juggles:
This mod only supports missions started from the main menu. This means that:
The Randomizer comes pre-configured with a handful of game modes to make your missions more fun or challenging.
DEFAULT
and NONE
Every inventory supports a DEFAULT
config. DEFAULT
configs all work the
same way: all items are randomly placed. In the case of weapons, they are
randomly replaced with a weapon of the same type.
Similarly, every inventory supports a NONE
config, which disables
randomization for that inventory.
Besides DEFAULT
, the "world" inventory has the following configs:
OOPS_ALL_EXPLOSIVES
replaces all items with explosives.TREASURE_HUNT
randomizes items, but replaces ten of them with golden
idols. Find them all!NO_ITEMS
replaces all non-essential items with coins, and all weapons with
the Hackl 9S.ACTION
replaces all non-essential items with explosives, coins, or
weapons.CUSTOM
: see the section below.Besides DEFAULT
, the "NPC" inventory has the following configs:
UNLIMITED
replaces all NPC weapons with any weapon that the randomizer
knows about.HARD
mode, all NPCs will spawn with one of a handful of pre-chosen,
non-silenced weapons. Nearly all NPCs will be carrying SMGs instead of
pistols.SLEEPY
mode replaces all NPC weapons with cure coins. Cure coins cause a
person to become unconscious after being picked up, and always attracts
NPCs.CHAIN_REACTION
mode replaces some NPC weapons with cure coins, and some
with octane boosters.CUSTOM
: see the section below.CUSTOM
World and NPC inventories support CUSTOM
mode. In CUSTOM
mode, you can
configure the randomization rules yourself!
Items will only be added to the randomization if they match one of the words in the allow list. Likewise, if an item matches a word in the ignore list, it won't spawn.
If ignored_words are used, if an item has that string in its name or matches a category, they will never be added to the randomization. ignored_words is kind of buggy but the logic should still make sense.
A word in an item name like the "syringe" in "Lethal Syringe" is allowed, or a category as listed below. These are the categories it understands:
Here's an example configuration for CUSTOM
mode. Try it yourself!
[Custom.World]
allowed_words = ["coin cure", "kalmer", "lethal proximity", "pristine", "Lethal Poison Syringe Modern", "Emetic Poison Syringe S2"]
ignored_words = ["remote", "anti-virus", "masamune", "sedative", "antique", "taser", "cx", "duck", "serum", "agent", "rusty", "lockpick"]
[Custom.NPC]
allowed_words = ["striker"]
ignored_words = []
To see how to build the Randomizer yourself, read UPDATING.md.