> For the complete documentation index, see [llms.txt](https://docs.mantic.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mantic.dev/mantichoes/configuration-and-editor.md).

# Configuration and in-game editor

ManticHoes configuration and in-game editor

ManticHoes creates its files under `plugins/ManticHoes/` when the server starts. Stop the server and make a backup before editing YAML by hand. Keep your license key and any private Discord webhook URL in `config.yml` out of public posts.

## Main files

| File                    | Settings                                                                                                             |
| ----------------------- | -------------------------------------------------------------------------------------------------------------------- |
| `config.yml`            | Global behavior, token and money providers, crop rules, first-join hoe, captcha, payouts, and optional integrations. |
| `commands.yml`          | Command names and aliases. Changes need a full server restart.                                                       |
| `messages.yml`          | Player-facing messages and command help text.                                                                        |
| `enchants.yml`          | Built-in and custom enchantment settings.                                                                            |
| `harvester-hoes.yml`    | Hoe types, item appearance, and hoe-specific settings.                                                               |
| `prestige.yml`          | Prestige enablement, requirements, rewards, and modifiers.                                                           |
| `harvest-event.yml`     | Harvest-event schedule, duration, eligibility, and rewards.                                                          |
| `override-prices.yml`   | Crop prices and shop item redirects or IDs.                                                                          |
| `menus/main.yml`        | Main hoe menu.                                                                                                       |
| `menus/upgrades.yml`    | Upgrade menu.                                                                                                        |
| `menus/disenchant.yml`  | Disenchant menu.                                                                                                     |
| `menus/prestige.yml`    | Prestige menu.                                                                                                       |
| `menus/token-shop.yml`  | Token shop items and layout.                                                                                         |
| `menus/crop-prices.yml` | Crop-price menu.                                                                                                     |
| `menus/leaderboard.yml` | Leaderboard display.                                                                                                 |
| `menus/settings.yml`    | Player hoe-settings menu.                                                                                            |

For a first setup, the most useful `config.yml` options are `tokens-per-crop`, `enable-shop`, `economy-provider`, `money-provider`, `enable-auto-grow`, `auto-grow-time`, `must-use-hoe-to-break-crops`, and `player-based-hoe-levels`.

`economy-provider` selects the token balance source. The default `ManticHoes` uses ManticHoes' own token balance. Other supported values include `Vault`, `Vault:<economy>`, `PlayerPoints`, `EcoBits:<economy>`, `SuperMobCoins`, `MiningEconomy`, `ManticRods`, and `ManticSwords`. `money-provider` selects the provider used for money payouts; it supports `Vault`, `Vault:<economy>`, `PlayerPoints`, `EcoBits:<economy>`, and `SuperMobCoins`. Install the matching economy plugin and keep provider names case-sensitive.

## In-game editor

1. Give the staff member `mantichoes.editor` (default: operators).
2. In game, run `/mantichoes editor`.
3. Click a category, browse to a setting, and follow the prompt. Type `cancel` in chat to leave a text prompt without changing the setting.
4. The editor saves a change immediately and reloads plugin settings. Changes to `commands.yml` still need a server restart.

The editor includes General, Commands, Messages, Enchantments, Harvester hoes, Prestige, Harvest event, Price overrides, and Token shop. Other menu files are edited directly as YAML. Grant `mantichoes.editor.logs` as well to show the activity log inside the editor; the log is also written to `plugins/ManticHoes/config-editor.log`.

For manual edits, run `/mantichoes reload` if you have `mantichoes.reload`, or restart the server. See [Permissions](https://docs.mantic.dev/mantichoes/permissions.md).

## Nexo and custom drops

`custom-drops.yml` lets you replace selected crop drops with Nexo or normal items. Leave its `drops` list empty to keep normal farming. The in-game editor includes Custom Drops. See [Nexo items](https://docs.mantic.dev/mantichoes/nexo-items.md) for hoe, menu, drop and prestige examples.
