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

# Configuration

`plugins/EdLang/config.yml` explains every option in its comments. Overview:

| Section                                             |                                                                                                                                  |
| --------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| `default-language`                                  | For console, offline players and anyone nothing else matched.                                                                    |
| `placeholders`                                      | The short form `{lang:...}` and its word; how values are read (`value-format: auto\|legacy\|minimessage`).                       |
| `packets`                                           | The [packet translator](/p/edlang/features/packet-translator.md): each kind of text on or off, creative mode, refresh on change. |
| `protect-player-input`                              | Players can't type placeholders in chat, commands, signs, books, anvils.                                                         |
| `placeholderapi`                                    | Whether `%lang_key%` is filled in by PlaceholderAPI ([details](/p/edlang/features/placeholderapi.md)).                           |
| `detection`, `geoip`, `countries`, `client-locales` | [Language detection](/p/edlang/features/language-detection.md).                                                                  |
| `ask-on-first-join`                                 | The first-join picker.                                                                                                           |
| `change-cooldown-seconds`                           | Time between two language changes of one player.                                                                                 |
| `menu`                                              | Menus on or off, and which provider ([Menus](/p/edlang/features/menus.md)).                                                      |
| `chat-translation`                                  | [Chat translation](/p/edlang/features/chat-translation.md).                                                                      |
| `storage`                                           | [YAML or MySQL](/p/edlang/features/storage.md).                                                                                  |
| `text-matching`                                     | EdLang 1's matching of already-translated texts.                                                                                 |

`/edlang reload` applies every change except `storage.type` (restart).

config.yml is kept up to date by EdLang: when an update adds options, they are added to your file with their defaults, and nothing you set is changed. A config from EdLang 1 is upgraded once (see [Upgrading](/p/edlang/getting-started/upgrading.md)).

Messages and menu texts are not in config.yml: they are keys of `lang/<code>/edlang.yml`, so they are shown in each player's language. Set a message to `''` to turn it off.