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 lol or gg.
• /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 languages lists every code with its English name. /parley languages span filters.
• 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

• Fabric API
• Fabric Language Kotlin

Recommended (for the settings GUI)

• Cloth Config
• Mod Menu

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.