環境、CPU構成、Dusklight版、描画API、正確なエラー、最後の変更を記録します。セーブと設定を保存し、同じ検証済みダンプを現在のクリーンアプリ、Modなしで試します。アプリ、データ、ドライバー、設定、第三者ファイルを分けられます。
すべての症状を別のROM取得や全データ削除で直そうとしません。公式手順は自分の対応GameCube版ダンプを必要とし、不明な代替ファイルは法的、安全性、互換性の問題を増やします。
Dusklight トラブルシューティングの最後に原因、動作版、成功したAPIや設定、置換ファイルを記録します。任意変更を一つずつ戻しバックアップを残します。説明できない一度の起動より再現可能な解決が重要です。
- 現在の安定版
- v1.4.1
- 最初の確認
- 正しいCPU構成
- 推奨API
- D3D12、Vulkan 1.1+、Metal
- ゲームデータ
- 対応GameCube版ダンプ
- 初期化前
- セーブと設定を保存
- クリーン試験
- Mod・テクスチャなし
Dusklightが開かない・すぐ終了する
無反応は誤CPUビルド、不完全展開、Linux実行権限不足、遮断・破損ダウンロード、非対応描画から始まることが多いです。ゲームダンプを変える前に公式v1.4.1の名前と構成を確認します。
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と向きを確認します。
- 操作不能なら保存済み設定を戻します。
初期化前にセーブと利用者データを保護
セーブと設定の場所は環境、パッケージ、データ方式で異なります。確認した公式情報に全環境共通パスがないため、Windows、Android、Linux、macOS、iOSの固定場所を推測しません。
アンインストール、フォルダー削除、Androidデータ消去、署名iOSアプリ置換前に、導入先と利用者領域を調べてコピーします。他OSや古いDusk版の検索結果は一致しない場合があります。不明なら公式コミュニティへ確認します。
- 全環境で実行ファイル横とは限りません。
- 実験前に可能性のある利用者フォルダーをコピーします。
- バックアップ内のファイルを確認します。
- モバイルデータ消去を最初にしません。
- ポータブル・標準方式があれば記録します。
有用なDusklight不具合報告を作る
版、OS、CPU構成、GPU、ドライバーまたはOS版、描画API、必要ならゲーム版、Mod有無、再現手順、実際の結果を記載します。クリーン環境でも起こるかを明示します。
著作権データ、機密を含むセーブ、巨大な未整理ログを載せません。公式テンプレートが許す最小の文章、画像、ログを使い、GitHubを検索してから報告します。
- 版と正確なリリースファイル名。
- 環境、CPU、GPU、描画API。
- クリーン版とMod版の結果。
- 再現手順と期待・実際の違い。
- 保護データを含まない短いログ。
- v1.4.1修正を確認したか。
Dusklight トラブルシューティングのよくある質問
開かない理由は?
環境、CPU構成、完全展開、AppImage権限、モバイル署名、推奨描画APIを確認します。
RVZ・ISOが動かない理由は?
非対応、不完全、転送・変換破損が考えられます。検証済みGameCube元データからやり直します。
セーブ場所は?
環境とパッケージで異なります。削除前に可能性のある場所を保存し、現在の公式案内を確認します。
AMD GPUで遅い理由は?
一部AMD Windows性能回帰を直したv1.4.1以降へ更新し、ドライバー、D3D12、Vulkan、Modなしを試します。
画面テクスチャがない理由は?
v1.4.1はv1.4.0の読み込み順と画面欠落を修正しました。更新しパックを外します。
再導入ですべて消しますか?
最初には行いません。データを保存し、壊れた環境を比較用に残して別のクリーン版を試します。
2026年7月21日に確認した情報源: Dusklight 公式サイト, 公式導入ガイド および TwilitRealm GitHub リポジトリ.