Tilaa ladataksesi
MART | Whip's Mouse Aimed Rotor Turret Script

As of game version 1.200, the game now properly synchronizes player inputs in seats. This means that you can finally use MART with multiple people simultaneously on the same ship!

Also update 1.200 introduced the Custom Turret Controller (CTC) which allows users to create custom turrets that can be either manually controlled or AI controlled without the use of scripts. CTCs can not control multiple elevation rotors or stabilize your aim, but my new Turret Controller Enhancement Script extends all of the features of MART to CTCs. I would highly consider trying TCES as a MART replacement as it is more capable and feature rich.


You can get the tank shown above HERE!

• Added optional gyro assistance. Simply place a gyro on the azimuth or elevation grid and group it to use it.
  
• Added main elevation rotor specification. Add the word "Main" to the name of the rotor you want to be considered the parent elevation rotor that all other rotors mimic.
  
• Added independent stabilization terms for azimuth and elevation.
  
• Turrets return to rest position when not being controlled
  
• Automatic turret stabilization feature :D
  
  
• This code can now support unlimited elevation rotors per turret group!

Howdy!

This script allows the user to control player made rotor using direct mouse inputs from a cockpit or control seat. No gyroscope or remote control is needed to do this since the code reads the user's mouse movement and directly converts it to rotor velocity. Rotor turrets using this code will emulate the movement of a manually controlled AI turret :)

Mouse aimed rotor turrets (MARTs) can have one or more Elevation rotors per turret group and the angles of each elevation rotor will be synced; however, only one Azimuth rotor can be used per MART group. You can fire the weapons in a turret group by pressing the default button for "crouch" [C].

Since the program can read mouse inputs directly from a cockpit or control seat, you are able to make land-based tanks using MARTs that can be fully crewed by just one person! You can also control multiple MARTs with only one code!


It is recommended that you read all the instructions before attempting
to use this code! This will make troubleshooting any issues much easier <3

1. Place this script in a program block
   
2. Set up mouse aimed rotor turret groups (see below sections)
   
3. Set ownership on EVERYTHING to yourself
   
4. DON'T FORGET TO SET YOUR ROTOR LIMITS!

Mouse aimed rotor turret groups must be named like the following:
"MART <ID Tag>"
Where <ID Tag> is the unique identification tag of the rotor turret.

Example Turret Group Names:

• MART 1
  
• MART WhiplashIsAwesome
  
• MART Tank Turret

EACH turret group must have:

• One cockpit, control seat, or remote control (passenger seats wont work!)
  
• One azimuth (horizontal) rotor/hinge with "Azimuth" in its name
  
• One or more elevation (vertical) rotor(s)/hinge(s) with "Elevation" in its name
  
  • Place the word "Main" in the name of the elevation rotor that you want to be used as the parent rotor that all other elevation rotors follow. The code will pick this automatically if you do not specify :)
• One or more weapons or tools on* each elevation rotor
  (rocket launchers, gatling guns, welders, grinders, drills, cameras, and spotlights supported)
  * "On" means on the same grid as the elevation rotor head

Optional components:

• Gyros for rotor movement assistance: Gyros placed on elevation and azimuth grids will be used to help turn the turret if they are in the MART group.

Names of blocks don't matter beyond what is required.
Example: "Advanced Rotor - Azimuth"

Open the programmable block's Custom Data to change variables without needing to mess with the code!

1. Open the program's Custom Data
   
2. Change the variables you want
   
3. Run the script with the argument "setup"

By default, turrets will return to rest position when not being controlled. To set your own rest angle for a specified MART rotor, simply type the desire rest angle (in degrees) inside the rotor's custom data.
Example: This would set the rest angle for the rotor to be 30 degrees




I had initially envisioned this code to make multi crewed vessels possible, but bugs have smashed that dream. If they ever fix the bug where multiple seats can't be controlled, this code will still work without modification. Here's hoping! This was finally fixed!

Post any questions, suggestions, or issues you have in the comments! <3
Also, I'd love to see what y'all make with my scripts so feel free to post your turret creations in the discussions section!

Turret design in the picture was based off a design by 5URG3 :)

As always, I will be continuing to improve and support this code as time goes on :). My next plan long term stretch goal is to make this code interface with my Turret Slaving Script to allow a MART to control other rotor turret's angles. This; however, is near the back of my current priority list.

Weapon Core guns do not show up as "guns" to the script API, so they will not register as valid weapons or tools.

This should also go without saying, but do not reupload without explicit permission from me, not even to mod.io.

- Whiplash141

(Do not reupload without permission, not even to mod.io)