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!)
| Date uploaded | 2 months ago |
| Version | 1.4.2 |
| Download link | ButteryStancakes-JetpackFixes-1.4.2.zip |
| Downloads | 31499 |
| Dependency string | ButteryStancakes-JetpackFixes-1.4.2 |
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.
- 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.
- 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 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 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.
CHANGELOG
v1.4.3
- Fixed a NullReferenceException when the jetpack explodes mid-flight
v1.4.2
- Simplified some patches
v1.4.1
- Minor refactor allowing players to crash into other players at high speeds
- Reduced how much vertical momentum is transferred when dropping the jetpack
- Some config fixes
v1.4.0
- Added config setting to control when the jetpack explodes in mid-air from high speeds
- Can be turned off completely
- Can be enabled only at certain heights (new default, like "BecomeFirework" from v1.2)
- Can be enabled always (like vanilla)
- Fixed several interactions between tulip snakes and jetpacks
- Now tulip snakes flapping their wings won't spontaneously disable the jetpack
- Tulip snakes will continue to move you if you turn the jetpack off while they are still flapping
- Added config setting that allows launching yourself by dropping the jetpack mid-flight.
v1.3.0
- v56 compatibility
v1.2.1
- Fixed jetpacks becoming unusable in v50
v1.2.0
- Added "BecomeFirework" setting ;)
- Fixed the Doppler effect distorting the audio of your local jetpack
v1.1.0
- Fixed the "inverted battery" bug (battery now only drains when the jetpack is turned on)
v1.0.0
- Initial release
