# Translations

## Multiple Locales

The plugin supports multiple locales. If you place multiple locale files in the `Language` folder, the locale will depend on the players client locale.

## Downloading Community Translations

1. Community translations can be found in our Discord, by executing the `/translations` command in the Discord server. Your Discord account needs to be verified/linked to a Spigot or Polymart account.
2. If you haven't created a translations account yet, you'll be asked to sign up at the translations page, to start translating and downloading language files.
3. Execute `/link translations` in the Discord server and provide the requested parameters to complete the account setup. If you don't do this, the locale files won't be visiable to you and the page will simply be empty. We require you to link your verified Discord account with the Translation account to prevent unauthorized users griefing the locale files, since we allow community contributions.
4. After linking your Discord account with your Translations account and reloading the translations page, the translations become visible to you. You can view all translations [here](https://translations.incredibleplugins.com/projects).

The default English (en-US) language is already included in the plugin's file and doesn't need to be downloaded.

## Applying Translations

1. Insert the downloaded files into the `/Language` folder, which is located in the plugin folder.
2. If you for example downloaded a file with the name `lands-chat-de.yml` or `lands-gui-de.yml` then set the language to `de` in the plugin's config.yml file:

```yaml
  # Default: English (en-US) - no download required.
  # You can access translations maintained by the community in our Discord: https://discord.gg/B4MAJVk
  # To access translations, other than en-US, execute /translations in the Discord server.
  language: 'de-DE'
```

## Locale File not Applying

If you made changes to the locale files, but they are not visible ingame, then one of these mistakes were made:

* Make sure to reload the locale files: `/<plugin> admin reload` -> For Lands it would be `/lands admin reload`
* Check for any YAML format mistakes that you might have made. You can use any online YAML validator to check that or just check your servers startup log for any errors related to parsing a YAML file. If the file has a YAML format mistake, the plugin automatically falls back to the default English locale.
* You have multiple locale files in the `Language` folder and your client locale doesn't match with the one you want to see. The plugin supports multiple locales and sets the locale depending on the players locale and which locales are placed in the `Language` folder.


---

# 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://wiki.incredibleplugins.com/general/locale-and-config/translations.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.