MCLangSplit
Learning a new language takes consistency, and few hobbies demand as much screen time as Minecraft. MCLangSplit bridges those two worlds by injecting a configurable second language directly into every text string in the game. Instead of memorizing vocabulary lists in isolation, you see translations in context as you mine, craft, and explore. The mod is designed to be purely client-side, so you can use it on any server without installing anything on the backend.
What MCLangSplit Does
At its core, MCLangSplit for Minecraft takes the game's existing text and layers a second language on top of it. Every menu label, item name, tooltip, and chat string becomes a bilingual learning opportunity. This is a far cry from simply switching your game language and losing access to your native tongue. Here, both languages coexist, letting your brain form associations naturally rather than through rote memorization.
The mod includes a hotkey for cycling through language modes, bound to R by default. Pressing it toggles between three states:
- Original — displays only the default game language.
- Alternate — shows only your configured second language.
- Both — presents both languages side by side, ideal for active learning.
This flexibility means you can start with both languages visible, then gradually shift toward the alternate language as your comprehension improves. It is a genuinely thoughtful approach to language acquisition that fits seamlessly into normal gameplay.
Supported Versions and Loaders
MCLangSplit is available for both Fabric and Forge, covering a wide range of Minecraft releases. The 1.x branch supports older versions using TOML configuration, while version 2.x targets Minecraft 1.19.3 and onward, switching to JSON-based configuration. If you are running a modern version of the game, you will be working with the JSON format and can take advantage of Cloth Config integration for a cleaner in-game settings screen.
Configuration in Version 2.x
The shift to JSON brought a more structured approach to configuration. A typical config file looks like this:
- language — the locale code for your second language, such as ja_jp for Japanese.
- ignoreKeys — an array of translation keys to skip entirely.
- includeKeys — an array of keys to force-include even if ignored elsewhere.
- ignoreTooltips — a boolean controlling whether tooltips are left untouched.
- mode — sets the default display mode: ORIGINAL, ALTERNATE, or BOTH.
This granular control lets you fine-tune exactly which parts of the interface receive the second language. If certain menus feel cluttered with dual text, simply add their keys to the ignore list. Conversely, if you want to emphasize specific vocabulary, the include list ensures those strings always appear bilingually.
How to Install MCLangSplit
Getting started is straightforward. First, confirm that you have the correct mod loader installed for your Minecraft version — either Fabric or Forge. Next, download MCLangSplit and place the JAR file into your mods folder, located inside your Minecraft directory. Launch the game with the modded profile, and the mod will generate its configuration file on first run. From there, edit the config to set your target language and preferred display mode, or use the Cloth Config screen if you prefer a graphical interface. Players who want a shortcut can grab MCLangSplit through the foxygame.net launcher, where the add-on catalog handles one-click installation and keeps every mod updated automatically across supported versions.
Who Should Use This Mod
MCLangSplit appeals to a specific but passionate audience. Language learners who already enjoy Minecraft will find it transforms idle playtime into passive study sessions. Teachers and students of Japanese, Spanish, German, or any other supported language can reinforce vocabulary without dedicated flashcards. Even polyglots who simply prefer reading item names in a second language will appreciate the seamless toggle.
Because the mod is client-side only, there is no risk of server incompatibility. You can join any multiplayer world, and the translations remain entirely on your end. This also means you can experiment freely without affecting other players.
Final Thoughts
MCLangSplit is a clever, lightweight tool that turns one of the world's most popular games into a language learning environment. With flexible configuration, multiple display modes, and support for both Fabric and Forge across numerous Minecraft versions, it removes the friction from bilingual gameplay. Whether you are just starting out or refining fluency, this mod makes every session a small step forward.