YAML Check: config.yml Error Finder

Paste your plugin's config.yml; see tab, indentation, quote and & color code errors with line numbers, and fix them in one click.

The file never leaves your computer; the check is done entirely in your browser.

Why does config.yml break?

Almost all Minecraft plugins store their settings in YAML files. YAML is very sensitive to indentation: a single tab character or one missing space can make the whole file unreadable. When that happens, the plugin either doesn't start or resets its settings to defaults; in the console you see a long error starting with InvalidConfigurationException or while scanning.

Most common mistakes

  • Tab character: In YAML, indentation is done only with spaces. The tool finds tabs and converts them to 2 spaces.
  • A value starting with &: prefix: &aVIP is wrong, because YAML reads the & sign as a special character. The correct form is prefix: '&aVIP'.
  • Unclosed quote: Text starting with ' must end with '. If there is an apostrophe in the text, write it twice: 'Player''s house'.
  • Curly quotes: YAML doesn't recognize the “ ” ‘ ’ quotes copied from Word or a phone; the tool converts them to straight quotes.
  • Space after the colon: It must be written key: value, not key:value.
  • The same key twice: If a key is written twice in the same section, YAML treats it as an error.

When preparing your colored messages use the Colored Text / Gradient tool, and if a plugin won't start use the Log / Crash Analysis tool.

Guides related to this tool

Frequently Asked Questions

Why does config.yml give an error?

The most common causes: a tab character in the indentation, missing or extra spaces, an unclosed quote, unquoted values starting with &, and no space after a colon (:). The tool shows them all with line numbers.

Why must color-coded text be in quotes?

In YAML, the & sign has a special meaning (anchor). If you write prefix: &aVIP, YAML reads it as an empty value and the prefix is lost. The correct way is to put it in quotes: prefix: '&aVIP'.

How many spaces should indentation be in YAML?

YAML accepts any number of spaces but lines at the same level must be aligned. Minecraft plugins usually use 2 spaces. Tab characters can never be used.

Is my file sent anywhere?

No, the check is done in your browser. You can safely check files containing information such as database passwords too.

Other Minecraft Server Tools

Is your server ready? Add your server to the list, collect votes and automatically reward your players. All tools →