# Translate All in One<\/p>\n
> **Preview Notice**
\n>
\n> – Current target version: **Minecraft 1.21.10**
\n> – Platform: **Fabric (Client-side)**
\n> – Java: **21+**
\n> – This project is actively evolving. Feedback and bug reports are welcome in Issues.<\/p>\n
An in-game AI translation mod for Minecraft that supports chat, chat input, item tooltip, and scoreboard translation with multi-provider routing, an AI chat-input assistant panel, and a fully in-game configuration workflow.<\/p>\n
—<\/p>\n
## English<\/p>\n
## What It Can Do Right Now<\/p>\n
### Translation modules<\/p>\n
| Module | What it does | Highlights |
\n| — | — | — |
\n| Chat Output | Translates incoming chat lines | Auto mode or manual `[T]` click mode, optional streaming display |
\n| Chat Input | Translates your text before send | Hotkey-driven translation plus AI rewrite actions (Translate\/Professional\/Friendly\/Expand\/Concise\/Restore), optional streaming update |
\n| Item Tooltip | Translates item custom name and lore | Template\/style-preserving pipeline, async cache queue |
\n| Scoreboard Sidebar | Translates prefix\/suffix and player name display | Real-time replacement with style-preserving reconstruction |<\/p>\n
### AI provider and routing system<\/p>\n
– Multiple provider profiles in one config.
\n– Provider types:
\n – `OPENAI_COMPAT` (`\/chat\/completions`)
\n – `OPENAI_RESPONSE` (`\/responses`)
\n – `OLLAMA` (`\/api\/chat`)
\n– Per-route model selection for:
\n – Chat Output
\n – Chat Input
\n – Item Translation
\n – Scoreboard Translation
\n– Each module has an independent **Target Language** field.<\/p>\n
### Model-level controls<\/p>\n
– Model ID
\n– Temperature
\n– Ollama keep_alive (for Ollama profiles)
\n– Supports system message toggle
\n– Inject system prompt into user message toggle (used when system-message mode is disabled)
\n– Structured output toggle with compatibility fallback
\n– Prompt suffix
\n– Custom parameters (JSON tree editor)
\n– Set as default model<\/p>\n
### Runtime behavior and reliability<\/p>\n
– Translation pipeline preserves style markers\/placeholders\/tokens as much as possible.
\n– Item and scoreboard template caches persisted on disk.
\n– Retry queue prioritizes requeued failed items (front-of-queue retry).
\n– Batch translation with configurable batch size\/thread count (item\/scoreboard).
\n– Session-epoch guard prevents stale async callbacks from writing outdated results after world\/session switches.
\n– Missing-key and key-mismatch detection triggers prioritized retries with clear in-game fallback\/status behavior.<\/p>\n
### Command and update helpers<\/p>\n
– Startup update check against GitHub releases (latest tag detection). ### In-game config UI features<\/p>\n – Full ModMenu-based custom config screen. ## Requirements<\/p>\n – Minecraft `1.21.10` ## Installation<\/p>\n 1. Install Fabric Loader for Minecraft 1.21.10. ## Quick Start<\/p>\n 1. Add at least one provider profile in `Providers`. ## Config and Runtime Files<\/p>\n – Main config: ## Build From Source<\/p>\n “`bash Useful commands:<\/p>\n “`bash ## License<\/p>\n MIT. See [LICENSE](.\/LICENSE).<\/p>\n —<\/p>\n ## \u7b80\u4f53\u4e2d\u6587<\/p>\n ## \u5f53\u524d\u5df2\u5b9e\u73b0\u529f\u80fd\uff08\u5b8c\u6574\uff09<\/p>\n ### \u7ffb\u8bd1\u6a21\u5757<\/p>\n | \u6a21\u5757 | \u529f\u80fd | \u4e3b\u8981\u7279\u70b9 | ### \u670d\u52a1\u5546\u4e0e\u8def\u7531\u80fd\u529b<\/p>\n – \u540c\u65f6\u652f\u6301\u591a\u4e2a\u670d\u52a1\u5546\u914d\u7f6e\u6863\u6848\u3002 ### \u6a21\u578b\u7ea7\u53c2\u6570\uff08Model Settings\uff09<\/p>\n – \u6a21\u578b ID ### \u8fd0\u884c\u65f6\u7279\u6027\u4e0e\u7a33\u5b9a\u6027<\/p>\n – \u7ffb\u8bd1\u6d41\u7a0b\u5c3d\u91cf\u4fdd\u7559\u6837\u5f0f\u6807\u8bb0\u3001\u5360\u4f4d\u7b26\u4e0e\u5173\u952e token\u3002 ### \u547d\u4ee4\u4e0e\u66f4\u65b0\u63d0\u9192<\/p>\n – \u542f\u52a8\u65f6\u81ea\u52a8\u68c0\u67e5 GitHub \u6700\u65b0\u7248\u672c\uff08tag\uff09\u3002 ### \u914d\u7f6e\u754c\u9762\u7279\u6027<\/p>\n – \u57fa\u4e8e ModMenu \u7684\u5b8c\u6574\u81ea\u5b9a\u4e49\u914d\u7f6e\u754c\u9762\u3002 ## \u8fd0\u884c\u73af\u5883\u8981\u6c42<\/p>\n – Minecraft `1.21.10` ## \u5b89\u88c5\u6b65\u9aa4<\/p>\n 1. \u5b89\u88c5 Minecraft 1.21.10 \u5bf9\u5e94\u7684 Fabric Loader\u3002 ## \u5feb\u901f\u914d\u7f6e\u5efa\u8bae<\/p>\n 1. \u5728 `Providers` \u4e2d\u5148\u6dfb\u52a0\u81f3\u5c11\u4e00\u4e2a\u670d\u52a1\u5546\u3002 ## \u914d\u7f6e\u4e0e\u7f13\u5b58\u6587\u4ef6<\/p>\n – \u4e3b\u914d\u7f6e\uff1a ## \u4ece\u6e90\u7801\u6784\u5efa<\/p>\n “`bash \u5e38\u7528\u547d\u4ee4\uff1a<\/p>\n “`bash ## \u8bb8\u53ef\u8bc1<\/p>\n \u672c\u9879\u76ee\u91c7\u7528 [MIT License](.\/LICENSE)\u3002<\/p>\n","protected":false},"excerpt":{"rendered":" An in-game AI translation mod for Minecraft that supports chat, chat input, item tooltip, and scoreboard translation with multi-provider routing, an AI chat-input assistant panel, and a fully in-game configuration workflow.<\/p>\n","protected":false},"featured_media":159225,"template":"","meta":{"_minecraft_slug":"translate-allinone","_minecraft_project_id":"xizqhJGO","_minecraft_author":"CedarXuesong","_minecraft_license":"MIT","_minecraft_downloads":2720,"_minecraft_follows":7,"_minecraft_client_side":"required","_minecraft_server_side":"unsupported","_minecraft_storage_type":"zip","_minecraft_archive_name":"translate-allinone.zip","_minecraft_size_bytes":2553186,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T17:16:20.170598Z","_minecraft_date_created":"2025-07-20T05:20:32.787429Z","_minecraft_date_modified":"2026-02-25T12:23:03.700732Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/translate-allinone","_minecraft_icon_attachment_id":159225,"_minecraft_imported_at":"2026-06-09T14:07:46+00:00","_minecraft_import_hash":"beed644c8e91d4f5581275c534a7491a","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97,867,92],"mod_loader":[99],"minecraft_version":[40],"class_list":["post-159224","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-fabric","mod_category-social","mod_category-utility","mod_loader-fabric","minecraft_version-1-21-10"],"yoast_head":"\n
\n– In-game update notice in chat and config modal, with one-click open release page.
\n– Client command: `translate_allinone translatechatline
\n– Structured sections with group boxes.
\n– Scroll + clipping + scrollbar drag support for long content.
\n– Provider\/model operations inside game: add\/remove providers, test connection, manage route models, set default model, edit custom JSON parameters.
\n– Unified action flow:
\n – **Done** = save and close
\n – **Cancel** = discard unsaved changes
\n – **Reset** (red button) = reset to defaults after confirmation
\n– Built-in hotkey capture in config UI (no legacy requirement to bind in Minecraft Controls for these module bindings).
\n– Config-side update notice modal supports opening the latest release page directly.<\/p>\n
\n– Fabric Loader `>= 0.18.1`
\n– Java `>= 21`
\n– Fabric API
\n– ModMenu `>= 16.0.0`<\/p>\n
\n2. Put these jars into your `mods` folder:
\n – `translate-all-in-one-*.jar`
\n – Fabric API
\n – ModMenu
\n3. Launch the game and open ModMenu.
\n4. Open **Translate All in One** config and set provider\/model routes.<\/p>\n
\n2. Add models under the provider and set route models for each module.
\n3. Set module target language (Chat Output\/Input, Item, Scoreboard).
\n4. Configure hotkeys\/modes where needed.
\n5. Click **Done** to save and close.<\/p>\n
\n – `config\/translate_allinone\/config.json`
\n– Caches:
\n – `config\/translate_allinone\/item_translate_cache.json`
\n – `config\/translate_allinone\/scoreboard_translate_cache.json`<\/p>\n
\n.\/gradlew build
\n“`<\/p>\n
\n.\/gradlew check
\n.\/gradlew runClient
\n“`<\/p>\n
\n| — | — | — |
\n| \u804a\u5929\u8f93\u51fa\u7ffb\u8bd1 | \u7ffb\u8bd1\u6536\u5230\u7684\u804a\u5929\u6d88\u606f | \u652f\u6301\u81ea\u52a8\u7ffb\u8bd1\u548c\u624b\u52a8 `[T]` \u70b9\u51fb\u7ffb\u8bd1\uff0c\u652f\u6301\u6d41\u5f0f\u663e\u793a |
\n| \u804a\u5929\u8f93\u5165\u7ffb\u8bd1 | \u53d1\u9001\u524d\u7ffb\u8bd1\u8f93\u5165\u6846\u5185\u5bb9 | \u5feb\u6377\u952e\u89e6\u53d1\u7ffb\u8bd1 + AI \u6539\u5199\u9762\u677f\uff08\u7ffb\u8bd1\/\u4e13\u4e1a\/\u53cb\u597d\/\u6269\u5199\/\u7b80\u5316\/\u8fd8\u539f\uff09\uff0c\u53ef\u6d41\u5f0f\u56de\u586b\u8f93\u5165\u6846 |
\n| \u7269\u54c1\u7ffb\u8bd1 | \u7ffb\u8bd1\u7269\u54c1\u540d\u79f0\u4e0e Lore | \u6a21\u677f\/\u6837\u5f0f\u4fdd\u7559\uff0c\u5f02\u6b65\u7f13\u5b58\u961f\u5217 |
\n| \u8ba1\u5206\u677f\u7ffb\u8bd1 | \u7ffb\u8bd1\u4fa7\u8fb9\u680f\u663e\u793a\u6587\u672c | \u524d\u540e\u7f00\u4e0e\u73a9\u5bb6\u540d\u6309\u914d\u7f6e\u5b9e\u65f6\u66ff\u6362 |<\/p>\n
\n– \u652f\u6301\u7684 provider \u7c7b\u578b\uff1a
\n – `OPENAI_COMPAT`\uff08`\/chat\/completions`\uff09
\n – `OPENAI_RESPONSE`\uff08`\/responses`\uff09
\n – `OLLAMA`\uff08`\/api\/chat`\uff09
\n– \u53ef\u4e3a\u6bcf\u4e2a\u529f\u80fd\u6a21\u5757\u72ec\u7acb\u8bbe\u7f6e\u8def\u7531\u6a21\u578b\uff1a
\n – \u804a\u5929\u8f93\u51fa
\n – \u804a\u5929\u8f93\u5165
\n – \u7269\u54c1\u7ffb\u8bd1
\n – \u8ba1\u5206\u677f\u7ffb\u8bd1
\n– \u6bcf\u4e2a\u6a21\u5757\u90fd\u53ef\u72ec\u7acb\u914d\u7f6e\u76ee\u6807\u8bed\u8a00\u3002<\/p>\n
\n– Temperature
\n– Ollama keep_alive\uff08\u4ec5 Ollama\uff09
\n– \u662f\u5426\u652f\u6301 System \u6d88\u606f
\n– \u5f53\u4e0d\u652f\u6301 System \u6d88\u606f\u65f6\uff0c\u662f\u5426\u5c06\u63d0\u793a\u8bcd\u6ce8\u5165\u7528\u6237\u6d88\u606f
\n– \u7ed3\u6784\u5316\u8f93\u51fa\u5f00\u5173\uff08\u5e26\u517c\u5bb9\u56de\u9000\uff09
\n– \u63d0\u793a\u8bcd\u540e\u7f00
\n– \u81ea\u5b9a\u4e49\u53c2\u6570\uff08JSON \u6811\u7f16\u8f91\uff09
\n– \u8bbe\u4e3a\u9ed8\u8ba4\u6a21\u578b<\/p>\n
\n– \u7269\u54c1\u4e0e\u8ba1\u5206\u677f\u91c7\u7528\u6301\u4e45\u5316\u6a21\u677f\u7f13\u5b58\uff0c\u51cf\u5c11\u91cd\u590d\u8bf7\u6c42\u3002
\n– \u5931\u8d25\u91cd\u8bd5\u4efb\u52a1\u4f7f\u7528\u66f4\u9ad8\u4f18\u5148\u7ea7\uff08\u8fdb\u5165\u961f\u5217\u524d\u90e8\uff09\u3002
\n– \u7269\u54c1\/\u8ba1\u5206\u677f\u652f\u6301\u6279\u5904\u7406\u4e0e\u5e76\u53d1\u53c2\u6570\u914d\u7f6e\u3002
\n– \u4f1a\u8bdd Epoch \u9632\u62a4\uff1a\u5207\u6362\u4e16\u754c\/\u4f1a\u8bdd\u540e\uff0c\u65e7\u5f02\u6b65\u56de\u8c03\u4e0d\u4f1a\u56de\u5199\u8fc7\u671f\u7ffb\u8bd1\u7ed3\u679c\u3002
\n– missing key \/ key mismatch \u4f1a\u89e6\u53d1\u4f18\u5148\u91cd\u8bd5\uff0c\u5e76\u63d0\u4f9b\u66f4\u660e\u786e\u7684\u6e38\u620f\u5185\u72b6\u6001\u56de\u9000\u4e0e\u53cd\u9988\u3002<\/p>\n
\n– \u5728\u804a\u5929\u680f\u4e0e\u914d\u7f6e\u754c\u9762\u5185\u63d0\u4f9b\u66f4\u65b0\u63d0\u793a\uff0c\u5e76\u652f\u6301\u4e00\u952e\u6253\u5f00 Release \u9875\u9762\u3002
\n– \u63d0\u4f9b\u5ba2\u6237\u7aef\u547d\u4ee4\uff1a`translate_allinone translatechatline
\n– \u5206\u7ec4\u6846\u5e03\u5c40\uff08Basic \/ Hotkey \/ Performance \/ Route \/ Providers\uff09\u3002
\n– \u652f\u6301\u6eda\u52a8\u3001\u88c1\u526a\u3001\u6eda\u52a8\u6761\u62d6\u52a8\uff0c\u957f\u5217\u8868\/\u5c0f\u7a97\u53e3\u53ef\u6b63\u5e38\u4f7f\u7528\u3002
\n– \u53ef\u5728\u6e38\u620f\u5185\u5b8c\u6210 provider\/model \u7ba1\u7406\uff1a\u65b0\u589e\/\u5220\u9664\u670d\u52a1\u5546\u3001\u6d4b\u8bd5\u8fde\u63a5\u3001\u8bbe\u7f6e\u8def\u7531\u6a21\u578b\u3001\u8bbe\u4e3a\u9ed8\u8ba4\u6a21\u578b\u3001\u81ea\u5b9a\u4e49\u53c2\u6570\u6811\u7f16\u8f91\u3002
\n– \u9876\u90e8\u52a8\u4f5c\u7edf\u4e00\uff1a
\n – **\u5b8c\u6210** = \u4fdd\u5b58\u5e76\u5173\u95ed
\n – **\u53d6\u6d88** = \u653e\u5f03\u672a\u4fdd\u5b58\u4fee\u6539
\n – **\u91cd\u7f6e**\uff08\u7ea2\u8272\u6309\u94ae\uff09= \u4e8c\u6b21\u786e\u8ba4\u540e\u6062\u590d\u9ed8\u8ba4\u914d\u7f6e
\n– \u6a21\u5757\u5feb\u6377\u952e\u652f\u6301\u5728\u914d\u7f6e\u754c\u9762\u5185\u76f4\u63a5\u6355\u83b7\u4e0e\u6e05\u9664\u3002
\n– \u914d\u7f6e\u754c\u9762\u7684\u66f4\u65b0\u63d0\u793a\u5f39\u7a97\u652f\u6301\u76f4\u63a5\u6253\u5f00\u6700\u65b0\u7248\u672c\u53d1\u5e03\u9875\u3002<\/p>\n
\n– Fabric Loader `>= 0.18.1`
\n– Java `>= 21`
\n– Fabric API
\n– ModMenu `>= 16.0.0`<\/p>\n
\n2. \u5c06\u4ee5\u4e0b\u6587\u4ef6\u653e\u5165 `mods` \u6587\u4ef6\u5939\uff1a
\n – `translate-all-in-one-*.jar`
\n – Fabric API
\n – ModMenu
\n3. \u542f\u52a8\u6e38\u620f\u5e76\u5728 ModMenu \u4e2d\u6253\u5f00\u672c\u6a21\u7ec4\u914d\u7f6e\u3002
\n4. \u914d\u7f6e\u670d\u52a1\u5546\u3001\u6a21\u578b\u4e0e\u8def\u7531\u540e\u4fdd\u5b58\u3002<\/p>\n
\n2. \u4e3a\u670d\u52a1\u5546\u6dfb\u52a0\u6a21\u578b\uff0c\u5e76\u8bbe\u7f6e\u5404\u6a21\u5757\u8def\u7531\u6a21\u578b\u3002
\n3. \u5206\u522b\u586b\u5199\u56db\u4e2a\u6a21\u5757\u7684\u76ee\u6807\u8bed\u8a00\u3002
\n4. \u914d\u7f6e\u9700\u8981\u7684\u5feb\u6377\u952e\u4e0e\u6a21\u5f0f\u3002
\n5. \u70b9\u51fb **\u5b8c\u6210** \u4fdd\u5b58\u3002<\/p>\n
\n – `config\/translate_allinone\/config.json`
\n– \u7f13\u5b58\u6587\u4ef6\uff1a
\n – `config\/translate_allinone\/item_translate_cache.json`
\n – `config\/translate_allinone\/scoreboard_translate_cache.json`<\/p>\n
\n.\/gradlew build
\n“`<\/p>\n
\n.\/gradlew check
\n.\/gradlew runClient
\n“`<\/p>\n