Subscribe to download
Multi Hit Limiter

Allows multi hit configuration in sandbox settings. Multi hit can be limited by weapon categories, range, skill level, and allowed or disallowed on a per-item type basis overriding other settings. Additionally, the max hit count of weapons can be capped.

Changes made to items on world load are logged to console.txt. Logging also includes item IDs, which can be useful for adding to the whitelist/blacklists.

Safe to add/remove mid-game. Should be compatible with all mods and multiplayer. Requires weapon multi hit to be enabled in sandbox settings to have any effect; firearms are unaffected.

Due to how multi hit works in Zomboid's Java code, this mod requires manual installation of a Java mod component in order to work properly with changes made to shoving.

If you have used this mod in the past and found it didn't work as well as you expected, this is probably why, as despite the best of my efforts it was impossible to fix this with normal (lua) modding! As such, I've learned how to decompile and recompile the Java code in order to provide a fix and hopefully make sure every part of this mod works as expected.

To install the Java mod provided, you must go to the Steam Workshop mod's folder and find the "zombie" folder, and copy it to your Project Zomboid installation folder. If a more detailed explanation is needed, rather than repeat what others have explained before, I recommend taking a look at the excellent video provided by another author of a different Java mod, Dynamic Body Shape, which shows how it's done (it's the same process for all Java mods).

Note that installing the Java component is optional and only needed for shoving, but it's not required for the changes to weapons to work; there shouldn't be any errors without it installed. See also: caveats.

The default sandbox settings, pictured in the screenshot, are meant to show the minimum this mod can do, and only limit multi hit by weapon range.

The default whitelist setting includes the item type Base.BareHands used by the game for shoving as an example of one way this mod can be configured, as it is possible to e.g disable multi hit on everything except shoving.

The default blacklist setting contains Base.Nightstick, given as a subjective example of a type of item one may potentially want to exclude from having multi hit, due to it being a short blunt weapon with a longer range than one might expect from its appearance (1.2), at least in my opinion. Weapon ranges of vanilla weapons are listed on the PZWiki[pzwiki.net].

If you have the mod configured to prevent or cap shove multi hit and notice that you can shove more targets than expected, and you haven't installed the Java mod component, this is unfortunately expected behaviour as it is impossible to fix without Java modding.

In addition, when holding a weapon without multi hit while shove multi hit is on, it may show multiple targets highlighted (if melee highlighting is enabled) as if you could attack them with your weapon too; this is normal and shouldn't actually allow the weapon to hit multiple targets, only shoving.

Note that in multiplayer, if you change sandbox settings after players have already started, there is a vanilla bug[theindiestone.com] not part of this mod that can cause your changes not to take effect for players, because sandbox settings are saved locally and not overwritten properly when changed, requiring players to manually delete map_sand.bin from their server save folder. This isn't a fault of this or any other mod and affects vanilla sandbox settings as well, and is mentioned here for the sake of completeness in case it helps anyone.

Workshop ID: 2977607164
Mod ID: MultiHitLimiter