# GlobalChatTranslator<\/p>\n
\nA Minecraft plugin that translates player chat messages in real-time using AI. Players can set their preferred language individually, and messages are automatically translated for each recipient \u2014 enabling seamless communication across language barriers.<\/p>\n
—<\/p>\n
## Requirements
\n| | |
\n|—|—|
\n| Server | Spigot or Paper 1.21+ |
\n| Java | 21+ |
\n| LLM provider (pick one) | Google AI Studio API key \/ OpenAI Platform API key \/ Self-hosted Ollama instance |<\/p>\n
—<\/p>\n
## Features
\n– **Real-time translation** \u2014 Chat messages are automatically translated per recipient based on their language setting, powered by Google Gemini, OpenAI ChatGPT, or a self-hosted Ollama instance.
\n– **Per-player language**\u2014 Each player sets their preferred language with `\/gct lang`. Settings persist across sessions.
\n– **Skip prefix** \u2014 Prefix a message with `!` (configurable) to send it as-is without translation.<\/p>\n
—<\/p>\n
## Installation
\n1. Download `GlobalChatTranslator-*.jar`
\n2. Place the jar file inside the `plugins\/` directory
\n3. Start the server once to generate `plugins\/GlobalChatTranslator\/config.yml`
\n4. Edit `config.yml` to set your provider and API key (see [Configuration](#configuration-pluginsglobalchattranslatorconfigyml))
\n5. Run `\/gct reload` or restart the server<\/p>\n
—<\/p>\n
## Providers<\/p>\n
### Google Gemini
\nObtain an API key from Google AI Studio.<\/p>\n
“`yaml
\nprovider: “gemini”
\ngemini-api-key: “YOUR_GEMINI_API_KEY”
\ngemini-model: “gemini-2.5-flash-lite”
\n“`<\/p>\n
Recommended models: `gemini-2.5-flash-lite`, `gemini-2.5-flash`, `gemini-2.5-pro`<\/p>\n
### OpenAI ChatGPT
\nObtain an API key from the OpenAI Platform.<\/p>\n
“`yaml
\nprovider: “openai”
\nopenai-api-key: “YOUR_OPENAI_API_KEY”
\nopenai-model: “gpt-4o-mini”
\n“`<\/p>\n
Recommended models: `gpt-4o-mini`, `gpt-4o`, `gpt-4.1`<\/p>\n
### Ollama (self-hosted)
\nInstall Ollama and pull a model locally. No API key required.
\nFor real-time chat translation, smaller and faster models (2B~4B parameters) are strongly recommended \u2014 response latency matters more than output quality.<\/p>\n
“`yaml
\nprovider: “ollama”
\nollama-url: “http:\/\/localhost:11434”
\nollama-model: “gemma4:e2b”
\n“`<\/p>\n
Recommended models: `gemma4:e2b`, `gemma3:2b`, `qwen2.5:3b`<\/p>\n
—<\/p>\n
## Commands ### Language codes ---<\/p>\n ## Permissions ---<\/p>\n ## Configuration (`plugins\/GlobalChatTranslator\/config.yml`) # Translation provider to use. # ============================================= # Gemini model to use for translation. # ============================================= # Ollama model to use for translation. # ============================================= # OpenAI model to use for translation. # ============================================= # Default language assigned to players who have not set a preference. # Format for messages that were translated. # Format for messages shown to recipients who share the same language as the sender # Show a \"Translating...\" action bar message to the sender while the API is processing. # Notify players of their current language setting when they join the server. # Messages that begin with this prefix are sent as-is without translation. # Minimum interval between translated messages per player, in milliseconds. # Maximum time to wait for an API response, in seconds. # Log raw API request and response bodies to the console. A Minecraft plugin that translates player chat messages in real-time using AI. Players can set their preferred language individually, and messages are automatically translated for each recipient \u2014 enabling seamless communication across language barriers.<\/p>\n","protected":false},"featured_media":76134,"template":"","meta":{"_minecraft_slug":"globalchattranslator","_minecraft_project_id":"jXOIJia3","_minecraft_author":"topi-k","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":4,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"globalchattranslator.zip","_minecraft_size_bytes":14540462,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T12:17:25.643701Z","_minecraft_date_created":"2026-05-08T00:51:06.288974Z","_minecraft_date_modified":"2026-05-03T12:30:23.552805Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/globalchattranslator","_minecraft_icon_attachment_id":76134,"_minecraft_imported_at":"2026-06-04T09:46:58+00:00","_minecraft_import_hash":"27dc2c314f4a2ed7e6279111f26e3c31","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,127,867,129,92],"mod_loader":[132,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-76133","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-game-mechanics","mod_category-paper","mod_category-social","mod_category-spigot","mod_category-utility","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n| Command | Permission | Description |
\n|—|—|—|
\n| `\/gct lang ` | `gct.use` | Set your preferred language (e.g. `en`, `ja`, `es`) |
\n| `\/gct lang` | `gct.use` | Show your current language |
\n| `\/gct reload` | `gct.admin` | Reload `config.yml` and apply changes |
\n| `\/gct help` | \u2014 | Show help |<\/p>\n
\nISO 639-1 codes are supported. Examples: `ar` `cs` `da` `de` `en` `es` `fa` `fi` `fr` `hu` `id` `it` `ja` `ko` `ms` `nb` `nl` `pl` `pt` `ro` `ru` `sv` `th` `tr` `uk` `vi` `zh`<\/p>\n
\n| Permission | Default | Description |
\n|---|---|---|
\n| `gct.use` | `true` | Allows players to set their language |
\n| `gct.admin` | `op` | Allows reloading the config |<\/p>\n
\n```yaml
\n# =============================================
\n# GlobalChatTranslator - Configuration
\n# =============================================<\/p>\n
\n# Supported values: gemini, openai, ollama
\n# After changing this value, run \/gct reload to apply.
\nprovider: \"gemini\"<\/p>\n
\n# Gemini Settings (provider: gemini)
\n# =============================================
\n# API key obtained from Google AI Studio (https:\/\/aistudio.google.com\/)
\ngemini-api-key: \"YOUR_GEMINI_API_KEY\"<\/p>\n
\n# Recommended: gemini-2.5-flash-lite (fastest, lowest cost)
\n# Other options: gemini-2.5-flash, gemini-2.5-pro, gemini-2.0-flash, gemini-1.5-flash
\ngemini-model: \"gemini-2.5-flash-lite\"<\/p>\n
\n# Ollama Settings (provider: ollama)
\n# =============================================
\n# Base URL of your Ollama server.
\nollama-url: \"http:\/\/localhost:11434\"<\/p>\n
\n# The model must be pulled in advance (e.g. ollama pull gemma4:e2b).
\n# For real-time chat translation, smaller and faster models (2B~4B parameters) are
\n# strongly recommended over large models. Response latency matters more than accuracy.
\n# Recommended: gemma4:e2b, gemma3:2b, qwen2.5:3b
\nollama-model: \"gemma4:e2b\"<\/p>\n
\n# OpenAI Settings (provider: openai)
\n# =============================================
\n# API key obtained from OpenAI Platform (https:\/\/platform.openai.com\/)
\nopenai-api-key: \"YOUR_OPENAI_API_KEY\"<\/p>\n
\n# Recommended: gpt-4o-mini (low cost, sufficient quality)
\n# Other options: gpt-4o, gpt-4.1
\nopenai-model: \"gpt-4o-mini\"<\/p>\n
\n# General Settings
\n# =============================================<\/p>\n
\n# Uses ISO 639-1 codes (e.g. en, ja, zh, es, fr).
\ndefault-language: \"en\"<\/p>\n
\n# Placeholders: %source_lang%, %target_lang%, %player%, %message%
\n# Use & followed by a color code for formatting (e.g. &7 for gray, &f for white).
\nmessage-format: \"&7[%source_lang% -> %target_lang%] &f%player%&7: &f%message%\"<\/p>\n
\n# (translation is skipped). Same placeholders are available.
\nsame-language-message-format: \"&f%player%&7: &f%message%\"<\/p>\n
\n# Disable this if you prefer a quieter experience or notice display conflicts.
\ntranslating-action-bar: true<\/p>\n
\nnotify-language-on-join: true<\/p>\n
\n# The prefix character is stripped before the message is delivered.
\n# Set to \"\" to disable.
\nskip-prefix: \"!\"<\/p>\n
\n# Players who send messages faster than this rate will have their message blocked.
\n# Set to 0 to disable.
\ncooldown: 1000<\/p>\n
\n# If the provider does not respond within this time, the original message is
\n# delivered untranslated rather than dropped.
\napi-timeout: 10<\/p>\n
\n# Useful for diagnosing translation failures or unexpected output.
\n# Disable in production as API keys may appear in the output.
\ndebug: false
\n```<\/p>\n","protected":false},"excerpt":{"rendered":"