How It Works

How It Works

MineGlot is a client-side mod. Nothing runs on the server — your API key and cache stay on your PC.

Two ways to translate

1. Commands (/translate, /trs, /translation)

You type text yourself. The mod sends it to the AI and shows the result in chat.

• Uses your target language from the GUI (what you want to speak to others).
• Does not need a player on the target list.
• Good for quick tests and sending translated lines yourself.

/translation has one extra mode:

1. Run /translation without text.
2. For 30 seconds, already visible chat lines and newly received chat lines become clickable.
3. Click a chat line to translate that exact line.

2. Incoming chat (automatic)

When someone else writes in chat, MineGlot can translate their message into your default language.

Requirements:

1. The sender is on your target players list (GUI → Target players).
2. The sender is not you.
3. The chat format is recognized by the parser.

Flow:

Chat message → parse player + text → filter target/not you
            → cache check → API if needed → show translation in chat

Target players (important)

Open the main GUI → Target players → add online players you want to follow.

• Only messages from listed players are auto-translated.
• Your own messages are never auto-translated.
• The list is cleared when you disconnect from a server.

Signs (optional)

If enabled in config:

• Signs: look at a sign to get a translation.

Sign translation is separate from chat commands.

Cache (why repeats feel instant)

Before calling the API, MineGlot checks:

1. Memory cache (fast, same session)
2. RocksDB on disk (survives restarts)

Same text + same target language can return instantly without a new API call.

Use /trs-clear to drop the last cached entry if you need a fresh translation.

Language detection

For incoming chat, Lingua detects the source language when needed.

For /translate commands, you choose the target language in settings; detection is used where the pipeline needs a source language for the API.

Note — Some servers (e.g. Hypixel) restrict client mods. Check server rules before using MineGlot online.