parley

parley is a client side chat translator for fabric 26.1.2. it lets you read chat in your language, and send translated messages back without the server needing to install anything.

it replaces the message instead of putting a second blue translation line under it, so chat doesnt get flooded. it keeps the servers rank, prefix, username colors and stuff when it can.

[🌐 ES] ⚲ [Usu] playername: do you want to be my friend?

the globe says what language it thinks the message came from. if translation takes too long or fails, it just shows the original message so nothing should disappear.

what it does

• translates player chat into whatever language you set.
• can translate server messages too, like broadcasts, tellraw, death messages, and action bar stuff.
• keeps messages in order instead of sending translations a few seconds later all over chat.
• lets you type a prefix before your message to translate and send it. only the translation gets sent.
• lets you turn translation on or off for one server.
• lets you always translate, or never translate, one player.
• works with google translate by default. deepl and libretranslate are there too if you want them.
• has mod menu settings if you have cloth config and mod menu installed.

this is client side only. other players dont need parley and servers dont need to install it.

quick setup, read spanish and write spanish

/parley lang en
/parley players on
/parley system on
/parley outgoing es

then type this in normal chat:

> hello everyone, can i join

it will only send the spanish translation. the > doesnt get sent.

commands

command	what it does
/parley	shows what parley is set to right now.
/parley toggle	turns all translation on or off.
/parley lang <code>	sets the language you want to read. like en, es, or ja.
/parley languages [filter]	shows language codes. parley languages spanish works too.
/parley players on|off|status	turns player messages on or off.
/parley system on|off|status	turns server messages on or off.
/parley prefix [value|off]	changes the outgoing prefix. default is >.
/parley outgoing [code|same]	sets what language prefix messages get sent in.
/parley translate <message>	translates a message and sends it.
/parley provider <google|deepl|libre>	changes translation provider.
/parley test	checks if your translation provider works.
/parley player <name>	changes one player between normal, always translate, and never translate.
/parley server on|off	turns parley on or off for the server you are on.
/parley cache clear	clears saved translations.

providers

• google translate is default and works without putting in a key. you can add a google cloud key if you have one.
• deepl needs a deepl api key.
• libretranslate can use a public server or one you host yourself.

you can change provider stuff in mod menu, or in config/parley.json.

important stuff

translation is not 100% accurate. it can get slang, names, short messages, spelling mistakes, mixed languages, jokes, or server words wrong. its good for understanding chat, but dont trust it completely for important stuff like trades, rules, staff messages, or anything where one wrong word could matter.

parley sends the messages it translates straight from your game to the provider you picked. it doesnt use a parley server and it doesnt collect analytics. if you add an api key, keep config/parley.json private.

some servers have really custom chat systems. parley keeps the normal chat colors and formatting when the server gives it to minecraft, but it cant promise every weird custom chat plugin will look perfect.

needs

• minecraft java 26.1.2
• fabric loader 0.18.6 or newer
• java 25
• fabric api
• fabric language kotlin

cloth config and mod menu are optional, but they make settings easier.

license

mit