Gyro

Gyro
Type	Electrical, Logic
Recipe	Wire 4x Iron 8x
Raw Recipe	Copper 4x Iron 8x
Malleability	Fixed size

The Gyro is a part that is commonly used as a targeting system for contraptions such a missiles, it will orient the front of itself towards a chosen target rotating anything it is welded to in the process. The front of the gyro is represented by a white circle.


In its default state (Unpowered), it will directly aim upwards unless the option DisabledWhenUnpowered is on, in which it will simply stop aiming. This feature can be used to stabilize structures that rely on physics to float, for example, a structure built with Balloons which will inevitably tip over to its heavier side without a gyro.

If powered, it can adjust its orientation to aim at an object it is configured to seek, to choose what to target, you must simply enter text in the option Seek. If seek is blank it will not aim at anything. The Gyro has an option called TriggerWhenSeeked, which when activated will send a trigger signal every tick as long as it has a valid target.

Player targeting

To use a Gyro to target a player, simply enter the player's ID (Not their display name), putting multiples names will make the gyro aim at the closest player in its list. Example : "Player1 Player2". Writing "All" into the Gyro will cause it to aim at every player. Writing "AllExcept" will target every player expect those written after. Example: "AllExcept Player2".

Part targeting

To use a Gyro to target a part, you must first enter "Radar" then you need to write the name of the part. Example: "Radar PowerCell". You can also radar ore deposits, simply by putting the name of the ore with "Deposit" attached. Example: "Radar IronDeposit".

Programming

Microcontrollers can use the gyro to target an arbitrary location expressed as a Vector3 using Gyro:PointAt().

Other

• The commands "Min" and "Max" configure the minimum and maximum distance the gyro can aim at, so if it was "Min80 Max400" it will aim at targets that are from 80 to 400 studs away, ignoring any target less than 80 studs away or more than 400 studs away.
• The commands "TrigMin" and "TrigMax" configure the minimum and maximum distance at which the TriggerWhenSeeked option will send signals, for example if it was "TrigMin80 TrigMax400" it would send a signal if the target was more than 80 studs away but less than 400 studs away.
• The configuration MaxTorque changes how much force the gyro an apply, it is recommended to set it low for stationary devices, as to not break them due to the excessive force applied.
• Inputting "Sun" as the target will make it target the local star or black hole.
• The gyro can be controlled by a Microcontroller using the function :PointAt() More info here

In-game description

"Stabilizes vehicles and structures by pointing upwards. Useful for mechs or orientating structures to the correct rotation. The gyro can also be configured to seek objects and players. When powered, the gyro will follow its seek commands that can be configured using hammer. The gyro has commands that allow it to find and seek objects and players. An example of gyro's seek configuration includes Player1 Player2 which will seek and aim towards the nearest player. Putting Radar at the beginning of the seek configuration will make it target parts instead. For example, Radar Gold Copper will find the nearest Gold or Copper deposit. Putting AllExcept will make the seeker target everything except the given list, basically inverting it. For example, AllExcept Player1 Player2 will target Player3 or Player 4 but not Player1 . The commands Min and Max set the minimum or maximum distance the seeker will target. For example, Min20 Max500 will make the seeker only target objects within 500 studs and more than 20 studs away. TriggerWhenSeeked will trigger all connected parts every second when the Seek configurable is satisfied TrigMin and TrigMax work the same as Min and Max but it's for the trigger signal, trigger signal will only be sent if the above property is true. Putting Sun as part of the list will make the seeker automatically target the main stellar body in the system. Gyros also have a property called MaxTorque. This allows you to control the max force on the gyro to stabilize it. "

Malleability

This part cannot be resized. Default size: 2x1x2

Configuration

• Seek^(string) - The seek commands.
• DisableWhenUnpowered^(boolean) - Determines whether this gyro should be disabled while it does not have power.
• TriggerWhenSeeked^(boolean) - Determines whether to send out a trigger signal when the gyro detects something to seek as determined by the Seek configurable.

Power consumption

Consumes 2 Power per second