Animatronic¶

The Animatronic is a puppet which can be positioned or animated. By default, the animations will be looking rusty. This can however be changed.

The maximum rotation of every body part is 180° positive or negative.

Example¶

In order to use the Animatronic, a modem needs to be placed below it. Said modem can then be connected as usual.

Once connected, it can directly be called and used in the code:

local animatronic = peripheral.find("animatronic")

-- Make it stand normally rather than hanging,
-- like it does by default.
animatronic.setHeadRot(0,0,0)
animatronic.setLeftArmRot(0,0,0)
animatronic.setRightArmRot(0,0,0)

-- We also need to apply the changes,
-- after we configured it like above.
animatronic.push()

Note that transitioning from the previous pose to the new one takes about 1 second, with the exception if the transition type is set to none, where it instead will be switching instant:

local animatronic = peripheral.find("animatronic")

animatronic.setTransition("none")

-- ...

Metadata¶

API¶

setFace(face)¶

Changes the face of the Animatronic.

Parameters

1. face: string The new face. Must be either "normal", "happy", "question" or "sad".

Throws

1. Whenever the given string is not one of those types.

setTransition(kind)¶

Sets the Animatronic's animation transition mode.

Parameters

1. kind: string The new transition mode. Must be either "linear", "none" or "rusty".

Throws

1. Whenever the given string is not one of those types.

push()¶

Pushes the stored rotation values to the Animatronic. After pushing them, every rotation gets reset to 0.

setHeadRot(x, y, z)¶

Sets the head rotation. Can only be set within the bounds -180° to 180° for x, y and z.

Parameters

1. x: number The x rotation.
2. y: number The y rotation.
3. z: number The z rotation.

setBodyRot(x, y, z)¶

Sets the body rotation. Can only be set within the bounds -180° to 180° for y and z.

Parameters

1. x: number The x rotation.
2. y: number The y rotation.
3. z: number The z rotation.

setLeftArmRot(x, y, z)¶

Sets the left arm rotation. Can only be set within the bounds -180° to 180° for x, y and z.

Parameters

1. x: number The x rotation.
2. y: number The y rotation.
3. z: number The z rotation.

setRightArmRot(x, y, z)¶

Sets the right arm rotation. Can only be set within the bounds -180° to 180° for x, y and z.

Parameters

1. x: number The x rotation.
2. y: number The y rotation.
3. z: number The z rotation.

getStoredHeadRot()¶

Returns the current stored head rotation.

Returns 1. number The x rotation 2. number The y rotation 3. number The z rotation

getStoredBodyRot()¶

Returns the current stored body rotation.

Returns 1. number The x rotation 2. number The y rotation 3. number The z rotation

getStoredLeftArmRot()¶

Returns the current stored left arm rotation.

Returns 1. number The x rotation 2. number The y rotation 3. number The z rotation

getStoredRightArmRot()¶

Returns the current stored right arm rotation.

Returns 1. number The x rotation 2. number The y rotation 3. number The z rotation

getAppliedHeadRot()¶

Returns the rotation of the head.

Returns 1. number The x rotation 2. number The y rotation 3. number The z rotation

getAppliedBodyRot()¶

Returns the rotation of the body.

Returns 1. number The x rotation 2. number The y rotation 3. number The z rotation

getAppliedLeftArmRot()¶

Returns the rotation of the left arm.

Returns 1. number The x rotation 2. number The y rotation 3. number The z rotation

getAppliedRightArmRot()¶

Returns the rotation of the right arm.

Returns 1. number The x rotation 2. number The y rotation 3. number The z rotation