Documentation by TAPgiles

# Rotator

Rotates the linked objects around their centres of mass.

The axis of rotation dictates the direction of “positive” rotation according to the “right hand rule.” (Tg)

Note, a joint connector will set the pivot point around which the rotator will rotate a child object.

Gizmo: positioned at the centre of mass of each affected object. This gizmo shows X, Y, and Z axes coming out of it. A circle is shown to indicate the axis the object will rotate around. And a stalk with a movable nub at the end is used to adjust this rotation axis.

Memory: Costs 0.0061% of the things limit per gadget.

# Properties Tab

# Rotation Speed

The target speed of the rotation. (Jj)

# Rotation Strength

The gadget’s ability to overcome physics while increasing its rotation to the target speed, such as the object’s inertia, gravity, friction, etc. (Jj)

# Overall Damping

The gadget’s ability to slow the rotation of the object to the target rotation speed. (Jj)

# Local Space

When on, the rotation axis changes orientation with the gadget. When off, the rotation axis stays the same relative to the overall scene.

# Damping Tab

The gadget’s ability to slow rotation to the target speed.

# Damp in X, Damp in Y, Damp in Z

Overall damping is multiplied for each axis.

# Rotator Direction Damping

A percentage of overall damping is used on the rotational axis as defined by the gizmo.

# Inputs & Outputs Tab

# Affected Object(s)

All linked objects are rotated by this gadget.

# Direction of Rotation

The direction vector around which linked objects will rotate. Sends the direction vector the gadget is rotating objects around.

Does not work while Local Space is on.

# Advanced Rotator

Rotates powered objects around their centre of mass independently for the three axes. (Tg)

Note, by using a connector the joint will set the pivot point around which the rotator will rotate the object.

Gizmo: The rotational axes. Shows circles with rotating lines indicating the target speed of the current rotation settings.

Memory: Costs 0.0061% of the things limit per gadget.

# Properties Tab

# X Axis Speed, Y Axis Speed, Z Axis Speed

The target rotational speed for a given axis. (Tg)

# Rotation Strength

The amount of force that can be applied to bring an affected object’s rotation to the target rotational speeds.

# Damp in X, Damp in Y, Damp in Z

The gadget’s ability to slow the rotation of an affected object to the target rotational speeds.

# Local Space

When on, allows the gizmo to be rotated using a handle at the end of the X axis and Y axis stalks—setting the orientation of the axes to be used for rotations. The orientation of the gizmo will also be adjusted when the gadget is rotated.

When off, the gadget will use the scene’s default grid orientation.

# Miscellaneous Outputs Tab

# Affected Object(s)

This gadget will rotate all objects linked to this output.

# Look At Rotator

Rotates an object around its centre of mass to “face” a target position or direction.

Note, by using a connector the joint will set the pivot point around which the rotator will rotate the object.

Gizmo:

Has a location marker with an arrow showing the direction the linked object is “facing.” The object will be rotated so that the arrow points at the target. (Jj) (Tg) While the gizmo’s position is not set, it will be positioned at the centre of the object being affected.

Note, the gizmo’s base location is tied to the centre of mass of the linked object. And the arrow will use the same direction relative to the orientation of each linked object.

If the gizmo position is in the perfect centre of the face of the gadget (or parent gadget) it behaves as if not set.

Memory: Costs 0.0061% of the things limit per gadget.

# Properties Tab

# Rotation Speed

Sets the rotation speed. (Jj)

# Stay Upright

When on, prevents the gadget from “rolling” the affected objects. (Jj) (Tg)

# Rotation Strength

How much force is used to bring the rotation of the object to the specified rotation speed. (Jj)

# Overall Damping

How quickly the object’s rotation will slow down to face the target. (Jj)

# Look for Tag

Tag gadgets matching this name are allowed to be matched as target positions. (Jj) If there are multiple within range, uses the closest tag.

# Scope

# Strength & Distance Tab

# Minimum Distance, Maximum Distance

Defines a minimum and maximum range a tag must be to be allowed to be targeted. minimum <= tag distance <= maximum

# X, Y, Z Rotation Strength

The percentage of the strength used in each axis.

# Inputs & Outputs Tab

# Affected Object(s)

Linked objects will be rotated by this gadget.

# Target Position

When no wire is plugged in, uses the tag settings.

When a wire is plugged in, uses the received signal as the target position. This overrides a signal received by the Scene Space Direction input.

# Found Target

Sends a signal while a tag is being targeted, or a target position is wired in.

Note if only a direction is being used, this does not send a signal.

# Scene Space Direction

A direction to look in, relative to the object itself. All linked objects will look in the same direction when using this. (Tg)

While there is no tag found, this will output the direction of the “forward” arrow itself. So this can be used to create an easily customisable direction from any object. (Tg)

# Rocket Rotator

Rotates the attached object around its centre of mass to “face” the direction it is moving in.

Note, by using a connector the joint will set the pivot point around which the rotator will rotate the object.

Memory: Costs 0.0061% of the things limit per gadget.

# Properties Tab

# Rotation Speed

The target rotation speed when moving to the desired angle.

# Stay Upright

When on, will not “roll” linked objects.

# Rotation Strength

The gadget’s ability to rotate the affected object(s) against other forces such as inertia, gravity and collisions.

# Overall Damping

The gadget’s ability to slow rotation to the target speed.

# Strength Specifics Tab

# Strength in X, Strength in Y, Strength in Z

Affects the strength differently for each axis of rotation.

# Outputs Tab

# Affected Object(s)

Linked objects will be rotated by this gadget.