A minecraft mod for automatic chat message translation between players using Google Translate and DeepL.
Note
LinguaChat makes your communication in Minecraft accessible in any language, automatically translating chat messages without interrupting gameplay!
- Real-time message translation
- Support for two translation services: Google Translate and DeepL
- Customizable source and target languages
- Separate settings for incoming and outgoing messages
- Preservation of original text (available on hover)
- Automatic language detection
- Tooltip support for viewing original text
- Make sure you have Minecraft with Fabric Loader 0.16.10 or newer for game version 1.21.4
- Download the latest version of the mod from the releases section
- Place the JAR file in the
modsfolder of your Minecraft client - Launch Minecraft with the Fabric profile
The mod can be configured through the linguachat.json file in the config directory of your Minecraft client. Available settings:
{
"enabled": true,
"translateIncoming": true,
"translateOutgoing": true,
"defaultSourceLang": "auto",
"defaultTargetLang": "ru",
"preferredTranslator": "google",
"deeplApiKey": ""
}| Parameter | Description |
|---|---|
enabled |
Enable/disable mod features |
translateIncoming |
Whether to translate incoming messages from other players |
translateOutgoing |
Whether to translate outgoing messages to a common language (usually English) |
defaultSourceLang |
Default language for outgoing messages (recommended "auto" for auto-detection) |
defaultTargetLang |
Language for translating incoming messages |
preferredTranslator |
Preferred translation service ("google" or "deepl") |
deeplApiKey |
Your API key for DeepL (if you use DeepL) |
Commonly used language codes:
- English:
en(oren-USfor American English,en-GBfor British English) - Russian:
ru - Spanish:
es - French:
fr - German:
de - Italian:
it - Japanese:
ja - Chinese (Simplified):
zh
- No API key required
- Supports a wide range of languages
- Free to use (with some limitations)
- Used by default
- Requires an API key
- Usually provides higher quality translations
- Supports fewer languages but with better accuracy
- Get your API key at DeepL website
When properly configured, the mod automatically translates messages:
Player1: привет
[Chat for you]: hello
Player2: hello
[Chat for you]: привет
Tip
The original message text is available when hovering over the translated message!
- Minecraft 1.21.4
- Fabric Loader 0.16.10 or newer
- Java 17 or higher
- Internet connection for translation services
- DeepL API key (optional, only if you use DeepL)
Important
If you encounter problems with the mod, check the following points:
-
If translation doesn't work:
- Check your internet connection
- Make sure your DeepL API key is correct (if using DeepL)
- Check game logs for error messages
-
If messages aren't being translated:
- Make sure language codes in the configuration file are set correctly
- Verify that the translation service is properly configured
- Check that the translation direction is set correctly
-
DeepL API problems:
- In settings, use
"defaultSourceLang": "auto"for language auto-detection - Check that your API key is valid and hasn't expired
- Be aware of the limitations of the free DeepL plan
- In settings, use
Warning
When using older versions of the DeepL API, errors may occur with the source_lang parameter when set to "auto". We recommend updating to the latest version of the mod.
Check the logs for messages (provided “debugMode”: true is enabled in the linguachat.json configuration file):
!!! MIXIN ChatHudMixin LOADED !!!- confirms that the mixin is loadedConverting language for DeepL- tracks language code conversionDeepL translation: ... -> ...- confirms successful translation via DeepL
- Fixed an issue with DeepL API where the
source_langparameter with "auto" value caused an error - Updated DeepL API library to version 1.9.0
- Improved error handling and logging
- Added additional language aliases for more convenient use
If you have problems or questions:
- Check the issues section on GitHub
- Create a new issue with detailed information about your problem
- Attach your configuration file and latest.log when reporting issues
Made with ❤️ for the Minecraft community. Happy gaming and pleasant communication in any language! 🎮 💬