Subscribe to download
Gyro Ship Rudders (Mod Component)

Hello! After several trials and adjustments, I'm happy to announce that the performance impact for this mod has been finally resolved! I was able to implement multi-threading to allow this mod to run separate from the game's main thread. This means that the mod will no longer slow down your game. With this I am officially removing the maintenance status.

This update wouldn't be possible without the Keen sample codes and the guys from Terran Titans of Dygamic Naval server that provided sample data and did most of the testing. Thank you!

This mod aims to add a more realistic ship steering for Water Mod. It uses gyros to steer the ship as well as keep it from rolling or pitching too much. The script also throttles the turning speed based on the ship's speed to avoid UFO ships. This mod works on dedicated servers.


Vanilla
This mod can work as a standalone mod. By default, it uses gyroscopes installed on ships for alignment and steering. In order for the mod to recognize the gyro, the "rudder" tag must be added to the gyro's custom name. All gyros must be on the main grid, together with the control seats that will control the ship.

For Modders
Modders can create their own "rudders" using a gyro block as base. For this mod to recognize the modded gyros, the tag "shiprudder" must be added to the block's SubtypeId. The rmaxturnspeed is based on large grid gyro at 30 rpm. If the max rpm is increased, the turning speed will be increased as well. Don't forget to add this as a dependency! :)

Recommended Water Mod Settings
/wtideheight 2
/wwaveheight 4
/wwavescale 2

Several settings are available to fine tune this mod. Take note that the settings will apply to all ships. The settings can be found in the world save storage folder. The list below shows the commands the can be entered in chat to update the setting.

<command> - Enter to show the current setting
<command><space><value> - Enter to update the setting

Commands:
/rcommands - Shows a list of available commands
/rreset - Resets all the values of the settings
/rallowvanillagyros - True/False - Set to allow / disallow gyros tagged with "rudder"
/rmaxpitchangle - The maximum pitch angle before the mod realigns
/rmaxrollangle - The maximum roll angle before the mod realigns
/rcorrectionspeed- The the speed of the realignment. High values will result to twitching
/rminspeedtoturnmps - The minimum speed for the ship to turn in meters per second
/rmaxturnspeed - This is a percentage of the gyro's maximum RPM
/rminturnspeedmodifier - Controls the lowest turn speed based on the rmaxturnspeed
/rmaxturnspeedmodifier - Controls the highest turn speed based on the rmaxturnspeed


Special thanks to Whiplash for sharing scripts which I used as basis for this mod,
to Kamikaze for helping me figure out some dedicated server logic and to Digi for
guiding me with the networking part!

Looking for an awesome community that builds ships, planes, tanks, subs, and more?

Join us at Space Engineers Naval Battles (SENB)!
https://discord.gg/TbE7cPcNCV

Also checkout the Dygamic Naval Survival Server!
https://discord.gg/A5KzUFvRyJ

Enjoy!