Translator (NeoForge)

This mod serves as a translation tool within the game, designed to translate text found in various in-game elements without altering world data. It supports chat, scoreboards, boss bars, titles, tooltips, signs, TextDisplay floating text, books, and more.

Maintained by Gstar (GitHub) — NeoForge 1.21.1, developed with AI-assisted tooling (Cursor). Independent project; see CREDITS.md for design references.

Platform

Key features

• Non-intrusive translation — client-side only; does not modify the world.
• Hotkeys
  • U — open translation options
  • O — screen OCR (when the active translator supports images)
• In-game commands
  • /transconfig — configure translators, languages, cache, and API keys
  • /translate <text> — translate text (result is copyable)
  • /translate-re <text> — reverse translation
• Auto-translate — chat, tooltips, titles, scoreboard, boss bar, signs, entity names / TextDisplay, and more (toggle per feature in options)

Supported translation services

Configure your own API keys in-game (Cloth Config or commands):

• Baidu Translate
• Youdao Translate
• Tencent Cloud Machine Translation
• Bing Translate
• OpenAI-compatible LLM endpoints

Quick start

1. Install NeoForge 21.1.216+, Cloth Config API (NeoForge 15.0.127+), and this mod.
2. Configure Tencent Cloud (example):

   /transconfig tencent <SecretId> <SecretKey>
   

3. Set languages:

   /transconfig language "Auto" "Chinese (Simplified)"
   

4. Press U and enable the auto-translate options you need.

Full command reference: docs/INSTALL.md

Chinese documentation

Simplified Chinese guides are on GitHub (this Modrinth page is English-only):

• README — 中文简介
• Installation & commands — 安装与全部指令（中文）
• Development — 开发指南（中文）
• Changelog — 更新日志（中文）