Skip to content

Instantly share code, notes, and snippets.

@The-Fireplace

The-Fireplace/MAKING_TRANSLATIONS.md

Last active July 6, 2022 02:01
Show Gist options
  • Star 0 You must be signed in to star a gist
  • Fork 0 You must be signed in to fork a gist
  • Save The-Fireplace/e79e5a6de337e7bb208b2d84462c1ecf to your computer and use it in GitHub Desktop.
Save The-Fireplace/e79e5a6de337e7bb208b2d84462c1ecf to your computer and use it in GitHub Desktop.
Download ZIP
A Guide to Making Minecraft Mod Translations
Raw
MAKING_TRANSLATIONS.md

  1. Make a GitHub account if you don't have one yet.

  2. Make a fork of the mod you want to translate. My mods can be found here

  3. Browse to src/main/resources/assets/<modid>/lang on your fork of the repository (On modern ports of some of my mods, it will be at common/src/main/resources/assets/<modid>/lang). There, you can see what translations already exist.

  4. If the language you want to translate to isn't there, you'll want to make a new file to put those translations in. See the Locale Code column on this page for the name of the file, and for the extension (.lang or .json), look at the other file names to see which it should be. Generally, mods for 1.12.2 and earlier use .lang and mods for 1.13 and newer use .json.

  5. If you just made your lang file, getting all the translations copied in so you can edit them is as simple as opening a new tab and going to that mod's en_us lang/json file and copying all of that into your new file so it can be edited. If the translation file already exists and just needs to be updated, there are a few ways you can get the untranslated strings in to the file so you can translate them.

  6. If the files are in the json format, you can copy them into an online json diff tool For example: The green line on the left shows that there's a translation that isn't in the file on the right.

  7. Tools that can compare lang files aren't quite as smart since it isn't a common format, but it is possible. I recommend using an online ini diff tool. In this example, the line on the left is entirely the darker red if the translation doesn't exist and only partially darker red if it exists.

  8. Once the translations are made, it's time to make a Pull Request, which is what allows them to be added to the mod's code. Once that's made, the author can review and either request changes, merge them, or deny the request. Once your changes are merged, you can delete your fork of the mod.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment