> For the complete documentation index, see [llms.txt](https://machina-1.gitbook.io/machina-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://machina-1.gitbook.io/machina-docs/workorders/configuration.md).

# Configuration

A fully-commented `config.yml` is generated on first run, and everything works at its defaults. Reload changes live with `/workorders reload` (no restart needed). The sections below cover the knobs you're most likely to touch.

## Performance — `settings`

| Key                      | Default | What it does                                                               |
| ------------------------ | ------- | -------------------------------------------------------------------------- |
| `service-interval-ticks` | `10`    | How often the work loop runs (lower = snappier, higher = lighter).         |
| `slices`                 | `4`     | Spreads golem processing across this many ticks to smooth the load.        |
| `active-radius`          | `64.0`  | Golems only work within this radius of a player; otherwise they hibernate. |
| `range-cap`              | `48.0`  | Maximum distance between a golem's pickup and drop-off.                    |
| `move-speed`             | `1.0`   | Golem movement-speed multiplier.                                           |
| `pull-batch`             | `16`    | Items moved per pickup action.                                             |

## Ownership — `ownership`

| Key                    | Default        | What it does                                            |
| ---------------------- | -------------- | ------------------------------------------------------- |
| `trusted-only-retask`  | `true`         | Only the owner or a trusted friend can re-task a golem. |
| `wax-anyone`           | `true`         | Anyone may wax a golem (vanilla-friendly).              |
| `whistle-enabled`      | `true`         | Enable the copper-ingot whistle recall.                 |
| `whistle-item`         | `COPPER_INGOT` | Item held to whistle.                                   |
| `whistle-radius`       | `48.0`         | How far the whistle reaches.                            |
| `follow-max-distance`  | `18.0`         | A follower teleports to catch up past this distance.    |
| `follow-stop-distance` | `3.0`          | How close a follower settles behind you.                |

## Vanilla coexistence — `native-ai`

| Key                    | Default | What it does                                                                                                                                            |
| ---------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `suppress-native-sort` | `auto`  | `auto` disables the vanilla copper-chest sorting brain on **managed** golems so they don't abandon their job; `off` leaves vanilla behaviour untouched. |

## Job gating — `gating`

| Key                  | Default | What it does                                        |
| -------------------- | ------- | --------------------------------------------------- |
| `require-permission` | `true`  | Enforce the per-job `workorders.job.*` permissions. |

## Recipes — `work-orders` & `roles`

The `work-orders` section defines the crafting recipe for each job (`courier`, `stoker`, `restocker`, `janitor`, `sorter`, `farmhand`) — change the shape, ingredients, or cost to fit your economy.

The optional `roles` map lets a **plain vanilla item** assign a job (handy for quick testing or a token-driven economy). It's empty by default:

```yaml
roles: {}
#  courier: [HOPPER_MINECART]
#  stoker: [FURNACE, BLAST_FURNACE]
```

## Per-job tuning

| Section     | Key                 | Default | What it does                            |
| ----------- | ------------------- | ------- | --------------------------------------- |
| `restocker` | `default-threshold` | `64`    | Top-up target when none is set on bind. |
| `janitor`   | `radius`            | `8`     | Pickup radius for dropped items.        |
| `farmhand`  | `radius`            | `8`     | Harvest/replant radius.                 |

## Feedback & polish — `feedback`

Toggles for the sensory layer: `sounds`, `actionbar` status lines (held for `actionbar-hold-seconds`), per-job `nameplate`, `frozen-glow`, `sluggish-fx`, and `bring-flower`. Set `intensity` (`normal` by default) to dial the whole thing up or down. `debug: false` adds verbose logging when you need it.

***

*Work Orders is built by* [***Machina***](https://wearemachina.com) *— custom Minecraft plugins and more at* [*wearemachina.com*](https://wearemachina.com)*.*


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://machina-1.gitbook.io/machina-docs/workorders/configuration.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.