Dusklightがブラックスクリーンになる、起動しない、またはデバイス未割り当てと表示する場合は、OS、CPUアーキテクチャ、v1.4.1かどうか、グラフィックバックエンド、正確なメッセージ、最後に変更した項目を記録します。セーブと設定をバックアップし、同じ検証済みゲームダンプを使ってModなしのクリーンなビルドを試してください。アプリ、データ、ドライバー、権限、設定のどこに原因があるかを分けられます。
すべての症状を別のROM取得や全データ削除で直そうとしません。公式手順は自分の対応GameCube版ダンプを必要とし、不明な代替ファイルは法的、安全性、互換性の問題を増やします。
Dusklight トラブルシューティングの最後に原因、動作版、成功したAPIや設定、置換ファイルを記録します。任意変更を一つずつ戻しバックアップを残します。説明できない一度の起動より再現可能な解決が重要です。
- 現在の安定版
- v1.4.1
- 最初の確認
- 正しいCPU構成
- 推奨API
- D3D12、Vulkan 1.1+、Metal
- ゲームデータ
- 対応GameCube版ダンプ
- 初期化前
- セーブと設定を保存
- クリーン試験
- Mod・テクスチャなし
Dusklightのブラックスクリーン・起動失敗・即終了
ブラックスクリーンや無反応の起動は、CPUに合わないビルド、展開不足、Linux AppImageの実行権限不足、ブロックされたファイル、未対応のグラフィック経路、古い設定から起こります。アーキテクチャとリリース名を確認し、ゲームデータやユーザーファイルを削除する前にクリーンなビルドで試してください。
WindowsはZIPを完全展開、LinuxはAppImageへ権限を付け端末起動、macOSはApple siliconとIntelを区別、モバイルはARM64と署名・導入状態を確認します。
| 症状 | 最初の分類 | 非破壊の対処 |
|---|---|---|
| Windowsで無反応 | 誤ビルド・展開 | システム種類と再展開 |
| AppImageが開かない | 権限・保存先 | chmod +xとnoexec確認 |
| macOSが拒否 | CPU・出所 | ビルドと公式元を確認 |
| Android導入失敗 | ARM64・容量・APK | 公式APKを再取得 |
| iOSが開かない | 署名・更新 | AltStore・iloader確認 |
ゲームファイルを拒否・見つけられない
現在の公式文書は利用者が用意する対応GameCube版ダンプを必要とします。Wiiイメージ、不完全読み取り、転送破損、変換失敗、圧縮内のままのファイルは失敗します。再変換や移動前に元データを検証します。
有効なISOはDolphinやnodtoolでRVZへ変換できます。RVZが失敗したら検証済みISOと比較して再実行します。別ファイルを無作為に取得、拡張子だけ変更、地域や版を同一視しません。
- 対応元を確認現在文書とGameCube版を使います。
- 元ダンプを試す読み取りエラーなしを確認します。
- 転送をやり直すケーブルや保存先で破損する場合があります。
- 変換をやり直す検証済み元データから行います。
- 単純なパスを使う診断中は名前と場所を固定します。
描画、テクスチャ、性能を修正
WindowsはD3D12・Vulkan、Linuxと対応AndroidはVulkan、AppleはMetalから始めます。GPUドライバーを更新し、第三者テクスチャを外します。D3D11とAndroid OpenGL ESは限定対応です。
v1.4.1はテクスチャ回帰、一部AMD Windows GPUの性能、PowerVRの4:3固定、バックエンド切り替えを修正しました。古い報告を現在版と比較します。
- v1.4.1以降か確認します。
- 推奨APIとクリーン設定を使います。
- GPUドライバー・モバイルOSを更新します。
- テクスチャと上書きを無効にします。
- 発熱や電力低下時は重い設定を下げます。
- 同じ場面で比較します。
コントローラー、キーボード、タッチを修正
最初にOS側で入力機器を確認し、Dusklight内では一つずつ設定します。Steam Input、再割り当て、アクセシビリティ表示、複数機器が二重・競合入力を作る場合があります。
v1.4.1はAndroid・iOSのキーボードフォーカス、クローショットとHawkeyeのタッチ、非表示メニュー入力を修正しました。古い版の不具合に合わせて全設定を作り直す前に更新します。
- 最初は余分なコントローラーを外します。
- OSが機器を認識するか確認します。
- 複雑な操作前にメニューを試します。
- 比較時はSteam Inputを一時無効にします。
- モバイルはv1.4.1と向きを確認します。
- 操作不能なら保存済み設定を戻します。
初期化前にセーブと利用者データを保護
公式FAQは現在、Windowsの%APPDATA%/TwilitRealm/Dusklight、macOSの~/Library/Application Support/TwilitRealm/Dusklight、Linuxの~/.local/share/TwilitRealm/Dusklightを案内しています。その下で地域に合うUSA/Card AまたはEUR/Card Aを使用します。モバイルのアクセス方法はOSと導入方法で異なります。
アンインストール、Androidデータ削除、iOSアプリの置き換え、設定初期化の前にDusklightを終了し、ユーザーデータ全体をコピーしてください。バックアップ、Dolphin GCI移行、地域確認、更新後の復旧はセーブデータガイドを参照してください。
- 全環境で実行ファイル横とは限りません。
- 実験前に可能性のある利用者フォルダーをコピーします。
- バックアップ内のファイルを確認します。
- モバイルデータ消去を最初にしません。
- ポータブル・標準方式があれば記録します。
有用なDusklight不具合報告を作る
版、OS、CPU構成、GPU、ドライバーまたはOS版、描画API、必要ならゲーム版、Mod有無、再現手順、実際の結果を記載します。クリーン環境でも起こるかを明示します。
著作権データ、機密を含むセーブ、巨大な未整理ログを載せません。公式テンプレートが許す最小の文章、画像、ログを使い、GitHubを検索してから報告します。
- 版と正確なリリースファイル名。
- 環境、CPU、GPU、描画API。
- クリーン版とMod版の結果。
- 再現手順と期待・実際の違い。
- 保護データを含まない短いログ。
- v1.4.1修正を確認したか。
Dusklight トラブルシューティングのよくある質問
Dusklightがブラックスクリーンになる、または起動しないのはなぜですか？
プラットフォームとCPUビルドを確認し、デスクトップファイルを完全に展開し、LinuxではAppImageに実行権限を付け、モバイルのパッケージや署名を確認します。最新ドライバーで推奨グラフィックAPIを試し、画面が黒くなる段階を記録してから複数の項目を変えてください。
RVZ・ISOが動かない理由は？
非対応、不完全、転送・変換破損が考えられます。検証済みGameCube元データからやり直します。
Dusklightでデバイス未割り当てと表示されるのはなぜですか？
まずクリーンな現行ビルドで試し、必要なデバイスやプラットフォーム権限が有効か確認します。テストに必要な入力やサービスだけを再接続し、セーブと設定のバックアップを残したまま、最初から全データを消去することは避けてください。
AMD GPUで遅い理由は？
一部AMD Windows性能回帰を直したv1.4.1以降へ更新し、ドライバー、D3D12、Vulkan、Modなしを試します。
画面テクスチャがない理由は？
v1.4.1はv1.4.0の読み込み順と画面欠落を修正しました。更新しパックを外します。
再導入ですべて消しますか？
最初には行いません。データを保存し、壊れた環境を比較用に残して別のクリーン版を試します。
2026年7月29日に確認した情報源： Dusklight 公式サイト, 公式導入ガイド および TwilitRealm GitHub リポジトリ.