Skip to content

Weak Automata

Picture

!Image of the Weak Automata Upgrade

Weak automata is a turtle with a Weak Mechanic Soul upgrade. It has several different abilities:
• Digging blocks with tools
• Interact with blocks with an item or empty hand
• Collect all or specific nearby items
• Detect nearby items
• Detect blocks and entities in front of the turtle
• Charge the turtle with an energy cell in the turtle's inventory

Peripheral Name Interfaces with Has events Introduced in
weakAutomata World No 0.7r

Functions

getFuelLevel

getFuelLevel() -> number
Returns the number of fuel points stored in the turtle.

getFuelMaxLevel

getFuelMaxLevel() -> number
Returns the maximum amount of fuel points that the turtle can store.

getFuelConsumptionRate

getFuelConsumptionRate() -> number
Returns the turtle's current fuel consumption rate.

setFuelConsumptionRate

setFuelConsumptionRate(rate: number) -> true | nil, string
Allows you to control the fuel consumption rate of the turtle. See Cooldowns and Fuel consumption to learn about how fuel consumption affects fuel cost and operation cooldowns.

Returns true if the consumption rate was successfully set, or nil and an error message.

getDigCooldown

getDigCooldown() -> number
Returns the current cooldown for dig operations.

getSuckCooldown

getSuckCooldown() -> number
Returns the current cooldown for item collection operations.

getUseOnBlockCooldown

getUseOnBlockCooldown() -> number
Returns the current cooldown for block interaction operations.

getConfiguration

getConfiguration() -> table
Returns the configuration values for this automata.

lookAtBlock

lookAtBlock() -> table | nil, string
Returns a table containing information about the block infront of the turtle or if the operation fails it will return nil and an error message.

lookAtEntity

lookAtEntity() -> table | nil, string
Returns a table containing information about the entity infront of the turtle or if the operation fails it will return nil and an error message.

digBlock

digBlock(options: table | nil) -> true | nil, string
Tries to dig the block that the turtle is looking at with the current item. It returns true if it successfully mines the block or nil and an error message.

options properties

name type Description
pitch number | nil Relative pitch degrees, negative means to turn left, positive means to turn right (default: 0)
yaw number | nil Relative yaw degrees, negative means to look up, positive means to look down (default: 0)
sneak boolean | nil Sneak while digging (default false)

useOnBlock

useOnBlock(options: table | nil) -> true | nil, string
Tries to interact with the block that the turtle is looking at with the current item. It returns true if it successfully interacts with the block or nil and an error message.

options properties

name type Description
pitch number | nil Relative pitch degrees, negative means to turn left, positive means to turn right (default: 0)
yaw number | nil Relative yaw degrees, negative means to look up, positive means to look down (default: 0)
sneak boolean | nil Sneak while using (default false)

scanItems

scanItems() -> table | nil, string
Returns a list of items that are around the turtle or nil and an error message if it fails.

collectItems

collectItems([count: number]) -> true | nil, string
Tries to collect all items or a specific amount if count is given around the turtle.
Returns true if it successfully collects items or nil and an error message.

collectSpecificItem

collectSpecificItem(item: string[, count: number]) -> true | nil, string
Tries to collect all items or a specific amount if count is given of the given item type that are around the turtle.
Returns true if it successfully collects items or nil and an error message.

feedSoul

feedSoul() -> (true | nil), string
Tries to feed the entity that is in front of the turtle to the mechanic soul upgrade in the the turtle's selected slot.
Returns true and the interaction result as a string or if it fails nil and an error message.

chargeTurtle

chargeTurtle([fuel: number]) -> number | nil, string
Tries to fuel the turtle using an energy cell in the turtle's inventory. The fuel argument limits the amount of fuel it will try to gain.
Returns the amount of fuel points gained or nil and an error message.

placeBlock

placeBlock(options: table) -> true | nil, string

Requirement

Requires compass to be equipped as another peripheral.

Place the selected block with front, top, and anchor direction.
Returns true if it successfully placed block or nil and an error message.

options properties

name type Description
x number | nil The x offset relative to the turtle (default: 0)
y number | nil The y offset relative to the turtle (default: 0)
z number | nil The z offset relative to the turtle (default: 0)
anchor string | nil The direction the block should anchor (default: turtle's forward)
front string | nil The direction the block should facing (default: same as anchor)
top string | nil The direction the top of block should facing (default: "up")
text string | nil the text going to write on the sign's front side
backText string | nil the text going to write on the sign's back side

Changelog/Trivia

0.7.36r Added placeBlock method for accure placement.

0.7r
Added the Weak Automata

Comments