# :icon-globe: Language System

* * *

#### 

**Built-in Languages**

| File | Language |
|------|----------|
| `en.yml` | English (default) |
| `fr.yml` | French |

* * *

#### 

**Creating Custom Languages**

1. Copy `en.yml` or `fr.yml` as a template
2. Rename to your language code (e.g., `es.yml` for Spanish)
3. Translate all message values (not the keys)
4. Set `language: 'es'` in `config.yml`
5. Restart the server

* * *

#### 

!!!warning **Critical GUI Titles**
The following titles MUST remain in English to prevent GUI breakage:

```
gui.main-title: "&8Premium Advancements"
gui.create-title: "&8Create Advancement"
gui.edit-title: "&8Edit: {title}"
gui.confirm-delete-title: "&cConfirm Delete"
gui.stats-title: "&8Stats: {player}"
```
!!!

* * *

#### 

**Language File Structure**

| Section | Purpose |
|---------|---------|
| `prefix` | Plugin prefix for all messages |
| `gui.*` | All GUI messages, buttons, lore, descriptions |
| `stats.*` | Stats GUI messages |
| `creation.*` | Creation/Edit GUI messages |
| `delete.*` | Delete confirmation messages |
| `input.*` | Chat input prompts for all 30+ fields |
| `worlds.*` | World management messages |
| `progression.*` | Action bar display format |
| `rewards.*` | Reward notification messages |
| `messages.*` | All success/error/command feedback |
| `help.*` | Command help menu text |
| `hidden.*` | Hidden advancement unlock notifications |

* * *

#### 

**Placeholders in Language Strings**

Language strings support the following placeholders for dynamic values:

`{player}`, `{title}`, `{description}`, `{trigger}`, `{id}`, `{block}`, `{item}`, `{entity}`, `{amount}`, `{current}`, `{required}`, `{total}`, `{count}`, `{page}`, `{world}`, `{worlds}`, `{cmd}`, `{enchant}`, `{level}`, `{dimension}`, `{mode}`, `{distance}`, `{profession}`, `{effect}`, `{cause}`, `{color}`, `{filter}`, `{permission}`, `{input}`, `{output}`, `{sound}`, `{volume}`, `{pitch}`, `{frame}`, `{position}`, `{time}`, `{progress}`, `{percent}`, `{files}`, `{command}`