Parley — Real-time Chat Translator
Play with people who don't share your language. Parley translates incoming chat in real time, on your client, on any server. The original message stays visible — the translation appears on a second line below it with a small badge showing the detected source language.
<Player> こんにちは！みんな元気？[🌐 JA] Hello! Is everyone doing well?
Features
- Three providers — Google Translate (free, no key), DeepL (highest quality), or LibreTranslate (open source / self-host).
- Smart pre-filter — skips obviously already-Latin-script messages so it never wastes a request on
lolorgg. /parley translate <text>— translate something you type and send it to chat in the target language. Talk to anyone.- Per-player overrides — force-translate or ignore specific players, remembered forever.
- 100+ languages —
/parley languageslists every code with its English name./parley languages spanfilters. - Searchable settings GUI — full Cloth Config + ModMenu support, four themed tabs, language dropdown.
- Rate-limit aware — quiet cooldown instead of error spam.
- Cached — recently-seen messages don't re-hit the API.
Commands
| Command | What it does |
|---|---|
/parley |
Show status (provider, target language, cache size). |
/parley toggle |
Turn the mod on/off. |
/parley lang <code> |
Set target language. |
/parley languages [filter] |
List or filter supported languages. |
/parley provider <google|deepl|libre> |
Switch translator. |
/parley player <name> |
Cycle player override (default → always → never). |
/parley cache clear |
Clear the translation cache. |
/parley test |
Verify your provider is reachable. |
/parley translate <text> |
Translate and send the result to chat. |
Dependencies
Required
Recommended (for the settings GUI)
If Cloth Config is missing, every setting is still reachable through /parley commands.
Configuration
Settings live in config/parley.json next to your other mod configs. Per-player overrides live in config/parley-players.json. Both are human-readable JSON.
The Cloth Config screen has four tabs:
- General — enable, target language, what to translate, length filter
- Provider — pick a translator, paste API keys
- Display — badge style, color codes, original-message style
- Advanced — cache size, timeout, per-server enable/disable
Privacy
Parley sends incoming chat lines to whichever translation provider you select. Nothing is sent anywhere else. The smart pre-filter and the local cache mean most short or repeat messages never leave your machine.
License
MIT.
