🌍 Language System

CustomAchievements1653 includes a powerful multi language system with 21 pre installed translations.

---

Changing the Language

Open config.yml and set the language option:

language: de_DE

Then reload with /ca reload.

---

Available Languages

Flag	Code	Language
🇬🇧	en_US	English
🇩🇪	de_DE	German
🇳🇱	nl_NL	Dutch
🇪🇸	es_ES	Spanish
🇫🇷	fr_FR	French
🇧🇷	pt_BR	Portuguese (Brazil)
🇸🇦	ar_SA	Arabic
🇨🇿	cs_CZ	Czech
🇹🇷	tr_TR	Turkish
🇵🇱	pl_PL	Polish
🇷🇺	ru_RU	Russian
🇮🇹	it_IT	Italian
🇰🇷	ko_KR	Korean
🇭🇺	hu_HU	Hungarian
🇯🇵	ja_JP	Japanese
🇨🇳	zh_CN	Chinese (Simplified)
🇻🇳	vi_VN	Vietnamese
🇸🇪	sv_SE	Swedish
🇸🇰	sk_SK	Slovak
🇮🇳	hi_IN	Hindi
🇮🇩	id_ID	Indonesian

---

Creating Custom Languages

You can create your own language file:

1. Copy an existing language file in plugins/CustomAchievements1653/lang/

2. Rename it (e.g., my_custom.yml)

3. Translate all values

4. Set in config.yml:

language: my_custom

1. Reload with /ca reload

---

Message Format Modes

The plugin supports two message formatting systems:

Legacy Mode (default)

message-format: LEGACY

Uses traditional Minecraft color codes:

• &a = green, &c = red, &6 = gold, &l = bold

• &#FF5555 = hex colors

MiniMessage Mode

message-format: MINI_MESSAGE

Uses modern Adventure MiniMessage tags:

• <red>, <green>, <gold>, <bold>

• <gradient:red:blue>Text</gradient>

• <rainbow>Text</rainbow>

• <click:run_command:/ca gui>Click me!</click>

• <hover:show_text:'Hello!'>Hover me!</hover>

Note: When switching to MiniMessage mode, your language file values should also use MiniMessage syntax instead of & codes.

---

Automatic Language Migration

When the plugin is updated and new message keys are added:

• New keys are automatically added to your language files

• Your existing translations are never overwritten

• Missing keys are filled with the English default

This means you never lose your custom translations after an update.

---

Placeholders in Messages

All messages support these placeholders:

Placeholder	Description
%player%	Player name
%advancement%	Advancement display name
%category%	Category name
%progress%	Current progress count
%target%	Target amount
%percentage%	Progress percentage
%description%	Advancement description
%completed_date%	Completion date
%rewards%	Rewards list
%label%	Command label used
%subcommand%	Subcommand name

---