Chat Translator

A client-side Fabric mod for Minecraft 26.1.2 that places an asynchronous translation directly below each chat message.

Configuration

The first launch creates config/chat_translator.json:

{
  "enabled": true,
  "provider": "openai",
  "language": "zh-CN",
  "timeout_seconds": 15,
  "max_concurrent_requests": 2,
  "max_queued_messages": 100,
  "provider_settings": {
    "base_url": "https://api.openai.com/v1",
    "api_key": "",
    "model": ""
  }
}

Supported providers:

• openai: base_url is the API root; the mod appends /chat/completions. model is required.
• deepl: use https://api-free.deepl.com or https://api.deepl.com; the mod appends /v2/translate. api_key is required and model is ignored.
• libretranslate: base_url is the instance root; the mod appends /translate. api_key is optional and model is ignored.

Server permissions are stored separately in config/chat_translator_servers.json. A new server is denied by default. Click the in-chat prompt or run /chattranslate toggle once to persist permission for that server.

Client commands

• /chattranslate toggle
• /chattranslate reload
• /chattranslate status
• /chattranslate test

The mod never writes chat text, translations, API keys, requests, or responses to its own log. Translation services still receive allowed chat text over the network according to their own privacy policies.

Build

Use JDK 25 or newer:

./gradlew build

License

Copyright 2026 hushfox. Licensed under the Apache License 2.0.