# Language System

#

Built-in Languages

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

#

Creating Custom Languages

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

#

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}