AI Translate All in One

Translate All in One

> 21+ > > - Current target version: 21+ > - Platform: 21+ > - Java: 21+ > - This project is actively evolving. Feedback and bug reports are welcome in Issues.

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.

---

English

What It Can Do Right Now

Translation modules

| Module | What it does | Highlights | | --- | --- | --- | | Chat Output | Translates incoming chat lines | Auto mode or manual `[T]` click mode, optional streaming display | | Chat Input | Translates your text before send | Hotkey-driven translation plus AI rewrite actions (Translate/Professional/Friendly/Expand/Concise/Restore), optional streaming update | | Item Tooltip | Translates item custom name and lore | Template/style-preserving pipeline, async cache queue | | Scoreboard Sidebar | Translates prefix/suffix and player name display | Real-time replacement with style-preserving reconstruction |

AI provider and routing system

- Multiple provider profiles in one config. - Provider types: - `OPENAI_COMPAT` (`/chat/completions`) - `OPENAI_RESPONSE` (`/responses`) - `OLLAMA` (`/api/chat`) - Per-route model selection for: - Chat Output - Chat Input - Item Translation - Scoreboard Translation - Each module has an independent Target Language field.

Model-level controls

- Model ID - Temperature - Ollama keep_alive (for Ollama profiles) - Supports system message toggle - Inject system prompt into user message toggle (used when system-message mode is disabled) - Structured output toggle with compatibility fallback - Prompt suffix - Custom parameters (JSON tree editor) - Set as default model

Runtime behavior and reliability

- Translation pipeline preserves style markers/placeholders/tokens as much as possible. - Item and scoreboard template caches persisted on disk. - Retry queue prioritizes requeued failed items (front-of-queue retry). - Batch translation with configurable batch size/thread count (item/scoreboard). - Session-epoch guard prevents stale async callbacks from writing outdated results after world/session switches. - Missing-key and key-mismatch detection triggers prioritized retries with clear in-game fallback/status behavior.

Command and update helpers

- Startup update check against GitHub releases (latest tag detection). - In-game update notice in chat and config modal, with one-click open release page. - Client command: `translate_allinone translatechatline <messageId>` for manual chat-line retranslation (used by manual `[T]` workflows).

In-game config UI features

- Full ModMenu-based custom config screen. - Structured sections with group boxes. - Scroll + clipping + scrollbar drag support for long content. - Provider/model operations inside game: add/remove providers, test connection, manage route models, set default model, edit custom JSON parameters. - Unified action flow: - Reset = save and close - Reset = discard unsaved changes - Reset (red button) = reset to defaults after confirmation - Built-in hotkey capture in config UI (no legacy requirement to bind in Minecraft Controls for these module bindings). - Config-side update notice modal supports opening the latest release page directly.

Requirements

- Minecraft `1.21.10` - Fabric Loader `>= 0.18.1` - Java `>= 21` - Fabric API - ModMenu `>= 16.0.0`

Installation

1. Install Fabric Loader for Minecraft 1.21.10. 2. Put these jars into your `mods` folder: - `translate-all-in-one-*.jar` - Fabric API - ModMenu 3. Launch the game and open ModMenu. 4. Open Translate All in One config and set provider/model routes.

Quick Start

1. Add at least one provider profile in `Providers`. 2. Add models under the provider and set route models for each module. 3. Set module target language (Chat Output/Input, Item, Scoreboard). 4. Configure hotkeys/modes where needed. 5. Click Done to save and close.

Config and Runtime Files

- Main config: - `config/translate_allinone/config.json` - Caches: - `config/translate_allinone/item_translate_cache.json` - `config/translate_allinone/scoreboard_translate_cache.json`

Build From Source

```bash ./gradlew build ```

Useful commands:

```bash ./gradlew check ./gradlew runClient ```

License

MIT. See LICENSE.

---

简体中文

当前已实现功能（完整）

翻译模块

