> For the complete documentation index, see [llms.txt](https://miulien.gitbook.io/bot/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://miulien.gitbook.io/bot/en/other/language.md).

# Language Settings (language)

Miulien supports **Traditional Chinese (zh-TW)** and **English (en-US)**. Run `/language` or `m!language` to inspect the current reply language, the source of that preference, and the available settings.

## 🌐 Personal language

Use **`/language user`** to choose:

| Option                      | Effect                                                                  |
| --------------------------- | ----------------------------------------------------------------------- |
| Traditional Chinese (zh-TW) | Always display **your** Miulien replies in Traditional Chinese          |
| English (en-US)             | Always display **your** Miulien replies in English                      |
| Automatic (auto)            | Clear your personal override and inherit the server or Discord language |

Your preference applies to **your own replies** and does not change other members' choices.

## 🏠 Server default language

Members with **Manage Server** permission may run **`/language server`** to select the default language for that server. Choosing **auto** clears its explicit preference.

Server defaults apply only when a user has **not** set a personal preference. Any member can override the server default with `/language user`.

## 🔀 Language resolution order

Miulien chooses a reply language in this priority order:

1. Explicit **user** preference
2. Explicit **server** preference
3. User's **Discord client language**
4. Discord **server language**, if the client language is not recognized
5. **Traditional Chinese** fallback

For example, if a server defaults to English but you explicitly choose Traditional Chinese, **your replies remain in Chinese**. Choosing personal `auto` would inherit the server's English setting instead.

## 📝 Why do command menus and bot replies use different languages?

**Discord's interface language** and **Miulien's reply language** are separate settings:

* **Slash-command names, option names, and descriptions** follow your Discord client's interface language and the command's registered localizations.
* **Miulien replies, game content, and interactive panels** follow the user/server/automatic preference order described above.

For example, if your Discord interface is in Traditional Chinese but you select English with `/language user`, the command menu may remain in Chinese while Miulien's responses appear in English. The reverse can happen too.

For a more consistent experience, set your **Discord interface language** and **Miulien language preference** to the same language. With `auto`, remember that an explicit server default may still take priority.

A difference between the command menu and replies is not necessarily a translation bug. However, untranslated text, mixed languages **within a reply or panel**, or unnatural translations can still be reported.

## ⌨️ Command reference

| Command            | Purpose                                     |
| ------------------ | ------------------------------------------- |
| `/language`        | View current reply language and its source  |
| `/language user`   | Set your own language                       |
| `/language server` | Set server default (requires Manage Server) |

The `language` group also supports `m!` prefix commands. Discord's **slash-command menu localization** follows the Discord client's language and registered localization metadata, **not** the user's Miulien reply-language setting.

> Switching the language of this GitBook documentation is **independent of** the bot's `/language` settings.
