Skip to content

Lintech-1/LinguaChat

Repository files navigation

LinguaChat Logo

LinguaChat

Automatic chat message translation between Minecraft players

Loader Download on CurseForge Download on Modrinth

🇷🇺 Русская версия


🌟 Features

  • Real-time message translation
  • Three translation providers: Google Translate (free), DeepL, Kagi
  • Customizable source and target languages
  • Separate settings for incoming and outgoing messages
  • Original text available on hover
  • Automatic language detection
  • Full UI localization (English and Russian)
  • Supports Minecraft 1.16.5 — 1.21.11

📥 Installation

Requirements

Minecraft Java Fabric Loader Fabric API
1.16.5 8+ 0.16.10+ 0.42.0+
1.18.2 17+ 0.16.10+ 0.76.0+
1.19.2 17+ 0.16.10+ 0.76.1+
1.20.1 17+ 0.16.10+ 0.92.2+
1.21.1 21+ 0.16.10+ 0.102.0+
1.21.4 21+ 0.16.10+ 0.99.5+
1.21.5 21+ 0.16.10+ 0.122.0+
1.21.11 21+ 0.16.10+ 0.139.5+

Installation Steps

  1. Install Fabric Loader for your Minecraft version
  2. Install Fabric API matching your version
  3. Download LinguaChat for your version

For official Minecraft Launcher:

  1. Place the JAR file in your mods folder:
    • Windows: %APPDATA%\.minecraft\mods
    • Linux: ~/.minecraft/mods
    • macOS: ~/Library/Application Support/minecraft/mods

For Prism Launcher and other instance-based launchers:

  1. Open instance settings → Mods tab
  2. Click Add / Install Mods and select the JAR file
  3. Make sure Fabric API is installed for this instance

Final step:

  1. Launch Minecraft with Fabric profile

📝 Usage Example

When properly configured, the mod automatically translates messages:

Player1: привет
[Chat for you]: hello

Player2: hello
[Chat for you]: привет

Tip

The original text of the message is available by hovering over the translated message!


⚙️ Configuration

Mod settings are accessible via the K key in-game.

You can also edit the file directly: config/linguachat.json

Keybinds

Key Action
K Open settings screen
N Toggle outgoing message translation

Settings

Parameter Default Description
enabled true Enable/disable the mod
translateIncoming true Translate incoming messages
translateOutgoing true Translate outgoing messages
defaultSourceLang "auto" Source language (auto for detection)
defaultTargetLang "en" Target language for both incoming messages (messages from other players) and outgoing messages (your messages sent to server)
preferredTranslator "google" Provider: google, deepl, kagi
deeplApiKey "" DeepL API key
kagiApiKey "" Kagi API token
kagiSessionToken "" Kagi session token
showOriginalOnHover true Show original on hover
cacheSize 512 Translation cache size
debugMode false Debug logging

Translation Providers

Provider Cost API Key Languages
Google Free Not required 100+
DeepL Free/Paid Get API Key 30+
Kagi Kagi Pass API Token (settings/api) or Session Token (settings/user_details) Multiple

🐛 Reporting Issues

Found a bug or have a suggestion? Create an issue:

👉 https://github.com/Lintech-1/LinguaChat/issues

Please include:

  • Minecraft version
  • Mod version
  • Log excerpts
  • Steps to reproduce

📚 For Developers

Full developer documentation including Stonecutter multi-version development, compatibility layers, and public API is available in docs/en.md (English) and docs/ru.md (Русский).


Made with ❤️ for the Minecraft community. Happy gaming and clear communication in any language!

About

Fabric mod for automatic bidirectional chat translation. Supports multiple providers: Google Translate, DeepL, and Kagi.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages