MineCraft-Mod-Translate-Tool

Minecraft Java Edition の一部の MOD を簡単に翻訳するリソースパックを作成できます。
最新版ダウンロード: https://github.com/Maji3429/Minecraft_Mod_Translate_tool/releases/latest

Warning

• これは非公式のツールであり、MOD の翻訳を完全に保証するものではありません。
• 一部のMODは翻訳できない可能性があります。
• 使用は自己責任でお願いします。
• 翻訳したファイルは個人使用にしてください。配布はご遠慮ください。
• デフォルトモデルであるPLaMo 2 Translateのライセンスを必ず確認してください。: https://plamo.preferredai.jp/info/plamo-community-license-ja

🚀 使い方

1. Releases からファイルをダウンロードして任意のフォルダーの中に配置してください。(起動時にlogsフォルダやtempフォルダが作成されます)または自分でコンパイルすることもできます。
2. ソフトを起動します。
3. 設定アイコンをクリックして、Ollamaのエンドポイントとモデルを設定します。
   • OllamaからOllamaをダウンロードしてインストールしてください。(未インストールの場合、アプリ起動時にダイアログが表示されます。)
   • デフォルトのモデルは翻訳専用のモデルであるmitmul/plamo-2-translate:Q4_Kに設定されていますが、他のモデルも使用できます。
     • このモデルを使用するにはRAMまたはVRAMが7.1GB以上必要です。(実際にはコンテキスト長によってさらに必要なメモリが増える可能性があります)
     • もし翻訳が途中で失敗する場合は、より小さいモデルを試してみてください。(mitmul/plamo-2-translate:IQ3_MはRAM/VRAMが約6GBあれば動作するはずです。)
     • デフォルトモデルについて:
       • PLaMo翻訳モデルはPreferred Networksによって開発された翻訳特化のLLMです。
       • PLaMo 2 TranslateのOllamaのページ: https://ollama.com/mitmul/plamo-2-translate
       • 本家のHugging Face: https://huggingface.co/pfnet/plamo-2-translate
       • このモデルのライセンス: https://plamo.preferredai.jp/info/plamo-community-license-ja
4. 翻訳する MOD のバージョンを選択します。
5. 手動でファイルを選択します。もしくは、modsフォルダーのパスをクリップボードにコピーしてボタンをクリックし、しばらくまつと翻訳が開始されます。
6. 翻訳が完了するまで待ちます。完了すると、翻訳されたファイルが translate_rp フォルダに出力され、出力フォルダが自動的に開きます。
7. 実行ファイルと同じ階層に translate_rp というフォルダがあるのでマインクラフト内でリソースパックとして読み込ませてください。
8. MOD で追加されたアイテムの名前などが翻訳されます。

⚡️ 注意点

Caution

• このソフトウェアは、個人の使用を目的として作成されたものであり、非公式です。
• 本ソフトウェアの使用により発生したいかなる損害や問題について、作成者は一切の責任を負いません。
• 使用は自己責任で行ってください。
• 翻訳したファイルは個人使用にしてください。配布はご遠慮ください。

• 言語ファイルを持たない MOD は翻訳できません。(Essential Mod など)

• Bedrock 版のアドオンや、Lunar Client のようなどのクライアントは翻訳できません。比較的新しいバージョンの Java Edition MOD のみ翻訳できます。

• 最初のバージョン選択画面に自分の使用したい MOD のマインクラフトバージョンがない場合は、ツールに表示されている中で一番新しいバージョンを選択し、ゲーム内でリソースパックとして読み込むときに警告を無視すれば問題なく動作します。

• 翻訳時に変数が誤動作を引き起こしてゲーム内での表示が崩れる場合があります。issue にて MOD 名とバージョンとともに教えてくださると助かります。

• 翻訳の品質は選択したLLMモデルに依存します。UI上で無料・有料を含む様々なモデルから選択できます。

📒 今後の展望

v0.8.0 を一時的な完成とし、もし需要が伸びてきたら以下を実装したいと考えています。

• 翻訳元と翻訳先の言語を選択できるようにする。
• MOD の中にある MOD も翻訳できるようにする。 (2024-12-27)
• DB 等を利用してすでに翻訳したことのある MOD の言語ファイルを呼び出せるようにする(権利問題の可能性？)
• 出力されたリソースパックを自動でクリップボードにコピーする(技術的に不可能?)
• 複数のLLM APIプロバイダーに対応する（直接OpenAI API、Gemini API、Anthropic API、Ollama Localなど）
• 実際のAPIを使用した自動テストの追加
• DeepL API を利用してより高度な翻訳を行得るようにする(API はユーザー依存)
• UI の改善 (第 2 次: 2024-12-27)
• temp フォルダを自動作成
• バージョン未選択時のダイアログ
• 翻訳完了時の通知と通知音の設定を追加
• 並列処理による複数 MOD の同時翻訳

---

作成動機など

マインクラフトのモチベが下がってくると、大規模な MOD で遊びたくなりました。しかしいざ蓋を開けてプレイすると、殆どの場合は日本語対応していません。
本当に良い MOD だと翻訳協力したくなりますが、いつも可能とも限りません。そこまで時間をかけたくないときもあります。
あまりに翻訳する量が多いときもあります。そんなときは ChatGPT も使えません。Gemini を使っても良いですが、わざわざ jar ファイルを開けるのは面倒。

ちょうど Python を始めていたので、初めての実践として MCTT を作りました。

過去のリリースにもある通り、最初は単体のファイルで作っていきました。
そのうち関数の管理が追いつかなくなって、モジュール化という手法を知りました。
GUI ライブラリも迷い、Tkinter から CustomTkinter、最終的には Flet に落ち着きました。

並列翻訳で高速化したり、UI 構成をもっと見やすくしたりしました。

---

使用したOSSとライセンス

このプロジェクトは以下の OSS ライセンスを使用しています。

• Flet (Apache License 2.0): https://github.com/flet-dev/flet/blob/main/LICENSE
• Ollama (MIT License): https://github.com/ollama/ollama?tab=MIT-1-ov-file
• ※コンパイル Nuitka : https://nuitka.net/doc/user-manual.pdf