localization

このページは TBH: Task Bar Hero の日本語化（ローカライズ）に関する情報をまとめたリファレンスです。ゲーム内テキストを日本語表示にする方法、注意点、翻訳でよく出る用語や運用ルールを一か所に整理しています。

概要と重要性

日本語化はプレイ体験を大きく左右します。誤訳や未翻訳文字列は操作理解やストーリー把握を妨げるため、正確な翻訳・文字列管理と配布手順を確立することが重要です。本ページは公式ローカライズの手順およびコミュニティでの二次配布に関する基本方針を示します。

日本語化の方法（公式版／非公式版の区別）

• 公式日本語対応がある場合は、まず公式パッチやストア（Steam/Epic/モバイル）で提供されるロケールを利用してください。公式版は翻訳整合性・アップデート互換性が保証されます。
• 公式対応がない場合、コミュニティ製の日本語パッチや翻訳ファイルが存在することがあります。導入前に配布元の信頼性・配布形式（置換ファイル・DLL注入・MODマネージャ使用など）と安全性（ウイルスチェック、権限要求）を必ず確認してください。
• 非公式翻訳はゲームのアップデートで動作しなくなる可能性があります。アップデート直後は原文に戻す手順や差分バックアップを用意してください。

ファイルと配置

• 日本語化は通常、ゲームの言語設定ファイル（.json/.xml/.po/.mo など）またはリソースアーカイブ（.pak/.assets）を変更することで行われます。パッチは既存ファイルの上書きか、ゲーム起動時に読み込む追加ファイルの導入どちらかです。
• 導入前に必ず元ファイルのバックアップを取り、元に戻せるようにしてください。
• 権限の問題でパッチが適用できない場合は、管理者権限での実行やセーブ場所の確認を行ってください。

文字表示とフォント

• 日本語表示ではフォントに全角文字が含まれていることが必須です。英語用フォントのみだと文字化けや豆腐文字（□）が出ます。
• 行間・文字数制限：UI は英語基準で設計されていることが多く、日本語は横幅を取りやすいためテキストがはみ出すことがあります。翻訳時は簡潔な表現にする、改行を調整するなどでUI崩れを防いでください。
• 縦書きや特殊なルビは通常サポートされません。ルビを使う代わりに注記を括弧で表記してください。

翻訳の品質管理と用語統一

• 用語集（用語集をプロジェクト単位で保持）を作成して統一した訳語を使用してください。ゲームの固有名詞、スキル名、アイテム名は原則として固定訳を採用します。
• 画面内のボタンやショートカット表記は短く分かりやすい単語を優先してください（例：Confirm → 決定、Cancel → 戻る）。
• 長文化を避ける：説明文は箇条書きにするなどして読みやすさを維持します。

ローカライズ運用ルール

• 翻訳ファイルはバージョン管理（例：Git）で履歴を残し、誰がどの文字列を変更したか追跡できるようにします。
• 表記ルール（敬体／常体、カタカナ表記、英数字の全角半角ルール）をプロジェクトで統一し、スタイルガイドを作成します。
• 機密情報・個人情報：レビューやテストで実際の個人情報を用いないでください。コミュニティ版でコメントや問い合わせに個人情報入力を求める実装がある場合、利用目的を明示し、必要最低限に留める規約を明示します。

テストとQA

• UIテスト：各解像度、各フォントサイズで表示崩れがないか確認します。特にボタン・ツールチップ・ログ表示を重点検証します。
• 内容テスト：ゲーム内のチュートリアルやクエスト文が実際の操作と齟齬がないかをプレイテストで検証します。
• 回帰テスト：ゲーム本体のアップデート後に日本語表示が維持されているか確認します。アップデートでテキストキーが変更されると翻訳が外れます。

コミュニティ配布に関する注意

• 非公式日本語化を配布する場合、著作権や利用規約に抵触しない形式で提供してください。配布方法は差分パッチや外部言語フォルダの追加が安全です。
• 配布時は導入手順、元ファイルのバックアップ手順、非対応バージョンの警告を明記してください。
• 配布物に個人情報の収集機能を組み込まないでください。問い合わせフォームやコメント機能で個人情報を収集する場合は利用目的を明確にし、必要最小限に留めます。

よくある問題と対処

• 文字化け／豆腐文字：日本語対応フォントが正しく導入されていないため。フォントの置換またはゲームのフォント設定を確認する。
• テキスト切れ／UI崩れ：翻訳を短くする、改行を挿入する、UI側の幅を広げる（可能なら）で対応する。
• アップデートで翻訳が消えた：バックアップから復元後、差分を当て直す。恒久対策として翻訳スクリプトを自動化してテンプレートを保守する。
• 翻訳ミスのクレーム：変更履歴を示して誰がどの訳を当てたかを明示し、誤訳は速やかに修正してパッチを配布する。

用語例（運用上の推奨訳）

• Confirm → 決定
• Cancel → 戻る
• Settings → 設定
• Inventory → 所持品 / インベントリ（プロジェクトで統一）

用語はプロジェクトの用語集に登録して一貫性を保ってください。

最後に（運用フローの提案）

• 1. 原文抽出 → 2) 翻訳（用語集参照）→ 3) レビュー（複数名）→ 4) UI組み込み → 5) プレイテスト → 6) 配布／デプロイ、というワークフローを確立することを推奨します。
• 公式対応がない場合の非公式パッチは、導入手順と戻し方を明確にし、ユーザー保護（バックアップ推奨・セキュリティチェック）を最優先にしてください。