> 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/manticswords/config-files.md).

# Config Files

Where ManticSwords stores its settings and how to edit them.

ManticSwords creates these files under `plugins/ManticSwords/` on startup. YAML keys use lowercase words separated by hyphens. Back up the folder before major edits.

| File                                                                       | What it controls                                                                                       |
| -------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| [config.yml](/manticswords/config-files/config.yml.md)                     | General behavior, economy providers, captchas, payouts, and player controls.                           |
| [commands.yml](/manticswords/config-files/commands.yml.md)                 | Command names and aliases; changes require a full restart.                                             |
| [messages.yml](/manticswords/config-files/messages.yml.md)                 | Player-facing messages and command help.                                                               |
| [enchants.yml](/manticswords/config-files/enchants.yml.md)                 | Enchant chances, levels, rewards, and command dispatch.                                                |
| `drops.yml`                                                                | Extra drops by mob type.                                                                               |
| [custom-drops.yml](/manticswords/config-files/custom-drops.yml.md)         | Replace selected mob drops with Nexo, Oraxen, ItemsAdder or normal items.                              |
| [mob-swords.yml](/manticswords/config-files/mob-swords.yml.md)             | Sword types, appearance, mob and world restrictions, and enchant settings.                             |
| [override-prices.yml](/manticswords/config-files/override-prices.yml.md)   | Item sale-price overrides and ShopGUIPlus redirects.                                                   |
| [prestige.yml](/manticswords/config-files/prestige.yml.md)                 | Prestige requirements, restrictions, and rewards.                                                      |
| [mobslaying-event.yml](/manticswords/config-files/mobslaying-event.yml.md) | Event timing, eligibility, schedules, and rewards.                                                     |
| [Menu files](/manticswords/config-files/menus.md)                          | Main, upgrade, crystal shop, leaderboard, mob prices, prestige, disenchant, and player settings menus. |

Configuration from older versions is converted to YAML on first start, with the originals kept in `old-files/`. After that, the YAML files are the ones that are read.

Use `/manticsword editor` for general settings, commands, messages, enchantments, drops, swords, upgrades, prestige, the event, price overrides, the crystal shop and the disenchant menu. The editor saves and reloads each change. Other menu files can be edited directly.

For manual edits, run `/manticsword reload`. Restart the server after changing command names or aliases. `enchant-list.txt` is generated for reference and should not be edited.