JetpackFixes
Fixes multiple bugs with the jetpack, most notably the random explosions, battery drain, and tulip snakes dropping you out of the sky. (See the description for full details!)
| Last updated | 3 months ago |
| Total downloads | 283577 |
| Total rating | 19 |
| Categories | BepInEx Client-side Equipment Bug Fixes |
| Dependency string | ButteryStancakes-JetpackFixes-1.5.0 |
| Dependants | 256 other packages depend on this package |
This mod requires the following mods to function
BepInEx-BepInExPack
BepInEx pack for Mono Unity games. Preconfigured and ready to use.
Preferred version: 5.4.2100README
Jetpack Fixes
Fun fact: The "overheat explosions" often attributed to the jetpack's design are actually caused by a bug. The jetpack has no heat meter or speed limit whatsoever.
More detailed explanation
- The reason the jetpack appears to explode on "overheat" is due to buggy crash damage behavior - the jetpack is programmed to explode ONLY if the player wearing it dies with jetpack controls active. Jetpack controls are enabled the moment you activate the thruster, and are only disabled after you land safely on the ground. (Hence, dying to fall damage still explodes the jetpack if you fall out of the sky with the jetpack turned off)
- Zeekerss programmed a special case where the player is instantly killed by Gravity if you are moving towards an obstacle that is less than 4 units away, while the jetpack is propelling you at more than 50 units per second.
- However, in v49, this condition would erroneously detect invisible "triggers" (which don't normally have collision) as obstacles. The player has several of these triggers attached to their body, causing you to "crash into yourself" and die almost immediately after reaching the speed threshold.
- v50 partially fixed this problem by disabling trigger detection, but there is still one non-trigger collider attached to the player that the jetpack can detect under specific circumstances, which causes you to die still to the same bug.
- This bug is most easily replicated by using the thruster to travel straight upwards - you'll notice there's no limit to how high or fast you can travel, but once you let go of the thruster and start free-falling, you will explode randomly in open sky after only a brief moment.
- v64 makes this bug even worse, because belt bags attached to your waist (in your hotbar) also have collision and cause the jetpack to crash!
- Some other funny consequences of this behavior:
- Since tulip snakes also enable jetpack controls, if they carry you into the air and kill you while you have a jetpack in your inventory, it will still explode.
- Dying with jetpack controls explodes all jetpacks in your inventory - up to 4 at once!
It's possible Zeekerss intentionally left this bug in the game, as a pseudo-balancing feature for the raw power of the jetpack. However, since it's a side effect of incorrect behavior (that was even partially fixed in v50), this mod will get rid of it for you - allowing you to travel as fast as you like, as long as you don't crash (which will still kill you instantly)
By default, you will also explode if you're flying too fast at extreme altitudes, in accordance with the statement below...
I wouldn't really want to drag down the victory of soaring straight up into the sky and exploding like a firework.
– Zeekerss, The time is flying (and so are the jetpacks and tulip snakes)
Although the main feature of this mod is the fixed crash code, there are several additional issues I've addressed:
- I fixed the (infamous) battery bug where the jetpack charge drains while it's turned off or dropped on the floor.
- Hopefully fixed buggy behavior when "feathering" the thruster controls. (Sometimes, in vanilla, it would "drop" inputs and not activate the thruster when you click)
- Fixed buggy interactions between tulip snakes and jetpacks, in which each would cancel out the other. Now they co-exist, in (nearly) perfect harmony
- Fixed the jetpack "getting stuck" and storing momentum if your feet graze an object mid-flight
- Fixed the proximity warning (the beeping) logic being buggy, which caused it to continue playing in open sky, or not start playing when you are near terrain.
- Fixed jetpack audio being distorted when you're flying around with it. (The Doppler effect shouldn't apply to your own jetpack, just when others are flying it)
- If enabled in the config file, dropping the jetpack actually transfers momentum to the player, instead of them stopping in place.
Config
MidAirExplosions- Lets you control the circumstances that would explode the jetpack.Offreplicates the original behavior of this mod, only destroying the jetpack if you crash into something solid.OnlyTooHighallows the jetpack to explode on its own again, but only if you are exceeding vanilla's "safe speed" while you are far above the map. (This is the new default)Alwaysreplicates vanilla's behavior the closest, where the jetpack will always explode once it exceeds the safe speed.
TransferMomentum- Whether dropping the jetpack should launch you in the same direction (True) or halt you in place (False) like vanilla.
