Translations

Translations

SoundTweaks ships with built-in translations for 19 languages. The game automatically uses the correct translation based on your in-game language setting — no extra setup needed.

---

Supported languages

Flag	Language	Locale code
	English (US) — base language	en_us
	German	de_de
	Spanish (Spain)	es_es
	Spanish (Mexico)	es_mx
	French	fr_fr
	Indonesian	id_id
	Italian	it_it
	Japanese	ja_jp
	Korean	ko_kr
	Dutch	nl_nl
	Polish	pl_pl
	Portuguese (Brazil)	pt_br
	Portuguese (Portugal)	pt_pt
	Russian	ru_ru
	Turkish	tr_tr
	Ukrainian	uk_ua
	Chinese (Simplified)	zh_cn
	Chinese (Traditional)	zh_tw
🏴‍☠️	Pirate English	en_pt

---

Contributing a translation

Translation files are plain JSON located at:

src/main/resources/assets/soundtweaks/lang/<locale>.json

Each key maps a translation key to its localised string. The en_us.json file is the reference — all keys in that file should be present in every other translation.

To add or improve a translation:

1. Fork the repository
2. Copy en_us.json into a new file named <locale>.json (using the standard Minecraft locale code)
3. Translate each value — do not change the keys
4. Open a pull request against the 26.1.2 branch

If your language is already listed above but has missing or incorrect strings, the same process applies — just edit the existing file.