BlackGrid Translator

# BlackGrid Translator

BlackGrid Translator is a client-side Minecraft chat translation mod designed to help players who speak different languages communicate on multiplayer servers.

The mod supports both incoming and outgoing translation while preserving the original server messages. Interactive chat components—such as teleport-request Accept and Deny buttons—remain intact and clickable.

## Features

- Translate outgoing messages from your language into the server language
- Translate incoming messages into your language
- Two-way, outgoing-only, and incoming-only modes
- Separate personal and server language settings
- Automatic incoming-language detection
- Support for Simplified and Traditional Chinese
- Support for English, Spanish, French, German, Portuguese, Russian, Japanese, and Korean
- Optional locally translated F3 debug labels
- Translation caching to reduce duplicate requests
- Master enable/disable switch
- Compact configuration screen with additional advanced options
- Client-side only; the server and other players do not need the mod

## Command safety

Most slash commands bypass translation and are sent unchanged.

For `/msg`, `/tell`, and `/w`, BlackGrid Translator preserves the command and recipient while translating only the private-message body.

Examples:

`/tpa Player` remains unchanged.

`/msg Player 谢谢你` can be sent as `/msg Player Thank you`.

## Interactive messages

BlackGrid Translator never replaces the original incoming server message. Translations appear on a separate line, preserving colors, hover information, and click actions such as Accept and Deny.

## Configuration

The main configuration screen contains:

- Mod enabled
- My language
- Server language
- Translation mode
- Advanced settings

Fabric users should install Mod Menu to access the configuration screen conveniently.

## Requirements

### NeoForge

- Minecraft 1.21.1
- NeoForge 21.1.234 or compatible 21.1.x version

### Fabric

- Minecraft 1.21.1
- Fabric Loader
- Fabric API
- Mod Menu recommended

## Privacy

Chat selected for translation is sent to Google's public translation endpoint. Do not use the translation feature for sensitive or confidential information.

## Installation

1. Install Fabric or NeoForge for Minecraft 1.21.1.
2. Install Fabric API when using Fabric.
3. Place the BlackGrid Translator JAR in the instance's `mods` folder.
4. Start Minecraft and configure the mod from the Mods screen.

BlackGrid Translator is client-side only.