Описание
LinguaChat makes your communication in Minecraft accessible in any language, automatically translating chat messages without interrupting gameplay!
You can configure the translation directions for both sides (Client/Server) in the configuration file See description below.
## 📥 Installation
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:**
4. 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](https://www.deepl.com/pro-api) | 30+ |
| **Kagi** | Kagi Pass | API Token ([settings/api](https://kagi.com/settings/api)) or Session Token ([settings/user_details](https://kagi.com/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
---