Other user's assetsAll the assets in this file belong to the author, or are from free-to-use modder's resources
Upload permissionYou are not allowed to upload this file to other sites under any circumstances
Modification permissionYou are allowed to modify my files and release bug fixes or improve on the features without permission from or credit to me
Conversion permissionYou can convert this file to work with other games as long as you credit me as the creator of the file
Asset use permissionYou are allowed to use the assets in this file without permission or crediting me
Asset use permission in mods/files that are being soldYou are not allowed to use assets from this file in any mods/files that are being sold, for money, on Steam Workshop or other platforms
Asset use permission in mods/files that earn donation pointsYou are not allowed to earn Donation Points for your mods if they use my assets
Author notes
This author has not provided any additional notes regarding file permissions
File credits
This author has not credited anyone else in this file
Donation Points system
Please log in to find out whether this mod is receiving Donation Points
Changelogs
Version 0.17
Tweaked the physics and feel of pulling the player. Made the speed more dynamic, and it will not start at maximum speed when beginning a pull. This will feel a little heavier and slower than how it worked previously. This is especially noticeable when pulling with the Exosuit, but overall, it should better align with the game's feeling.
Version 0.16.1
Fixed: Surface targeting now properly ignores hidden objects.
Version 0.16
Add pulling player speed option.
Add Boost and Brake.
Provide players with the ability to adjust the pulling distance using a mouse scroll while they are actively pulling the target or themselves.
Version 0.15.1
Refine the functionality and physics of tethering the player. Reduce the minimum distance for the player-pulling force to lose its effectiveness, making the pulling player feel snappier.
Version 0.15
Add functionality and an option to auto break breakable resources.
Fixed: Player can still pull to surface even without energy left.
Version 0.14
Add functionality and an option for the player to be able to pull/tether themselves to any surface of non-pullable objects such as terrain, base, and some other non-pullable objects.
Version 0.13
Make a modification to the tethering system so that it is also guided by the player's movement input and viewing direction.
Fixed: player can't target the default vanilla pullable object after it has been launched, if the 'allow all of that specific type' option is not enabled.
Version 0.12
The player's viewing direction now influences the tethering path between the player and the target, allowing players to have more freedom and control over their movements.
Fixed: the line color won't update and requires reloading the game
Version 0.11
Modify the player pulling physics to resemble tethering to the target rather than sticking in place.
Ensure that the pulling line moves from the side of the entity being pulled to the side of the entity doing the pulling to indicate which side is initiating the pull.
Allow the player to be pulled towards the target regardless of whether they are on the ground or in the air.
The player will now be pulled towards the center of the target.
Version 0.10
Add colors for the pulling line at both the puller and pullee sides for better visual differentiation.
Enable the Prawn Suit to pick up pickupable grabbed targets when it's equipped with a Propulsion Cannon on either side of its arms. For example, if it's grabbing an object with the Propulsion Cannon on the left arm, you would use the right hand to pick it up, and vice versa.
Version 0.9.1
When picking up an item with the Propulsion Cannon, the item will be added to the Prawn Suit storage first. If the storage is full, the item will instead be added to the player's inventory.
Fixed an issue where the Prawn Suit's left arm would be activated when the player is picking up an item with the Propulsion Cannon.
Fixed an issue where the Prawn Suit would continually perform the tool animation when the player activated the Propulsion Cannon while pulling the player.
Version 0.9
Feature: Allow the Prawn Suit's Propulsion Cannon to pick up objects with a button press, similar to the Player's version.
Fixed: Fixed an issue where the Propulsion Arm on the Prawn Suit couldn't be used to pull the player if it was equipped on the left side.
Version 0.8
Make player able to fully launch vehicle with option to disable it.
Fixed: player couldn't pull the vehicle even though they're in range.
Fixed: player was able to pull an object from behind a collision.
Version 0.7
Add energy multiplier options
Fixed: Player could pull even when the cannon had no energy.
Version 0.6
Changing the way the pulling works allows the pulled player to move along with the moving target object.
Add disable launch delay option.
Version 0.5
Add support for Propulsion Cannon on Prawn Suit.
Version 0.4.1
fix conflict with propulsion cannon on Prawn Suit. will be supported later.
Version 0.4
Add a separate key to pull the player.
Add an auto-release option when pulling the player.
Version 0.3
Fixed a bug where it was pulling some objects that it shouldn't.
Version 0.2
Add Pulling player instead of target option
Fix bug where it pull some objects that it shouldn't
Version 0.1
initial release
Description
Enhance the Propulsion Cannon, allowing it to pull more than just the original vanilla objects and also yourself towards them. Boost your adventure with Pulling/Tethering. Use the force of movement to slide effortlessly under the sea.
Features
Shoot and Pull with configurable settings.
Pulling/Tethering yourself towards the target.
Also support Propulsion Cannon on Prawn Suit.
Allow the Prawn Suit's Propulsion Cannon to pick up objects with a button press, similar to the Player's version.
Adjust the pulling distance using a mouse scroll while they are actively pulling the target or themselves.
Configurable Settings
(Menu -> Options -> Mods)
Shoot Force Multiplier: multiplier for Shoot force. (default: 1)
Pull Force Multiplier: multiplier for Pull force. (default: 1)
Pull Range: range in meters. (default: 18)
Energy Per Second Multiplier: Energy consumed while pulling. (default: 1, 0 signifies no energy consumption)
Energy Per Shot Multiplier: Energy consumed when shooting an object. (default: 1, 0 signifies no energy consumption)
Auto Break Resource?: Breakable resources such as those outcrops will automatically break if the player pulls them within reach.
Disable Launch Delay?: By default, the game applies a delay after launching an object, preventing you from pulling that object again. This feature disables that delay.
Button to Pull/Tether Player: Use this button to pull the player towards the target. (Default: Left Mouse)
Button to Brake Pull Player: While holding down this button, Pull speed will drop to 50%
Button to Boost Pull Player: While holding down this button, Pull speed will boost to 150%
Player Pull Speed: Speed to use when pulling the player, taking the pull force into account.
Puller Side Line Color: Color for the side that is doing the pulling. (Normally, you would be on this side.)
Pullee Side Line Color: Color for the side that is being pulled. (You will be on this side if you choose to pull the player instead.)
Distance to Auto Release Pulled Player?: When you are close to the target within a specified distance, pulling will cancel automatically. (The default is 0, which is disabled.)
Allow Pulling for all Livings?: Fish, Plants, Creatures.
Allow Pulling for all Vehicles?: Seamoth, Prawn Suit and Cyclops.
Allow Pulling for Others?: This includes any objects not specifically mentioned here. (Some objects may still be left out.)
Allow Pulling Player to all Surface?: By enabling this option, you will be able to target any surface of non-pullable object, such as the ground, terrain, base, and some other unspecified ones, and pull yourself toward them. This applies only to pulling the player towards the target.
Allow Full Launch for Vehicle?: By default, a launched vehicle will travel with restriction and won't go far from the player (you can pull yourself and go along with it, even with this option disabled). However, by enabling this option, the launched vehicle will travel with no restriction. There is a high chance it will clip through the terrain if it's far enough from the player, especially for the Prawn Suit as it tends to fall down, though the Seamoth and Cyclops handle this somewhat better.
Use Cases
Set any value to the minimum and disable any optional toggles to restore the default vanilla behavior. From there, you can choose how you want to enhance your Propulsion Cannon.
Tethering/pulling yourself to the target, you can swing from Creepvine to Creepvine like Tarzan in the jungle, or juggle between birds in the air as if you're an acrobat in a circus.
Turn on the 'Disable Launch Delay' option after shooting the grabbed target, then press the 'Pull Player' button to fly along with the target.
Known Issues / Limitations / Untested
Launching a vehicle with full launch enabled will likely cause the vehicle to clip through the terrain. Consider accompanying the launch to keep the terrain loaded around the player and prevent it from clipping.
Without the full launch vehicle option enabled, launching the vehicle into the air might cause it to get stuck if it's far enough from the player. However, you can easily bring it back down by using the pull feature.
Requirements
BepInEx
Nautilus
Tested on game version 71137(2.0 update)
Installation
Place the mod folder (PropulsionCannonEnhancement) along with the (.dll) file in the [Subnautica Root Directory]/BepInEx/plugins