# Configuration

## Overview

Sensible Toolbox stores its configuration in `plugins/SensibleToolbox/config.yml`. Use the `/stb getcfg` and `/stb setcfg` [commands](/mctantrum-wiki/slimefun/addons/sensibletoolbox/commands.md) to show or modify configuration settings. Editing the `config.yml` file while the server is running is not recommended at this time - there is no command to reload it other than a full server restart (a `/stb reload` command is planned, though).

## Settings

The settings are:

| Setting                                              | Type           | Default                     | Description                                                                                                                                                                                                                                                                                                                                                     |
| ---------------------------------------------------- | -------------- | --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| block\_protection                                    | *special*      | best                        | The block protection system to use. See [Protection](https://reasonfounddecoy.gitbook.io/mctantrum-wiki/slimefun/addons/sensibletoolbox/protection) for more information.                                                                                                                                                                                       |
| coloured\_console                                    | boolean        | true                        | If true, messages to the console will be coloured. Set to false if your console doesn't have working colour support, or you just prefer uncoloured messages                                                                                                                                                                                                     |
| debug\_level                                         | integer        | 0                           | The current debug level. Leave this at 0 under normal circumstances.                                                                                                                                                                                                                                                                                            |
| default\_access                                      | *special*      | public                      | This is the default [access control](https://reasonfounddecoy.gitbook.io/mctantrum-wiki/slimefun/addons/sensibletoolbox/access-control) that newly-placed STB blocks have. One of "public", "private" or "restricted".                                                                                                                                          |
| default\_redstone                                    | *special*      | ignore                      | This is the default [Redstone Response](https://reasonfounddecoy.gitbook.io/mctantrum-wiki/slimefun/addons/sensibletoolbox/items#item-guis) for newly-placed STB blocks. One of "ignore", "high", "low", or "pulsed".                                                                                                                                           |
| energy.tick\_rate                                    | integer        | 10                          | The interval in server ticks between [energy net](https://reasonfounddecoy.gitbook.io/mctantrum-wiki/slimefun/addons/sensibletoolbox/items/energy#energy-nets) ticks; energy supply and demand will be calculated and resolved this often.                                                                                                                      |
| explode\_item\_drop\_chance                          | integer        | 50                          | If a STB item is broken by an explosion, this is the percentage chance that it will drop as an item, rather than being destroyed completely                                                                                                                                                                                                                     |
| gui.texture.bg                                       | Material spec. | stained\_glass\_pane:blue   | The background material to use in inventory GUI's.                                                                                                                                                                                                                                                                                                              |
| gui.texture.button                                   | Material spec. | wood\_button                | The material to use for button gadgets in inventory GUI's.                                                                                                                                                                                                                                                                                                      |
| gui.texture.input                                    | Material spec. | stained\_glass\_pane:cyan   | The material to use around input slots in machine inventory GUI's.                                                                                                                                                                                                                                                                                              |
| gui.texture.label                                    | Material spec. | book                        | The material to use for labels in inventory GUI's.                                                                                                                                                                                                                                                                                                              |
| gui.texture.output                                   | Material spec. | stained\_glass\_pane:orange | The material to use around output slots in machine inventory GUI's.                                                                                                                                                                                                                                                                                             |
| holo\_messages.enabled                               | boolean        | true                        | If true and the HoloAPI plugin is installed, some messages will be displayed via temporary "holograms", to reduce chat clutter.                                                                                                                                                                                                                                 |
| holo\_messages.duration                              | float          | 2.0                         | The duration in seconds per message line for which popup messages will be displayed. E.g. with the default of 2.0, a 4-line message will be displayed for 8 seconds.                                                                                                                                                                                            |
| inventory\_protection                                | *special*      | best                        | The inventory protection system to use. See [Protection](https://reasonfounddecoy.gitbook.io/mctantrum-wiki/slimefun/addons/sensibletoolbox/protection) for more information.                                                                                                                                                                                   |
| items\_enabled.\<item-id>                            | boolean        | true                        | There is actually one setting for every known item ID - for a full list of known ID's, see [Item Reference](https://reasonfounddecoy.gitbook.io/mctantrum-wiki/slimefun/addons/sensibletoolbox/item-reference). If the setting for an item is set to false, then that item is made unavailable - it cannot be crafted or obtained with the `/stb give` command. |
| <p>item\_settings.<br>autobuilder.scu\_per\_op</p>   | integer        | 30                          | The base amount of SCU required by the [Auto Builder](https://reasonfounddecoy.gitbook.io/mctantrum-wiki/slimefun/addons/sensibletoolbox/items/building#auto-builder) to place or break a block. Note that breaking a block may cost more or less SCU than the base, depending on the block material.                                                           |
| <p>item\_settings.<br>multibuilder.scu\_per\_op</p>  | integer        | 30                          | The base amount of SCU required by the [Multibuilder](https://reasonfounddecoy.gitbook.io/mctantrum-wiki/slimefun/addons/sensibletoolbox/items/building#multibuilder) to place or swap a block. Note that this amount can be reduced by an Efficiency enchantment on the tool.                                                                                  |
| <p>item\_settings.<br>paintbrush.wood\_staining</p>  | boolean        | true                        | If true, the paintbrush can be made to stain wood planks and slabs, effectively turning them into other wood types. See [Paintbrush](https://reasonfounddecoy.gitbook.io/mctantrum-wiki/slimefun/addons/sensibletoolbox/items/painting#paint-brush) for more information.                                                                                       |
| <p>item\_settings.<br>paintcan.paint\_per\_dye</p>   | integer        | 25                          | The amount of paint made by mixing a dye in the [Paint Can](https://reasonfounddecoy.gitbook.io/mctantrum-wiki/slimefun/addons/sensibletoolbox/items/painting#paint-can)                                                                                                                                                                                        |
| <p>item\_settings.<br>paintroller.wood\_staining</p> | boolean        | true                        | See *item\_settings.paintbrush.wood\_staining*                                                                                                                                                                                                                                                                                                                  |
| noisy\_machines                                      | boolean        | true                        | If true, machines will make a variety of noises when working                                                                                                                                                                                                                                                                                                    |
| particle\_effects                                    | integer        | 2                           | The amount and frequency of particle effects. Valid values are 0-2. Reduce this to save a little CPU/bandwidth.                                                                                                                                                                                                                                                 |
| rename\_level\_cost                                  | integer        | 5                           | The cost, in experience levels, to rename an animal which is captured in an [Ender Leash](https://reasonfounddecoy.gitbook.io/mctantrum-wiki/slimefun/addons/sensibletoolbox/items/basic#ender-leash).                                                                                                                                                          |


---

# Agent Instructions: 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:

```
GET https://reasonfounddecoy.gitbook.io/mctantrum-wiki/slimefun/addons/sensibletoolbox/configuration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
