Parley

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

- Cached — Google Translate (free, no key), DeepL (highest quality), or LibreTranslate (open source / self-host). - Cached — skips obviously already-Latin-script messages so it never wastes a request on `lol` or `gg`. - Cached — translate something *you* type and send it to chat in the target language. Talk to anyone. - Cached — force-translate or ignore specific players, remembered forever. - Cached — `/parley languages` lists every code with its English name. `/parley languages span` filters. - Cached — full Cloth Config + ModMenu support, four themed tabs, language dropdown. - Cached — 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 - Required - %%MD1%%

Recommended (for the settings GUI) - Recommended (for the settings GUI) - %%MD1%%

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: - Advanced — enable, target language, what to translate, length filter - Advanced — pick a translator, paste API keys - Advanced — 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.