Skip to content

Latest commit

 

History

History
141 lines (105 loc) · 10 KB

language-support.md

File metadata and controls

141 lines (105 loc) · 10 KB
Raw

Language support

You can translate the mods themselves and the modpack-specific content. All modpack-specific translations are licensed under CC0, meaning they can be freely copied, modified, republished and so on.

Mods

I support people using Minecraft in their language and would like to promote that in the modpack too. However, this is a pack of mods, so if you want to translate the entire pack, you should translate its mods as well.

  1. Check out the list of mods and click the name of the mod you want to translate
  2. On every page, find the Issues or Source link at the top
  3. Read the readme, wiki and/or issues to see if there is already a translation platform. If yes, go there.
  4. If not, go to Code tab and browse the folders in order: src → main → resources → assets → (mod's name) → lang → en_us.json
  5. Open the file and copy its full text
  6. Go back to lang folder, click Add file → Create new file
  7. You'll fork the project and have a new file window open. Name the file in the format locale_code.json, such as et_ee.json. In-game locale codes can be found here
  8. Paste the text you copied and start translating the values on the right, e.g. in the example below you only replace the Coolmod Options text:
    • "coolmod.config.title": "Coolmod Options",
  9. Commit the file and create a pull request. If you're lucky, the mod author accepts it
  10. If the language has been accepted, wait for the mod author to update their mod on CurseForge
  11. Once the mod has been updated on CurseForge, simply wait for the next Fabulously Optimized update to see it :P

Notable mods to translate

List of mods that contribute the most viewed phrases in the modpack, click to get to their English language file/translation platform.

  1. Sodium (unofficial, but bundled in FO)
  2. Sodium Extra
  3. Iris Shaders
  4. MoreCulling (appears in Video Settings)
  5. Mod Menu
  6. Controlify
  7. Fabric API/Installer
  8. Zoomify
  9. Fabric Capes
  10. Continuity
  11. CIT Resewn

Modpack

Fabulously Optimized is translated on Crowdin. Here are the steps:

  1. Join the Fabulously Optimized project
  2. Start translating the file you prefer. The files are listed in the order of priority.
    • You can vote for existing suggestions with ➕ and ➖ buttons
    • In the comments you can discuss the specific phrase, ask for more info, report wrong translations etc.
    • File-specific tips and requirements are listed below
  3. Join our Discord for a yellow rank and a possibility to become a proofreader in your language.
    • Yellow rank requirement is translating any file to 100%; it also gives you access to some hidden channels ;)
  4. As a proofreader, read over every string, test MMH in-game and approve ✔️ everything that looks correct. Any file must be 100% approved before it gets pushed to FO.
    • For example, if you fully translate two files but fully approve one, then only the fully approved file will be published at the moment.
  5. Wait for the next release of FO to see your translations live!
  6. You'll get an email and/or Discord notification when there are new phrases to translate. Then just repeat from step 3!

Mod Menu Helper

Bundled resource pack "Mod Menu Helper" shortly describes each mod's purpose and available options.

  • The phrases have very specific length requirements, so you must test them after translating with the instructions below.
    • The lines must be fully visible in a maximised Full HD (1920×1080) screen using the default font. If your language uses the Unicode font by default, consider that instead.
    • There is an online tool that helps you assume how long the string might be, but it is not 100% accurate.
    • If you don't have a Full HD display, you can also emulate it in-game: Options... → Video Settings... → Fullscreen Resolution: 1920x1080@60 (24 bit) → Fullscreen: 🔲 → Apply → Done
      • If you get any issues, press Shift + P within the video settings, to get the vanilla video settings and revert fullscreen options there.
      • The numbers after @ may vary.
  • Feel free to rephrase the sentences to make them more understandable and/or shorter for your language. In the options row, list as many options as you can fit.
  • Keep paragraph sign (§), tools emoji (⚒️), arrows emoji (🔀) and newlines as they are on the original.

Testing tutorial

  1. Select your language on Crowdin
  2. Select Mod Menu Helper
  3. Click ≡ on the left, then Download. You'll get a file in the format language_code.json.
    • Is the button grayed out? Make sure you're browsing "Mod Menu Helper", not "all strings".
  4. Run Fabulously Optimized
  5. Go to Options... → Resource Packs... → Open Pack Folder
  6. Open Mod Menu Helper.zip → assets → fo → lang
    • On macOS, opening the ZIP will create a new folder, so open that one.
  7. Drag the file you downloaded into the archive
  8. Go back to the game, Done → Done
    • On macOS, activate the Mod Menu Helper (without .zip) resource pack first.
  9. Play any world or server
  10. Hold down F3 and press T
  11. Press Esc → Mods. Look around and make sure everything fits.
    • Use maximized window or fullscreen, Full HD (1920×1080) screen, GUI scale 3, default font.
  12. Press Back → Options... → Resource Packs.... Look around and make sure everything fits.
  13. If not everything fits yet, change the translation on Crowdin and repeat from step 3.

Chat Reporting Helper

Bundled resource pack "Chat Reporting Helper" simplifies some vanilla and No Chat Reports phrases to make chat reporting availability and interactions easier to understand.

  • In-game testing is needed only for the resource pack description - use MMH's instructions.
  • Some phrases refer to similar vanilla or No Chat Reports' phrases. Read the phrase descriptions for instructions.
  • Untranslated languages use the original phrases instead of Chat Reporting Helper's, so your translation helps improve the consistency by a lot!
  • For a more complete translation, you might also want to translate No Chat Reports.

Fast Better Grass

Bundled resource pack "Fast Better Grass" imitates the OptiFine's Better Grass' "fast mode".

  • The resource pack description is translated within Mod Menu Helper, to keep the original pack small and simple.

Sodium

Unofficial resource pack that adds translations to Sodium. Managed by the creator of Fabulously Optimized and the creator of Sodium Extra, but is an independent project.

  • Translated on Crowdin
  • Translations are published every Saturday, so any FO version to come after that will get it.
  • Translations do not require approval to be published, however proofreading would still be preferred to ensure quality.
  • You are more likely to be accepted as a proofreader if you have previous translation work on FO or other Minecraft-related projects.

Installer

It is possible to translate most messages on the installer, except for some very detailed errors.

  • Translation testing is currently not easy and therefore not required, just check the context and ask questions if needed.
  • The language of the installer is determined by the operating system, but changeable in the top left corner.

Website

The new website is almost entirely localizable.

  • Translation testing is not required, but recommended. Currently possible only for proofreaders, read below.
  • Keep the format as-is, e.g. if the original says [Hello world][1], then you must only translate "Hello world" while keeping the square brackets as they are.
  • The language of the website is determined by the browser, but can be overridden on the menu in top right corner.

Testing tutorial

  1. Translate and approve to 100% on FO Crowdin's folder "Website"
  2. Go to the website's GitHub and click on "New Crowdin updates" pull request
    • Can't see it? Ensure your translation is 100% approved and try again later.
  3. Scroll down to find a comment by the user vercel. Click Visit Preview on that comment.
  4. Ensure the site is in translated language and click around to see your translation as it would appear live.
  5. If needed, adjust your translation and repeat from step 2.

Listing description

New translations are not accepted - please translate the website instead.

Wiki

The wiki is not accepting translations because there are too many pages to translate and the translations get outdated very fast.