DiscordLink.png FacebookLink.png RedditLink.png SteamLink.png TwitterLink.png YoutubeLink.png

Tractor beam

From Starbase wiki
Jump to navigation Jump to search

Summary



Tractor beam.png

Tractor beams grab objects that their beams hit.
Tractor beams are most commonly found in cargo spaceships as they enable the transportation of heavy cargo.
The beam drags the attached object close to the tractor beam base, orientating the object according to the nozzle of the beam.

Basic information

  • The device requires power to work. The amount of power needed is determined by the beam length, device state, and force applied when moving objects.
    • The further and the heavier the objects are, the more power the tractor beam needs to be able to move them.
  • If power is cut out, the object will stop moving but it will be held in place.
    • This is a safety feature to prevent objects from drifting away, causing possible damage in interiors, such as factories and ships.
  • Tractor beams are commonly controlled with buttons and levers.
    • Buttons toggle the power on and off.
    • Levers control the beam length, rotation and such.
  • In automated factories, the tractor beams are generally connected to a mover.

Device fields

To learn more about how to use fields, consult these wiki pages:

YOLOL field Description Range
tractorBeamOnState Beam on/off 1 or 0
tractorBeamSoftRelease When set to 1, brings the object grabbed by the beam to a stop, then turns off the beam 1 or 0
tractorBeamSnapToObjects When set to 1, tractor beam tries to snap held object to nearby objects 1 or 0
tractorBeamSearchLength Length (meters) of the beam when the beam is not attached to anything. Max range of the beam. -
tractorBeamForce Maximum amount of force (Newtons) the beam will try to apply to grabbed object. -
tractorBeamTorque Maximum amount of torque (Newtons) the beam will try to apply to grabbed object. -
tractorBeamPosition The distance (meters) the beam tries to move a held object to. Resets on grab, but does not message network / other devices. -
tractorBeamYaw The yaw (degrees) the beam tries to move a held object to, relative to the base. Resets on grab, but does not message network / other devices. -
tractorBeamPitch The pitch (degrees) the beam tries to move a held object to, relative to the base. Resets on grab, but does not message network / other devices. -
tractorBeamRoll The roll (degrees) the beam tries to move a held object to, relative to the base. Resets on grab, but does not message network / other devices. -
tractorBeamObjectInBeam Indicates whether an object is grabbed by the beam. 1 or 0
tractorBeamForceApplied Indicates the force (Newtons) currently being applied to the grabbed object. Can be used to detect when the grabbed object has been set to the target position. -
tractorBeamTorqueApplied Indicates the torque (Newtons) currently being applied to the grabbed object. Can be used to detect when the grabbed object has been set to the target rotation. -