Описание
# Translate All in One
> **Preview Notice**
>
> - Current target version: **Minecraft 1.21.10**
> - Platform: **Fabric (Client-side)**
> - 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 ` 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:
- **Done** = save and close
- **Cancel** = 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](./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 `，用于手动重翻译聊天行（`[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](./LICENSE)。