TRX/GeyserWebsite
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Documentation for adding custom/modifying Java language strings (#232)

Browse Source 
* Yeet the translations section from the faq in favor of a dedicated page
Document java language string overrides & additions

* Address review by @Chew

* Update _docs/geyser/translations.md

Co-authored-by: Olivia <chew@chew.pw>

---------

Co-authored-by: Olivia <chew@chew.pw>
This commit is contained in:
chrisandOlivia authored and GitHub committed 2023-12-12 00:20:35 +01:00
1 parent 76c967f4ab
commit 89bdc845f2
3 files changed
+76 -58
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

_data/faq.yml
-58
View File
@@ -194,64 +194,6 @@
**(Please note, if you are using a prefix with Floodgate, Bedrock players will have to enter the prefix.)**
- title: What languages does Geyser support?
content: |
We aim to support any of the bedrock languages; see [here](https://translate.geysermc.org/) for our Crowdin page, and below is a list of all the language codes. We also can add support for more languages, and please request them in the Discord server if you are willing to translate them. (Enabled clientside via [https://www.curseforge.com/minecraft/mc-addons/translations-for-minecraft](https://www.curseforge.com/minecraft/mc-addons/translations-for-minecraft))
### Bedrock languages
|Name |Code |
|----------------------------|-----|
|Bulgarian |bg_bg|
|Czech |cs_cz|
|Danish |da_dk|
|German |de_de|
|Greek |el_gr|
|British English |en_gb|
|American English |en_us|
|Spanish |es_es|
|Mexican Spanish |es_mx|
|Finnish |fi_fi|
|Canadian French |fr_ca|
|French |fr_fr|
|Hungarian |hu_hu|
|Indonesian |id_id|
|Italian |it_it|
|Japanese |ja_jp|
|Korean |ko_kr|
|Dutch |nl_nl|
|Norwegian Bokmål |nb_no|
|Polish |pl_pl|
|Brazilian Portuguese |pt_br|
|Portuguese |pt_pt|
|Russian |ru_ru|
|Slovak |sk_sk|
|Swedish |sv_se|
|Turkish |tr_tr|
|Ukrainian |uk_ua|
|Chinese Simplified (China) |zh_cn|
|Chinese Traditional (Taiwan)|zh_tw|
### Additional languages
|Name |Code |
|----------------------------|-----|
|Afrikaans |af_za|
|Belarusian |be_by|
|Hebrew |he_il|
|Hindi |hi_in|
- title: Adding custom Geyser translation overrides
content: |
Please note that you cannot add strings that work in Minecraft formatting - these strings are only for places where Geyser uses them.
To start, create a `languages` folder in the same directory as the Geyser config file.
Inside of it, you'll need to add a file with your desired locale ending in `.properties`. You can see
[here](https://github.com/GeyserMC/languages/tree/master/texts) for the locale files that Geyser uses -
you can download these as a starting point, or you can just add the strings you want to overwrite.
You must restart Geyser for the changes to apply.
- title: Questions not related to gameplay
items:
- title: What is the relationship between CubeCraft and Geyser?
_data/toc.yml
+2
View File
@@ -22,6 +22,8 @@
children:
- title: Commands
url: "geyser/commands/"
- title: Languages and Translations
url: "geyser/translations/"
- title: Geyser Command Line Arguments and System Properties
url: "geyser/geyser-command-line-arguments-and-system-properties/"
- title: FAQ
_docs/geyser/translations.md
+74
View File
@@ -0,0 +1,74 @@
---
title: Supported languages & translations
---
Geyser supports a wide variety of languages to offer the best experience for players all over the globe.
When players join your server, Geyser will automatically detect their locale and provide the appropriate language.
## What languages are supported?
We aim to support any of the Bedrock languages - below is a list of them and all the language codes.
|Name |Code |
|----------------------------|-----|
|Bulgarian |bg_bg|
|Czech |cs_cz|
|Danish |da_dk|
|German |de_de|
|Greek |el_gr|
|British English |en_gb|
|American English |en_us|
|Spanish |es_es|
|Mexican Spanish |es_mx|
|Finnish |fi_fi|
|Canadian French |fr_ca|
|French |fr_fr|
|Hungarian |hu_hu|
|Indonesian |id_id|
|Italian |it_it|
|Japanese |ja_jp|
|Korean |ko_kr|
|Dutch |nl_nl|
|Norwegian Bokmål |nb_no|
|Polish |pl_pl|
|Brazilian Portuguese |pt_br|
|Portuguese |pt_pt|
|Russian |ru_ru|
|Slovak |sk_sk|
|Swedish |sv_se|
|Turkish |tr_tr|
|Ukrainian |uk_ua|
|Chinese Simplified (China) |zh_cn|
|Chinese Traditional (Taiwan)|zh_tw|
### Additional languages
These languages are also supported, and are available in the Bedrock client using [the Translations for Minecraft resource pack](https://www.curseforge.com/minecraft-bedrock/addons/translations-for-minecraft).
|Name |Code |
|----------------------------|-----|
|Afrikaans |af_za|
|Belarusian |be_by|
|Hebrew |he_il|
|Hindi |hi_in|
## How can I help translate Geyser?
We use [Crowdin](https://crowdin.com/project/geyser) to manage our translations.
We also can add support for more languages, and please request them in the Discord server if you are willing to translate them.
(Those can be enabled clientside via [https://www.curseforge.com/minecraft-bedrock/addons/translations-for-minecraft](https://www.curseforge.com/minecraft-bedrock/addons/translations-for-minecraft))
## Adding custom Geyser translation overrides
These strings are only for places where Geyser uses them. To edit Minecraft Java translations, see the section below.
To start, create a `languages` folder in the same directory as the Geyser config file.
Inside of it, you'll need to add a file with your desired locale ending in `.properties`. You can see
[here](https://github.com/GeyserMC/languages/tree/master/texts) for the locale files that Geyser uses -
you can download these as a starting point, or you can just add the strings you want to overwrite.
You must restart Geyser for the changes to apply.
## Modifying/Adding Minecraft Java translations
Geyser also downloads the Minecraft Java translations from Mojang's servers and sends them to Bedrock clients when needed.
To modify these, open the `overrides` subfolder in the `locales` folder. Then, place your modified `.json` files in the `overrides` folder.
You can also add custom Java translation strings to that json file.
Note: You do not need to provide the entire file, only the Java strings you want to change/add. Geyser will only update the strings you provide.
You must restart Geyser for the changes to apply.