Skip to content

Update documentation for 0.8 #97

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
wants to merge 5 commits into
base: 0.8
Choose a base branch
from
Draft
Changes from 3 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
39 changes: 35 additions & 4 deletions docs/turtles/metaphysics/weak_automata.md
Original file line number Diff line number Diff line change
Expand Up @@ -95,23 +95,38 @@ Returns the configuration values for this automata.

### lookAtBlock
```
lookAtBlock() -> table | nil, string
lookAtBlock(options: table) -> 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.

#### `options` properties

| name | type | Description |
| ----- | --------------- | ------------------------------------------------------------------------------------------------ |
| pitch | `number | nil` | Relative pitch degrees, negative means to turn left, positive means to turn right (default: `0`) |
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

yeah if we can start another colume called default I think it will looks much better

| yaw | `number | nil` | Relative yaw degrees, negative means to look up, positive means to look down (default: `0`) |

---

### lookAtEntity
```
lookAtEntity() -> table | nil, string
lookAtEntity(options: table) -> 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.


#### `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`) |

---

### digBlock
```
digBlock(options: table | nil) -> true | nil, string
digBlock(options: table | nil) -> boolean, 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.

Expand All @@ -127,7 +142,7 @@ Tries to dig the block that the turtle is looking at with the current item. It r

### useOnBlock
```
useOnBlock(options: table | nil) -> true | nil, string
useOnBlock(options: table | nil) -> boolean, 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.

Expand All @@ -141,6 +156,22 @@ Tries to interact with the block that the turtle is looking at with the current

---

### updateBlock
```
updateBlock(options: table) -> boolean, string
```
Tries to update the text of the sign that the turtle is looking at with the `options.text` property

#### `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`) |
| text | `string` | The text to apply to the sign |

---

### scanItems
```
scanItems() -> table | nil, string
Expand Down