Troubleshooting

Troubleshooting

No translation at all

• API key set in GUI
• Provider and model selected
• Default + target language set
• Internet connection

Commands work, but chat does not auto-translate

• Player is on Target players list
• Message looks like normal player chat (Player: message, <Player> msg, etc.)
• Sender is not you

See How It Works.

/translation does not click an old message

• Run /translation without text first
• Open the chat, then click the line within 30 seconds
• The line must not be a command line starting with /

Wrong language

• Commands use target language (GUI).
• Incoming chat uses default language (GUI).
• Short messages are harder for Lingua to detect — try a longer phrase.

Slow first launch

Normal: Lingua models and RocksDB init run in the background.

Same text always returns old translation

Cache is working. Use /trs-clear or clear .minecraft/config/mineglot/translations (game closed).

API errors (401, 403, rate limit)

• Check key is valid and copied without spaces
• Check model name is still available for your provider
• Wait and retry if rate-limited

Garbled characters in logs

Use UTF-8 in your terminal or log viewer.

On multiplayer servers

Respect server rules. MineGlot is client-only but some networks restrict certain mods.