SimpleTranslate 2.0 / 简单翻译 2.0

SimpleTranslate is a client-side Minecraft translation mod for foreign-language maps, RPG servers, adventure content, quest books, item lore, signs, and UI prompts.

简单翻译 2.0 支持所有模型/API 支持的语言互转。
它不是只能英译中。只要你配置的翻译模型支持，就可以进行英译中、中译英、日译中、韩译中、多语言混合文本翻译，或任意源语言到任意目标语言的转换。

This Modrinth page currently provides Fabric builds only.

---

What Makes 2.0 Different / 2.0 有什么不同

SimpleTranslate 2.0 rebuilds the translation pipeline around Minecraft Component JSON.

Instead of flattening game text into plain strings and guessing styles later, 2.0 sends Minecraft text components to the model and accepts translated Component JSON back. This helps preserve:

• colors and formatting / 颜色与格式；
• line breaks / 换行；
• item lore structure / 物品 Lore 结构；
• hover tooltip structure / 悬浮提示结构；
• sign layout / 告示牌布局；
• book page order / 书本页面顺序；
• chat formatting / 聊天格式；
• HUD, title, subtitle, and actionbar text / HUD、标题、副标题、ActionBar 文本；
• advancement names and descriptions / 成就名称与描述。

The goal is simple: translate Minecraft text while keeping it looking like Minecraft.

---

Main Features / 主要功能

Chat Translation / 聊天翻译

Translate server messages, RPG menu text, narrator messages, quest prompts, and formatted chat content.

聊天中的隐藏悬浮提示会走独立的悬浮提示翻译路径，不会在翻译可见聊天时被顺手翻译，从而减少不必要的 Token 消耗和结构污染。

Item Tooltip Translation / 物品提示翻译

Translate item names, attributes, lore, NBT-related text, and complex colored tooltips.

适合 RPG 服务器、自定义装备、冒险地图、剧情整合包和大量外语物品说明的场景。

Sign Translation / 告示牌翻译

Translate single signs or groups of signs. Useful for adventure maps, story walls, server rule boards, puzzle hints, and map instructions.

支持单个告示牌或连续告示牌组翻译，适合地图说明、剧情墙、服务器规则板、谜题提示和场景介绍。

Book Translation / 书本翻译

Translate written books and book pages while keeping the reading order clear.

支持书本页面翻译，适合剧情书、任务书、说明书和服务器百科内容。

Advancement Translation / 成就翻译

Translate advancement names and descriptions.

支持成就/进度名称和描述翻译。

More Game Text / 更多游戏文本

SimpleTranslate can also translate:

• boss bars / Boss 血条；
• scoreboards / 计分板；
• titles and subtitles / 标题与副标题；
• actionbar text / ActionBar 动作栏文本；
• entity names / 实体名称；
• text display entities / 文字展示实体；
• item hover tooltips / 物品悬浮提示；
• book/chat hover tooltips / 书本与聊天悬浮提示；
• other Minecraft UI text surfaces supported by the mod / 模组支持的其他 Minecraft UI 文本表面。

---

Any-Language Translation / 所有语言互转

SimpleTranslate does not lock you to one language pair.

You can configure the target language in the settings and use any compatible translation provider/model.

Examples:

• English -> Chinese
• Chinese -> English
• Japanese -> Chinese
• Korean -> Chinese
• Mixed multilingual text -> your target language
• Any supported source language -> any supported target language

实际翻译质量取决于你配置的模型/API。

---

Cache, Token Statistics, and Original Text / 缓存、Token 统计与显示原文

SimpleTranslate includes tools for long-term gameplay:

• persistent translation cache / 持久化翻译缓存；
• shared cache support / 共享缓存；
• token/request statistics / 请求数与 Token 统计；
• configurable translation providers / 可配置翻译服务/API/模型；
• hold-to-show-original behavior / 按住快捷键临时显示原文。

The hold-to-show-original feature is useful for checking source text, comparing translations, and taking screenshots.

---

Requirements / 安装需求

• Minecraft Java Edition
• Fabric Loader
• Fabric API
• Client-side installation
• Mod Menu is optional but recommended
• A configured translation provider/API/model

---

Notes / 注意事项

• SimpleTranslate is a client-side helper mod. Servers do not need to install it.
• Translation speed, quality, and token usage depend on your configured provider/model and network environment.
• For best structure preservation, use a model that follows JSON/component instructions reliably.