トラブルシューティング
IwashiIME の利用中に発生するよくある問題と、その解決策をまとめています。
インストール・コンパイルエラー
The type or namespace name 'Koyashiro' could not be found というエラーが出る
原因: 依存アセットである GenericDataContainer がプロジェクトに導入されていないか、正常にインストールされていません。
解決策:
インストール ページを参照し、GenericDataContainer を導入してください。
既に導入済みの場合は、VCC (VRChat Creator Companion) で「Update」を行ったり、Re-import を試してみてください。
[UdonSharp] Assets/IwashiAssets/Iwashiime/Runtime/Scripts/Udon/IwashiimeManager.cs(358,36): Udon runtime exception detected! というエラーが出る
原因: 使用している IwashiIME のバージョンが v1.0.0（初期リリース版）である可能性があります。
このバージョンには特定の条件下でエラーが発生する不具合が含まれています。
解決策: 最新バージョンへのアップデートをお願いいたします。 BOOTH より最新のパッケージをダウンロードし、プロジェクトへインポートして更新してください。
動作・挙動の問題
QWERTYキーボード等でローマ字入力ができない（ひらがなに変わらない）
原因: IwashiIME のキーボード上で 「全角/半角」の切り替え を行っており、半角入力モード になっている可能性があります。
解決策:
キーボード盤面にある 「全角」ボタンを押して、入力モードを ローマ字入力 に切り替えてください。
半角入力モードの状態では、キーを叩いてもローマ字からひらがなへの変換処理がスキップされ、そのまま英数字が入力されます。
TMP_InputField で「入力完了時」のイベントが実行されない
原因: 現在の VRChat の仕様（不具合）により、標準キーボード を使用している場合、TMP_InputField の OnEndEdit イベントが発火しないという問題があります。
解決策:
現状では、標準キーボード利用時にこのイベントを確実に受け取る手段はありません。
IwashiIME のキーボード（VR用）を使用している場合は正常に動作します。
デスクトップモード等の標準キーボード入力を必須とする場合は、OnValueChanged で入力を監視するなどの代替手段を検討するか、VRChat 側の修正を待つ必要があります。
詳細については コールバック のページも併せてご確認ください。
キーボードが表示されない
原因:
- 入力欄（InputField）に
KeyboardOpenerコンポーネントがアタッチされていない。 KeyboardOpenerのIs VR Only設定が有効になっている。（デスクトップモードでは開きません）- 再生時・ビルド時の参照の自動解決に失敗している。
解決策:
- 対象の InputField に
KeyboardOpenerが正しく設定されているか確認してください。 - デスクトップでも表示させたい場合は
Is VR Onlyのチェックを外してください。VR専用でよい場合は、VRモードで確認してください。 - コンソールを確認し、
IwashiimeBuildProcessでエラーが発生していないか確認してください。
改行を含んだ文字列を入力しても改行が消えてしまう
原因: 対象の InputField の Line Type 設定が Single Line になっているため、改行コードが自動的に削除されています。
解決策:
Unity エディタ上で対象の InputField (または TMP_InputField) コンポーネントを選択し、Line Type を Multi Line Submit または Multi Line Newline に変更してください。
OnSubmit などの UI イベントが設定しても消えてしまう
原因: 実行しようとしている UI イベントの中に、VRChat で許可されていないコンポーネントやメソッドが含まれている可能性があります。
VRChat の仕様により、リストの中に1つでも許可されないイベントが混じっていると、そのリスト全体のイベントが消失します。
解決策: イベントリストを確認し、許可されていない UI イベントを呼ぼうとしていないか確認してください。許可されていないイベントを削除することで、他の正常なイベントが動作するようになります。
表示の問題
文字が「□（豆腐）」や「？」に文字化けする
原因: 日本語フォントが表示できない状態です。依存アセットの Fallback Font が導入されていない可能性があります。
解決策:
インストール ページを参照し、TextMesh Pro VRC Fallback Font JP を導入してください。
導入後も直らない場合は、TextMesh Pro の設定ファイル（TMP Settings）で、Fallback Font Assets のリストに日本語フォントが含まれているか確認してください。
テーマ・カスタマイズ関連
一部のボタンにテーマ色が反映されない
原因: テーマの適用処理が実行されていないか、対象オブジェクトの設定が不足しています。
解決策:
ThemeManagerのインスペクタにある Apply Theme ボタンを押してください。- それでも解決しない場合、そのオブジェクトにアタッチされている
ThemeMarkerの設定が正しいか確認してください。
プリセットを変更しても色が変わらない
原因: インスペクタ上でプリセットを変更しただけでは、シーン内のオブジェクトには反映されません。
解決策:
プリセット変更後に、必ず Apply Theme ボタンを押して反映させてください。
また、上記と同様に ThemeMarker の設定も併せて確認してください。
カスタムプリセットが認識されない
原因: JSON ファイルの保存場所が間違っているか、ファイル自体が破損している可能性があります。
解決策:
- カスタムテーマの JSON ファイルが正しいフォルダに保存されているか確認してください。
- JSON ファイルの記述に誤りがないか確認し、必要であれば再度書き出し（Export）を行ってください。
設定した色と違う色（濃い色など）になる
原因: Selectable（ボタン本体）と Graphic（見た目の画像や文字）の両方にテーマ色が二重に適用されている可能性があります。
解決策:
カスタマイズ ページを参考に、ThemeMarker の Graphic フィールドに対象のコンポーネント（Image や Text）が正しく設定されているか確認してください。
追加したオリジナル配列に切り替えられない
原因: シーン上に複数の IwashiIME.prefab が配置されており、設定内容が正しく反映されていない可能性があります。
- 一部の
IwashiIMEにしか設定を行っておらず、ビルド時の自動解決プロセスによって、設定済みの個体が削除されてしまっている。 - 設定済みの個体が「固定表示（Is Fixed Mode）」になっており、InputField から呼び出される側の個体が未設定のままシーンに残っている。
解決策: オリジナル配列の設定を確実に反映させるには、以下のいずれかの方法をとってください。
- プレハブアセット自体を編集する: プロジェクトウィンドウにある
IwashiIMEプレハブを開き、KeyboardManagerで配列を設定して保存してください。 - Prefab Variant を使用する: 設定済みの
IwashiIMEを別途 Prefab Variant として保存し、シーン内の固定表示用も含め、すべてその Variant を配置するようにしてください。
辞書・ネットワーク関連
変換候補が出ない / ずっと読み込み中のままになる
原因: 辞書データのダウンロードに失敗しているか、データが破損している可能性があります。 ネットワークが不安定な場合や、VRChat のセキュリティ設定により通信がブロックされている場合によく発生します。
解決策:
VRChat の設定メニューを開き、Allow Untrusted URLs の設定が有効になっているか確認してください。
有効にした上で、一度ワールドに入り直す（Rejoin）ことで改善する場合があります。
「辞書ファイルのロードに失敗しました。」と表示される
原因: 辞書ファイルを取得するための通信に失敗しました。
IwashiIME は Allow Untrusted URLs の設定が無効な状態では独自サーバーではなく GitHub 上のリポジトリから辞書データを取得しています。
その為、ネットワーク環境や状況によってはアクセスが弾かれている可能性があります。
解決策:
上記と同様に、VRChat 側の Allow Untrusted URLs を有効にしてから入り直してみてください。
また、一時的な回線不調の可能性もあるため、時間を置いて再試行してください。
それでも解決しない場合
上記を確認しても問題が解決しない場合や、新たな不具合を発見された場合は、お手数ですが以下の窓口よりご連絡ください。
BOOTH のお問い合わせフォーム からメッセージを送信してください。
（※購入履歴の確認のため、必ず購入したアカウントからお問い合わせをお願いいたします）