Configuration

Configuration

File locations

What	Path
Main config	.minecraft/config/mineglot.cfg
Translation cache (RocksDB)	.minecraft/config/mineglot/translations
UI language files	Inside the mod jar (assets/mineglot/lang/)

First-time setup (GUI)

1. API key — OpenAI or Claude (stored locally in mineglot.cfg).
2. Provider + model — pick what you want to use.
3. Default language — language you read (incoming chat translations).
4. Target language — language you write when using /translate / /trs.

Useful toggles (config / GUI)

Setting	Effect
Sign translation	Translate text on signs you look at
Max cache memory	RAM limit for in-memory cache (MB)

Target players

Not stored in mineglot.cfg as a long list — managed in-game via Target players screen.

• Add/remove players while online on a server.
• List resets on disconnect.

See How It Works.

Runtime behavior

• Lingua language detector loads in the background (first launch can feel slower).
• RocksDB starts in the background.
• Cache is checked before every API call.

Warning — API keys are local but sensitive. Never share mineglot.cfg or logs that contain keys.

Safe reset

1. Close Minecraft.
2. Backup mineglot.cfg if you want to keep settings.
3. To clear only cached translations: delete the mineglot/translations folder.
4. Restart and test with /translate hello.