• Translate chat messages in real-time.
• Configurable translation behavior via in-game commands.
• Supports multiple languages.
• Supports Forge and Fabric.
• Free. No need for api-key, as the translator runs locally.

• Minecraft 1.21.1
• Mod loader (fabric or forge)
• Python >= 3.8.x installed and accessible in PATH
  • Download Python

1. Place the jar file into your mods folder.
2. Launch Minecraft with Forge/Fabric 1.21.1.
3. How to test it out in-game:
   • /livetranslator on (This will set up the environment for the translator, download the translation model (~470 MB), and turn on the translator.)
   • type @de Good morning!
   • What you see in chat: [de] <Player> Good morning!
   • When you hover over the text: Guten Morgen!
   • What others see: <Player> Guten Morgen!

LiveTranslator uses local translation, meaning translations run directly on your computer instead of being sent to an online service.

LiveTranslator behaves differently depending on where it is installed.

Recommended setup

• Singleplayer / Multiplayer servers you don’t control
  → Install client-side only

• Dedicated servers you control
  → Install server-side only

Support for running the mod on both the client and server at the same time may improve in future versions.

Base Command (shared between client and server)

/livetranslator # Displays the current status of the translator.

/livetranslator on # Turns the translator on
/livetranslator off # Turns the translator off

Client-side Commands

Incoming Translation (messages you receive)

/livetranslator incomingTranslation # Show incoming translation status
/livetranslator incomingTranslation on # Enable incoming translation
/livetranslator incomingTranslation off # Disable incoming translation
/livetranslator incomingTranslation setLanguage <lang> # Set target language (e.g., en, es)

Outgoing Translation (messages you send)

/livetranslator outgoingTranslation # Show outgoing translation status
/livetranslator outgoingTranslation on # Enable outgoing translation
/livetranslator outgoingTranslation off # Disable outgoing translation
/livetranslator outgoingTranslation setLanguage <lang> # Set target language
/livetranslator outgoingTranslation useIncomingTranslationLanguageAsSource on # Use incoming language as source
/livetranslator outgoingTranslation useIncomingTranslationLanguageAsSource off # Auto-detect source language
/livetranslator outgoingTranslation shortcut on|off # Example, type "@de Good monring!" -> gets translated to German

Model

/livetranslator model # Shows you the available models, the current model is blue
/livetranslator model switch <model> # Switch to another model (currently there is only 1 model)

Server-side Commands

/livetranslator language # Shows the player's language
/livetranslator language <lang> # Sets the target language for the player

/livetranslator translations # Shows if the player receives translations
/livetranslator translations on # Enables translations for the player
/livetranslator translations off # Disabled translations for the player

LiveTranslator uses a quantized m2m100_418M model (int8) developed by facebook.

• The model supports many languages (over 100+).
• It is downloaded automatically the first time you enable the translator.
• The download size is approximately 470 MB.
• The model is stored locally on your system, at:
  • Windows: %USERPROFILE%.local\share\minecraft_livetranslator_mod
  • Mac/Linux: ~/.local/share/minecraft_livetranslator_mod
• Once installed, no internet connection is needed to translate messages.

• Async translation (if possible)
• Feature, to translate previous messages, if translator was off
• Add config file
  • Python path
  • Internal server port?
  • Models path
  • Auto start translator
• Add version number in-game
• Add command to manually translate text
• Add support (if possible) to translate text, even if it's modified by server plugins
• Add lang suggestion to server
• Add feedback to /livetranslator on/off command on server, when executed by playere
• Add listener, that checks if translation server is one
• Show original text, if target lang is the same as source lang

• When a text is translated, the detected source language may be inaccurate.
• When the mod is installed on both the client and the server, the translator may not work properly.

• Delete the mod jar.
• Delete the mod folder in config/livetranslator
• Delete the model, in a shared folder:
  • Windows: %USERPROFILE%.local\share\minecraft_livetranslator_mod
  • Mac/Linux: ~/.local/share/minecraft_livetranslator_mod

This mod is provided "as-is" without any warranty of any kind.
By using this mod, you agree that the author(s) are not responsible for any damages, data loss, misuse, or unintended consequences that may arise from its use.
This project is not affiliated with Mojang, Microsoft, or Meta AI.