Citronトラブル解決ガイド
Citronエミュレータが落ちる・黒い画面になる？ここから確認
クラッシュ、黒画面、起動失敗、描画の乱れ、コントローラー入力の欠落、更新後の回帰を、症状ごとのチェックリストで切り分けます。
要点：設定を変える前に、どの層が失敗しているかを特定する
Citronエミュレータがクラッシュしても、ゲームの互換性が原因とは限りません。不完全なパッケージ、OSに合わないビルド、グラフィックドライバー、設定やキャッシュ、入力レイヤー、自分で用意した合法的なシステムファイル、特定ビルドの回帰などが考えられます。
黒い画面では、音声、メニュー、コントローラーが反応するかを最初に確認します。無音で固まるウィンドウと、ゲームが動作して描画だけ失敗している状態は別の分岐です。
StableとNightlyの結果を混ぜないでください。このガイドで確認したStableは2026-04-27、CIチャンネルの確認コミットは22d5038ecです。これは比較用の識別子であり、全ゲームや端末への保証ではありません。
一度に一つだけ変え、同じ短いテストを繰り返し、元の設定を保存します。そうすれば修正を確認しやすく、公式Issueにも再現条件を伝えられます。
症状に合う分岐から開始
Citronのトラブル解決：症状に対応する層を確認
最も影響の小さい確認から始めます。描画、キャッシュ、入力、ファームウェアを同時に変えると手掛かりが消えます。
| 層 | 最初の確認 | 重要な理由 |
|---|---|---|
| 起動またはパッケージ | OSに合うアセットを使い、展開・インストールを完了し、読み取りと実行ができるか確認する。 | 不足ライブラリ、違うアーキテクチャ、ブロックされたファイルはクラッシュに見える。 |
| ビルドまたはチャンネル | テスト前にStableのタグまたはCI/Nightlyのハッシュを記録し、別ビルドの結果を混ぜない。 | 修正や回帰は特定のバージョンに属するため。 |
| 描画またはドライバー | 標準バックエンドに戻し、GPUとドライバーを記録してから代替バックエンドを一つだけ比較する。 | 黒画面やテクスチャ破損はバックエンドやドライバー固有の場合がある。 |
| システムファイルと入力 | 自分の合法的なファイル、ゲームのパス、権限、コントローラー検出を確認し、配布パックは使わない。 | 不一致のファイル、読めないパス、二重入力は原因を誤認させる。 |
| 設定とキャッシュ | プロファイルをバックアップし、クリーン設定を試し、元の状態を保存してからキャッシュを再構築する。 | 古いキャッシュが原因でも、証拠を保存せず消すと検証できない。 |
再現可能な切り分け
Citronのクラッシュを5分で切り分けるテスト
一般的な起動問題と、描画・入力・コンテンツ・ビルド固有の問題を分ける手順です。症状が変わった時点で記録します。
一度再現する
ウィンドウ前、ロゴ後、音声だけの黒画面、フリーズ、入力なしなど、正確な症状を書く。
基準を記録する
タグまたはハッシュ、OS、GPUまたはチップセット、ドライバー、レンダラー、ゲーム更新、チャンネルを保存する。
標準値に戻す
プロファイルをコピーし、オーバーレイと実験的設定を無効にして同じテストを行う。
一つだけ変える
レンダラー、解像度、キャッシュ、入力レイヤー、プロファイルのうち一つだけを試す。
比較またはロールバック
更新後に発生したなら、保存したビルドまたは確認済みStableで同じテストを比較する。
安全に証拠を残す
Citronが動かない時に記録する情報
多くの場合、短いメモで十分です。再起動やロールバック後に同じテストを再現できるよう、元のログ、設定バックアップ、ビルド識別子をまとめて保管します。
個人のパス、トークン、私的なダンプ、保護されたシステムファイルは公開しないでください。Issueにはプロジェクトが許可する最小限の安全なログだけを添付します。
次のようなフォルダー名はテストを分けるための例であり、サイトがCitronのコンテンツを配布することを意味しません。
- 正確なタグまたはコミットとテスト日。
- OS、端末、GPUまたはチップセット、ドライバー、レンダラー、電源モード。
- ゲームのバージョン、DLC/mod、最後に成功した画面、再現回数。
- 設定バックアップと再テスト前に行った一つの変更。
Citron-troubleshooting/test-01/整理用の例です。トラブル解決ページからログ、鍵パック、ファームウェア、ROM、再梱包インストーラーをダウンロードしないでください。
保守的な変更
Citronのどの設定を最初に変えるべきか
仮説を確認できる最小の変更だけを行い、悪化したら元の値に戻します。
| 項目 | 最初は | 変更する条件 |
|---|---|---|
| グラフィックバックエンド | プラットフォームの標準 | 黒画面が再現し、ログがレンダラーを示す場合。 |
| 解像度 | ネイティブまたは1x | 基準が安定し、性能を測る場合。 |
| シェーダー/キャッシュ | 現在のビルドに作成させる | 別ビルド由来または破損が疑われる場合。 |
| プロファイル | バックアップ後にクリーン設定 | クリーン設定で症状が変わる場合。 |
| コントローラー | 一つのマッピングレイヤー | Steam Inputやリマッパーが二重入力する場合。 |
| Stable/Nightly | Stableを基準にする | 公式の関連修正をNightlyで検証し、戻せる場合。 |
症状に合わせて次を試す
Citronのクラッシュと黒画面でよくある分岐
これは診断の分岐であり、保証ではありません。各結果にビルドと環境を添えてください。
ウィンドウが出る前にCitronが落ちる
プラットフォーム用アセット、展開、アーキテクチャ、OSブロック、依存関係、クリーンプロファイルを確認します。
次の確認： 公式リリースを使い、単純なローカルパスへ展開し、オーバーレイを切って再試行する。
Citronが黒画面になる
固まった無音ウィンドウか、音声や入力が動いているゲームかを分けます。レンダラー、ドライバー、キャッシュ、ファイル、回帰が似た症状を作ります。
次の確認： 最後に成功した画面を記録し、標準グラフィックに戻して確認済みバックエンドまたはビルドを一つ比較する。
音声はあるが映像がない
プロセスは動作しながら描画経路だけ失敗することがあります。GPU、ドライバー、バックエンド、解像度、メニューの応答を記録します。
次の確認： ネイティブ解像度と別レンダラーを試し、一つの黒画面だけで非対応と判断しない。
コントローラーが見えない・二重入力になる
まずOSの検出を確認します。Steam Input、仮想コントローラー、複数プロファイルが重なることがあります。
次の確認： 重複レイヤーを無効にし、再接続して一つの直接プロファイルで試す。
更新後に動いていた設定が壊れた
ビルド、ゲーム、ドライバー、キャッシュ、プロファイルが変わった可能性があります。Nightlyは修正と回帰の両方を含みます。
次の確認： 保存したビルドまたはStable 2026-04-27で同じテストを比較する。
キャッシュやログのエラーが出る
メッセージは手掛かりであり、すべてを消す指示ではありません。プロファイルを残し、同じビルドのキャッシュか確認します。
次の確認： バックアップを取り、該当キャッシュだけを再構築して起動を繰り返す。
トラブル解決の質問
Citronエミュレータのクラッシュ FAQ
Citronエミュレータが何度もクラッシュする理由は？
ビルド、ドライバーやレンダラー、プロファイルやキャッシュ、入力レイヤー、自分のファイル、回帰などが候補です。症状を記録し、一つずつ確認します。
Citronの黒画面を直すには？
音声や入力を確認し、ビルドとレンダラーを記録し、ネイティブ解像度と標準値に戻して、確認済みバックエンドまたはビルドを比較します。
シェーダーキャッシュを削除するべき？
先にプロファイルを保存します。同じビルドの破損が疑われる場合だけ再構築し、すべてを削除して証拠を失わないようにします。
クラッシュ修正にはStableとNightlyのどちら？
まずStableを基準にします。公式の理由がある時だけNightlyを試し、戻せるよう完全なハッシュを残します。
鍵やファームウェアで黒画面は直る？
自分の正しいファイルが設定エラーを解決することはありますが、互換性や描画不具合を保証するものではありません。配布パックは使わないでください。
Citron Neo Wikiは公式サポートですか？
いいえ。公開された公式リリースやIssueへのリンクを整理する独立ガイドで、エミュレーター、ゲーム、鍵、ファームウェアをホストしていません。
一次情報
クラッシュを回帰と判断する前に確認する情報源
リリース識別子、アセット、現在のIssueを比較してください。一次情報だけでローカル再現テストの代わりにはなりません。
- 公式Stable release 2026-04-27このガイドの基準として確認したStableとリリースノート。
- 公式Citron CI releasesプラットフォーム別Nightlyハッシュの比較に使うページ。
- 公式エミュレーターIssueハードウェア、ドライバー、ビルド、ログ、再現手順を比較する。
- Citron互換性ガイドエミュレーターは起動し、ゲーム固有の問題を調べる時に使う。