You are viewing a potentially older version of this package. View all versions.
susson-ShotgunJump-1.0.0 icon

ShotgunJump

Increases the shotgun knockback to jump higher. Also can be adjusted in the config.

By susson
Date uploaded a week ago
Version 1.0.0
Download link susson-ShotgunJump-1.0.0.zip
Downloads 2081
Dependency string susson-ShotgunJump-1.0.0

This mod requires the following mods to function

BepInEx-BepInExPack-5.4.2305 icon
BepInEx-BepInExPack

BepInEx pack for Mono Unity games. Preconfigured and ready to use.

Preferred version: 5.4.2305

README

ShotgunJump

Makes firing the shotgun throw you backwards hard enough to rocket jump with it. Look down, shoot, fly.

Shotgun Jump Demonstration

The game already applies a small recoil knockback to the player on every shot (Weapon.Shoot adds -camera.forward * _recoilKnockback straight onto your velocity). This mod just rewrites that value before each shot. Nothing else about the weapon changes: damage, spread and pellet count are all vanilla.

Client-side only

Shoot() only ever runs on the local client, and movement in How to Fish is client-authoritative, so only you need this installed. Your friends don't need the mod, don't need a matching version, and will just see you flying around. There is no fall damage in this game, so you won't die on landing.

Configuration

Config file: BepInEx/config/howtofish.shotgunrocketjump.cfg

Edits apply live — you don't need to restart the game. Alt-tab, save the file, alt-tab back and the next shot uses the new value. If you have HTFModManager installed you can edit it from the in-game Options menu instead.

1. General

Setting Default What it does
Enabled true Master switch. Turning it off restores vanilla knockback without uninstalling.
WeaponNameFilter shotgun Only weapons whose prefab name contains this text get boosted. Case-insensitive.
AffectAllWeapons false Ignore the filter and boost every gun in the game.

2. Force

Setting Default What it does
Mode Absolute Absolute uses AbsoluteForce directly. Multiplier scales the weapon's own vanilla value.
AbsoluteForce 20 The main dial. Metres per second you get thrown, straight back from where the camera points.
Multiplier 8 Only used in Multiplier mode.

Rough feel for AbsoluteForce:

  • ~8 — a noticeable shove
  • ~12 — a decent hop
  • ~20 — a proper rocket jump (default)
  • ~35 — across-the-map silly

Absolute is the recommended mode. Multiplier does nothing if the weapon's vanilla value happens to be 0.

3. Debug

Setting Default What it does
LogWeaponNames true Logs each weapon's prefab name and vanilla knockback the first time you fire it.

If the shotgun isn't reacting, this is how you fix it. Fire the shotgun once, open the BepInEx console or BepInEx/LogOutput.log, and look for a line like:

Fired weapon 'Shotgun(Clone)' | vanilla _recoilKnockback = 3

Whatever name shows up there, put a distinctive piece of it into WeaponNameFilter. Then set LogWeaponNames to false.

Note

Because movement is client-authoritative, the server accepts wherever you end up. That makes the mod work without anyone else installing it, but it also means it is functionally indistinguishable from movement cheating. Great in your own lobby with friends; don't be surprised if it's unwelcome elsewhere.

CHANGELOG

Changelog

1.0.0

  • Initial release. Configurable shotgun recoil knockback with absolute and multiplier modes, weapon name filtering, and a weapon-name logger for finding prefab names.