Skip to content

Translating Slimefun

TheBusyBot edited this page Jun 28, 2022 · 1 revision
Clone this wiki locally

Translating Slimefun has always been a tough point because of some wrong design choices in the code made years ago.
But as of February 2020 all builds feature translations.

Important note: At the moment you can only translate chat messages and certain inventories but not items. Item translations are very difficult to do and will likely still take over a year or even more until this will become a thing. Please do not ask us for translations for items and be patient! Thank you.

Changing your server language

You can change your server's default language by modifying your config.yml:

  language: en

Swap en out for the language code of your desired language. You can find a list of all supported languages further down on this page.
Note that this will override your messages.yml file. If you wish to customize your messages despite the selected language, simply edit your messages.yml after changing your language and restarting the Server. Your messages.yml will only ever be touched if you decide to change the default language of your server again. New additions to the messages.yml will be appended to that file without issues.

Changing your personal language

Every player can choose their preferred language. By default everyone will simply use the server's default language.
But if you have a lot of international players, they can simply override it and use their personally preferred language instead.

To do this, just go to the "Settings" section of your Slimefun Guide (Shift - Right Click the Slimefun Guide while holding it in your hand). There you should see a globe or a flag which allows you to select a language.

Available languages

Note that only languages that are marked as Released can safely be selected on your server.
Unreleased languages are still pending for review or are not fully translated yet.
Development builds of Slimefun may allow a few unreleased languages already.
Do not select unreleased languages as your server's default language.

Contributions are very much welcome!

Released Language language code
:heavy_check_mark: English en
:heavy_check_mark: German de
:heavy_check_mark: French fr
:heavy_check_mark: Italian it
:heavy_check_mark: Spanish es
:x: Polish pl
:heavy_check_mark: Swedish sv
:x: Dutch nl
:heavy_check_mark: Russian ru
:heavy_check_mark: Hungarian hu
:x: Greek el
:heavy_check_mark: Czech cs
:x: Latvian lv
:heavy_check_mark: Slovak sk
:heavy_check_mark: Chinese (China) zh-CN
:heavy_check_mark: Chinese (Taiwan) zh-TW
:x: Portugese (Portugal) pt
:heavy_check_mark: Portugese (Brazil) pt-BR
:heavy_check_mark: Vietnamese vi
:heavy_check_mark: Indonesian id
:x: Hebrew he
:heavy_check_mark: Arabic ar
:x: Danish da
:x: Finnish fi
:x: Norwegian no
:heavy_check_mark: Ukrainian uk
:x: Afrikaans af
:x: Malay ms
:heavy_check_mark: Japanese ja
:x: Persian fa
:heavy_check_mark: Thai th
:heavy_check_mark: Tagalog tl
:x: Romanian ro
:x: Bulgarian bg
:heavy_check_mark: Turkish tr
:heavy_check_mark: Korean ko
:x: Macedonian mk
:x: Croatian hr
:x: Belarusian be

You want to help us translate?

Just click on the language you want to help translate. It will bring you to Crowdin where the different translations of this repository are hosted.

Once you are there, just swap out all the messages for your translations and hit "Create review request" once you are done.
We will then start reviewing your changes and add them to this plugin.

You don't see your language?

If we currently do not support your language, then please go on our discord server (you can find a link on the sidebar or footer of this page).
Just post it in #translations and let us know that you want to help translate this plugin into your language but please don't tag any of our admins, we will see your message nonetheless. But please be patient as it can take some time to handle your request.