LTranslate

AI-powered chat translation for Paper 1.20+.

Players chat in their own language; everyone else sees their own chosen language. Public chat is translated through an OpenAI-compatible Chat Completions endpoint (structured output), delivered per player, and logged per server session.

Paper 1.20 – 1.21.x · Java 17+ · Spigot not supported · GPL-3.0

Install

1. Drop the jar into plugins/.
2. Start the server, set translation.api-key (or OPENAI_API_KEY) in plugins/LTranslate/config.yml.
3. /lt reload.

Without an API key the plugin does not touch chat at all — it only writes origin.txt.

Commands

Command	Permission	Default	Description
/lt lang [language]	ltranslate.command.lang	everyone	View / set your chat language
/lt reload	ltranslate.command.reload	op	Reload the config

Highlights

• Per-player language delivery; the sender and origin players take the vanilla path instantly
• IP-based auto language detection on first join (CN → zh-CN, elsewhere → en-US, configurable)
• Structured output (json_schema / json_object / none); no message is ever swallowed on AI failure
• Per-session logs: origin.txt + <language>.txt, row-aligned across files
• Hover a translation to see the original; 🌐 marks real translations
• OpenCode Go friendly: dedicated User-Agent + stable x-opencode-session header
• Hot reload applies API key / model / base URL / concurrency instantly