Chat translation for Minecraft 1.8.9 (Forge, works in Lunar Client). Lines are translated with Google Translate first. If Google fails, Parley tries the translator built into Microsoft Edge, and if both fail it uses a translation model that runs on your own PC. No API keys are needed, and when the online services rate-limit you or go down, translation keeps working offline.
Every chat line gets a small [T] in front of it. Click it and the line is translated into English, tagged with the language it came from:
[T] [VIP] Mateo: alguien quiere jugar bedwars conmigo?
[ES] [VIP] Mateo: Anybody want to play BedWars with me?
Hover the translated line to see the original. If you'd rather have every foreign line translated without clicking, turn that on with /tr in on. You can also write in English and have Parley send your messages in another language.
- Download
parley-1.2.0.jarfrom the releases page. - Put it in your Forge 1.8.9 mods folder. For Lunar Client that is
%USERPROFILE%\.lunarclient\profiles\1.8\mods\forge-1.8.9\. - Start the game.
The first time a language needs the offline model (because Google and Edge both failed, or online translation is off), Parley downloads it (about 110 MB, once) and shows the translation as soon as the download finishes. Models are stored in .minecraft\config\parley\models\.
Windows 64-bit only for now.
| Command | What it does |
|---|---|
/tr |
Status and help |
/tr in on / off |
Translate every foreign line automatically instead of on click (off by default) |
/tr button on / off |
Show or hide the [T] buttons |
/tr out <language> |
Translate everything you type into that language. Commands are never touched |
/tr out off |
Send messages as you type them again |
/tr say <language> <message> |
Translate and send a single message |
/tr langs |
Supported languages and which models are downloaded |
/tr ignore <language> |
Leave a language you can read out of automatic translation. Run it again to undo |
/tr download <language> |
Download a language's models now instead of on first use |
/tr auto on / off |
Download models automatically when a new language appears |
/tr online on / off |
Use Google and Edge before the offline models (on by default). Turn it off to keep chat on your PC |
Languages can be given as a code (es) or a name (spanish). /parley works as an alias for /tr.
- Clicking always translates. A clicked line skips the language checks below. If Parley can't tell which language it is, the multilingual model works it out, and a line that turns out to be English gets a short note instead of a copy of itself.
- Automatic mode leaves English alone. With
/tr in on, every line is checked first, and English chat, slang likegg ezorrn, and lines Parley isn't sure about are skipped. If a translation comes back almost identical to the original, it is dropped. - Game terms stay intact. BedWars, SkyWars, SkyBlock, UHC and similar names are kept as they are instead of becoming "guerras de cama".
- Chat shorthand is expanded before translating, so
u,plsandidkin your messages, orxq,vcandtmbin other people's, come out as real words.
With /tr online on (the default), each line goes to Google first, then Edge, then the offline model. A service that fails is skipped for two minutes, or ten if it reports a rate limit, so a dead service doesn't slow every line down. Failures are written to the game log, not to chat. Online translation sends the chat text to Google or Microsoft. If you don't want that, /tr online off keeps everything on your PC.
Writing in a language still needs Parley to support that language offline (see Languages), even when Google or Edge does the translating.
Translation runs on one low priority background thread and never on the render thread, so it doesn't cost frames. A typical chat line takes 100 to 400 ms on one CPU core. Each loaded model takes about 280 MB of memory. At most two are loaded at once, and a model that hasn't been needed for five minutes is unloaded. Repeated messages are cached.
Reading (into English): Spanish, Portuguese, French, German, Italian, Dutch, Polish, Russian, Ukrainian, Turkish, Czech, Slovak, Swedish, Danish, Norwegian, Finnish, Estonian, Indonesian, Tagalog, Romanian, Hungarian, Croatian, Slovenian, Lithuanian, Latvian, Catalan, Afrikaans, Vietnamese, Bulgarian, Japanese, Chinese, Korean, Arabic, Thai, Hindi, Persian, Greek and Hebrew.
Writing (from English): all of the above except Slovak, Tagalog and Korean. Languages marked with * in /tr langs go through a shared multilingual model and come out rougher than the rest.
With Google or Edge, quality is what you would get on their websites. The offline model is good for normal sentences and weaker for heavy slang or typos. It is a small model, not DeepL.
Online, Parley calls the free endpoints behind Google Translate's browser extension (translate.googleapis.com) and Edge's built-in page translation (api-edge.cognitive.microsofttranslator.com). These are not official APIs and may change or stop working; when they do, the offline model takes over.
Offline, Parley uses the Opus-MT translation models from the University of Helsinki, in the ONNX versions published by Xenova, and runs them with ONNX Runtime. Text is split into tokens by a small SentencePiece implementation in plain Java. Languages are detected from character patterns and word frequencies; Japanese, Chinese, Korean, Arabic and other scripts are recognised by their alphabet.
Needs JDK 8.
gradlew setupCIWorkspace build
The jar ends up in build/libs. The engine tests compare against reference output and need downloaded models; point PARLEY_MODELS at a folder containing es-en, en-es, ru-en, mul-en and en-ROMANCE, or they are skipped.
- Translation models: Opus-MT by Helsinki-NLP (Apache 2.0), downloaded at runtime, not included in the jar.
- ONNX Runtime (MIT), included in the jar.
- Language profiles from Shuyo Nakatani's language-detection, as packaged by optimaize/language-detector (Apache 2.0).
- Word frequency lists from hermitdave/FrequencyWords (CC BY-SA 4.0), trimmed to the top 3000 words per language.
- Part of the English abbreviation list from c-Cyril-l/Internet-Abbreviations (MIT).
See NOTICE for details. Parley itself is MIT licensed.