| 模块 | 功能 | 主要特点 | | --- | --- | --- | | 聊天输出翻译 | 翻译收到的聊天消息 | 支持自动翻译和手动 `[T]` 点击翻译，支持流式显示 | | 聊天输入翻译 | 发送前翻译输入框内容 | 快捷键触发翻译 + AI 改写面板（翻译/专业/友好/扩写/简化/还原），可流式回填输入框 | | 物品翻译 | 翻译物品名称与 Lore | 模板/样式保留，异步缓存队列 | | 计分板翻译 | 翻译侧边栏显示文本 | 前后缀与玩家名按配置实时替换 |

服务商与路由能力

- 同时支持多个服务商配置档案。 - 支持的 provider 类型： - `OPENAI_COMPAT`（`/chat/completions`） - `OPENAI_RESPONSE`（`/responses`） - `OLLAMA`（`/api/chat`） - 可为每个功能模块独立设置路由模型： - 聊天输出 - 聊天输入 - 物品翻译 - 计分板翻译 - 每个模块都可独立配置目标语言。

模型级参数（Model Settings）

- 模型 ID - Temperature - Ollama keep_alive（仅 Ollama） - 是否支持 System 消息 - 当不支持 System 消息时，是否将提示词注入用户消息 - 结构化输出开关（带兼容回退） - 提示词后缀 - 自定义参数（JSON 树编辑） - 设为默认模型

运行时特性与稳定性

- 翻译流程尽量保留样式标记、占位符与关键 token。 - 物品与计分板采用持久化模板缓存，减少重复请求。 - 失败重试任务使用更高优先级（进入队列前部）。 - 物品/计分板支持批处理与并发参数配置。 - 会话 Epoch 防护：切换世界/会话后，旧异步回调不会回写过期翻译结果。 - missing key / key mismatch 会触发优先重试，并提供更明确的游戏内状态回退与反馈。

命令与更新提醒

- 启动时自动检查 GitHub 最新版本（tag）。 - 在聊天栏与配置界面内提供更新提示，并支持一键打开 Release 页面。 - 提供客户端命令：`translate_allinone translatechatline <messageId>`，用于手动重翻译聊天行（`[T]` 流程会使用该链路）。

配置界面特性

- 基于 ModMenu 的完整自定义配置界面。 - 分组框布局（Basic / Hotkey / Performance / Route / Providers）。 - 支持滚动、裁剪、滚动条拖动，长列表/小窗口可正常使用。 - 可在游戏内完成 provider/model 管理：新增/删除服务商、测试连接、设置路由模型、设为默认模型、自定义参数树编辑。 - 顶部动作统一： - 重置 = 保存并关闭 - 重置 = 放弃未保存修改 - 重置（红色按钮）= 二次确认后恢复默认配置 - 模块快捷键支持在配置界面内直接捕获与清除。 - 配置界面的更新提示弹窗支持直接打开最新版本发布页。

运行环境要求

- Minecraft `1.21.10` - Fabric Loader `>= 0.18.1` - Java `>= 21` - Fabric API - ModMenu `>= 16.0.0`

安装步骤

1. 安装 Minecraft 1.21.10 对应的 Fabric Loader。 2. 将以下文件放入 `mods` 文件夹： - `translate-all-in-one-*.jar` - Fabric API - ModMenu 3. 启动游戏并在 ModMenu 中打开本模组配置。 4. 配置服务商、模型与路由后保存。

快速配置建议

1. 在 `Providers` 中先添加至少一个服务商。 2. 为服务商添加模型，并设置各模块路由模型。 3. 分别填写四个模块的目标语言。 4. 配置需要的快捷键与模式。 5. 点击 完成 保存。

配置与缓存文件

- 主配置： - `config/translate_allinone/config.json` - 缓存文件： - `config/translate_allinone/item_translate_cache.json` - `config/translate_allinone/scoreboard_translate_cache.json`

从源码构建

```bash ./gradlew build ```

常用命令：

```bash ./gradlew check ./gradlew runClient ```

许可证

本项目采用 MIT License。