ChatTranslator

Translate Minecraft chat and item tooltips with DeepL API!

A client-side Minecraft mod designed to help players communicate across language barriers, including on international servers like Hypixel.

DeepL APIを使用して、Minecraftのチャットやアイテムの説明文を翻訳できるクライアントMODです。

✨ Features / 主な機能

• Chat Translation / チャット翻訳
  Translate individual messages using the clickable [Tr?] button.
  [Tr?] ボタンからチャットを個別に翻訳できます。

• Automatic Translation / 自動翻訳
  Automatically translate supported messages in selected Hypixel channels.
  Hypixelの対象チャンネルでは自動翻訳を設定できます。

• Item Tooltips / アイテム翻訳
  Translate supported item tooltip text.
  アイテムの説明文を翻訳できます。

• Translation Rules / 翻訳ルール
  Configure source and target languages.
  翻訳元・翻訳先の言語を自由に設定できます。

• Hypixel Mode / Hypixel対応
  Configure AUTO, CLICK, or OFF for Party, Guild, DM, and All Chat.
  チャンネルごとに翻訳方法を設定できます。

• Ignore List / 無視リスト
  Exclude specific messages using case-insensitive exact matching.
  登録した文字列との完全一致で翻訳対象から除外できます。

🔑 Getting Started / 初期設定

A DeepL API key and an internet connection are required.
利用には DeepL APIキー とインターネット接続が必要です。

How to get an API key / APIキーの取得方法

1. Visit DeepL for Developers
   DeepLの開発者向けページへアクセスします。

2. Sign up for a DeepL API plan
   DeepL APIのプランに登録します。無料で試せるプランも用意されています。

3. Copy your API key
   Open your DeepL account → API Keys & Limits.
   DeepLアカウントの「API Keys & Limits」からAPIキーをコピーします。

4. Configure ChatTranslator
   Press J (default) in Minecraft, enter your API key, and configure the translation languages.
   Minecraft内で Jキー（初期設定）を押し、APIキーと翻訳言語を設定します。

DeepL API Plans / APIの料金プラン

DeepL offers free and paid API options. Usage limits and pricing depend on your plan.

DeepLには無料で試せるプランと有料プランがあります。利用可能な文字数や料金は契約プランによって異なります。

DeepL API Plans & Limits / 料金・利用制限を確認

🎮 Commands / コマンド

Manual Translation / 手動翻訳

• /tr <text>
  Translate text and display the result privately.
  翻訳結果を自分だけに表示します。

• /trt <text>
  Translate text and place the result in the chat input.
  翻訳結果をチャット入力欄に挿入します。

Settings / 設定

• /translate on — Enable automatic translation / 自動翻訳ON
• /translate off — Disable automatic translation / 自動翻訳OFF
• /translate status — Show current settings / 設定確認
• /translate tooltip on/off — Toggle tooltip translation / アイテム翻訳切替
• /translate rule add <source> <target> — Add a language rule / 翻訳ルール追加
• /translate rule list — List language rules / ルール一覧
• /translate help — Show commands / ヘルプ

🌍 Supported UI Languages / ローカライズ対応

The settings menu and interface support 10 languages.
設定画面などは 10言語 に対応しています。

• English 🇺🇸 / 日本語 🇯🇵
• 简体中文 🇨🇳 / 한국어 🇰🇷
• Deutsch 🇩🇪 / Español 🇪🇸
• Français 🇫🇷 / Português (Brasil) 🇧🇷
• Tiếng Việt 🇻🇳 / ไทย 🇹🇭

UI language support is separate from translation language support.
UIの対応言語と翻訳可能な言語は異なります。

🌐 Translation Languages / 翻訳対応言語

ChatTranslator uses the languages supported by your DeepL API plan.

翻訳可能な言語はDeepL APIの対応状況と契約プランに依存します。

Common language codes / 主な言語コード

• Japanese / 日本語 — JA
• English / 英語 — EN-US, EN-GB
• Chinese / 中国語 — ZH
• Korean / 韓国語 — KO
• German / ドイツ語 — DE
• French / フランス語 — FR
• Spanish / スペイン語 — ES
• Portuguese (Brazil) — PT-BR

See the DeepL API documentation for additional languages and availability.

📦 Compatibility / 対応バージョン

Fabric

• Minecraft 1.21.11
• Minecraft 26.1
• Minecraft 26.2
• Minecraft 26.3

NeoForge (Legacy)

• Minecraft 26.1

The legacy NeoForge edition may differ in features and maintenance.

NeoForge版は旧版のため、Fabric版と機能やメンテナンス状況が異なる場合があります。

Select the correct file for your Minecraft version and loader.

📖 Source Code & Documentation

GitHub Repository

Source code is organized by Minecraft version branches.
ソースコードはMinecraftのバージョンごとにブランチが分かれています。

Detailed documentation is available on GitHub.
詳しい説明はGitHubの各言語READMEをご覧ください。

Disclaimer / 注意事項

• A valid DeepL API key is required. / 有効なDeepL APIキーが必要です。
• Translation requests use the DeepL API and may count toward your plan's usage limits. / 翻訳にはDeepL APIを使用し、利用文字数が消費される場合があります。
• This is an unofficial project, not affiliated with DeepL SE, Mojang, or Microsoft. / 本MODは非公式プロジェクトであり、各社とは関係ありません。

License: Apache License 2.0