Dusklight Wikiダウンロード・導入ガイド
日本語

接続・割り当て・クリーンテスト

Dusklightのコントローラー設定

USBまたはBluetoothのゲームパッドを接続し、OSで認識できることを確認してからPort 1へ割り当てます。認識、ボタン配置、Steam Input、ジャイロの問題をセーブデータを消さずに切り分けます。

トラブルシューティングを読む
デスクトップゲームに接続されたゲームコントローラーの概念イラスト
実際のDusklight画面ではない概念イラストです。具体的な確認手順は本文で説明します。
要点:Dusklightにコントローラーを接続する方法

最初はUSBで接続し、Windows、Linux、macOS、Android、Steam Deckのいずれかでデバイスが認識されることを確認します。追加のリマッパーを閉じ、Dusklight内でPort 1へ割り当てたら、十字キー、左右スティック、各ボタン、Start、肩ボタン、トリガーを順番にテストします。

認識しない場合は、OS、Steam Inputなどの入力変換層、ゲーム内設定の3層に分けて調べます。OSに表示されないデバイスはゲーム内のボタン設定だけでは直りません。複数の変換層が同時に動くと、二重入力やボタンの入れ替わりが起きます。

コントローラー設定のためにセーブデータやTwilight Princessのゲームデータを削除する必要はありません。アプリ、ユーザーデータ、自分で用意した対応ゲームデータを分けたまま、1つずつ条件を変えて確認してください。

最初のテスト
USBケーブル
プレイヤー枠
Port 1
入力変換層
一度に1つ
クリーン状態
Modとラッパーなし
ゲームデータ
含まれません

コントローラーを接続し、デバイス層を確認する

最初は直接USB接続にして、ペアリングやモード変更の前にDusklightを終了します。ケーブル接続なら、電池、無線ペアリング、スリープ状態という変数を減らせます。XInput、DInput、各機種のモード切替がある場合は、最初に選んだモードを記録してください。

ゲームを起動する前に、OSのデバイス画面または信頼できるゲームパッドテスターで、ボタンと両方のスティックが反応するか確認します。BluetoothはUSBで動作した後に試す方が安全です。別の端末に接続されたまま、または別プロファイルで表示されることがあるためです。

入力変換層は1つだけにします。Steam Input、メーカーのユーティリティ、デスクトップのリマッパー、Dusklightが同じ機器を同時に処理すると、二重ボタンや軸の誤認識が起きます。

  1. USBで接続データ通信に対応したケーブルを使い、OSの検出が完了するまで待ちます。
  2. デバイスを確認ゲーム外で十字キー、スティック、ボタン、肩ボタン、トリガーを試します。
  3. モードを1つ選択純正モードまたは1つの変換層だけを使います。
  4. Dusklightを起動OSで安定して表示された後に、クリーンな設定を開きます。
コントローラー、ホストOS、ゲーム入力を順番に確認する概念図
概念的な診断フロー:コントローラー、ホスト機器、ゲーム内マッピングの順に確認します。

Port 1へ割り当て、重要なボタンからテストする

1人用なら、動作しているコントローラーをPort 1へ割り当て、古い割り当てを消してから設定します。十字キーとスティック、続いて各ボタン、Start、肩ボタン、トリガーの順に登録します。すべてが別々に反応してからプロファイルを保存します。

Xbox、PlayStation、Switch型では、同じ物理位置でも表示される文字や記号が異なります。別のガイドのラベルではなく、マッピング画面の入力と再現できるゲーム場面の動作を基準にしてください。

Switch Pro、DualShock、8BitDoは、ホストや選んだモードによって入力方式が変わることがあります。ボタンが逆なら、モードか変換層を1つだけ変更して再テストし、競合するプロファイルを重ねないでください。

  • 2台目を接続する前に、物理コントローラー1台だけをPort 1へ割り当てます。
  • デッドゾーンを変更する前に、スティックの中央とトリガーの範囲を確認します。
  • 動作したモードを記録し、アップデートや再ペアリング後に比較します。
  • 変換層が必要なら、その依存関係をメモしておきます。
デバイス例最初に試す方法確認する点
XboxまたはXInputパッドまずネイティブのXInput経路を試します。同じパッドを再公開する別のリマッパーを重ねないでください。
Switch ProまずUSBで試し、有線プロファイルが動いてからBluetoothをペアリングします。Steam Inputやホスト側で表示レイアウトが変わることがあります。
DualShockまたはDInputパッドデバイス名を確認し、必要なら変換層を1つだけ使います。重複デバイスや入れ替わったボタンを確認します。
8BitDoパッド1つのモードを選び、変更後にもう一度テストします。同じハードウェアでも異なるプロトコルで認識されることがあります。
再現可能なゲーム場面でコントローラー入力を試す公式Dusklightゲーム画面
TwilitRealmの公式プロジェクトメディア。再現可能な場面で割り当てた入力を確認します。

Dusklightがコントローラーを認識しないとき

OSに表示されない場合は、再ペアリング、別のデータケーブルやUSBポート、スリープ解除、別のホストとの接続解除を確認します。OSには表示されるのにDusklightだけが認識しない場合は、ゲームを終了して仮想デバイスや重複したラッパーを無効にし、Port 1をクリーンな状態で試します。

一部のボタンだけが動く場合は、入力モード、Port 1のプロファイル、軸を変換する別レイヤーを確認します。ジャイロだけが使えないこともあり、通常のボタンが動くかどうかとは別の機能として扱います。

Steam Deckやデスクトップのショートカットでは、実際に起動している実行ファイル、コントローラーモード、Steam Input設定を動作したテストと比較します。アップデート後は最小構成から戻し、Bluetooth、カスタムマッピング、Mod、テクスチャを1つずつ追加します。

  1. 表示されないケーブル、電池、ペアリング、USBポート、スリープ、別ホストを確認します。
  2. 2つ表示される余分な仮想デバイスやラッパーを無効にして、入力経路を1つにします。
  3. ボタンが逆モードまたはプロファイルを1回だけ変更し、同じ操作を再テストします。
  4. アップデート後に失敗クリーンテストを行い、以前のプロファイルと動作版を比較します。
  5. アップデートで入力が使えなくなった新しい版をクリーンにテストし、以前のプロファイルと比較して、ロールバック用に前の版を残します。

Modを戻す前にクリーンな入力テストを行う

信頼できる比較では、変更前後でアプリのバージョン、ゲームデータ、場面、グラフィック設定をそろえます。テクスチャ、カスタム上書き、仮想コントローラー、実験的なマッピングを使わず、メニュー、Port 1、短い再現可能な場面、正常終了を確認します。

基準が動いたら、変数を1つずつ戻します。Bluetoothと新しいマッピング、ModとSteam Inputを別々に試してください。プラットフォーム、モード、バージョン、症状を記録してから、再現可能な問題を公式プロジェクトへ報告します。

アップデート中にファイルを守る必要がある場合は、セーブバックアップガイドを利用してください。このページは入力の検出と割り当てを扱うもので、Twilight Princessの著作権付きゲームデータを提供しません。

  • メニュー、スティック、ボタン、肩ボタン、トリガー、ポーズ、終了を確認します。
  • 変更ごとに同じ場面を繰り返します。
  • 新しい設定が安定するまで、動作したプロファイルとアプリを残します。
  • 個人のセーブやゲームデータを問題報告に添付しません。

Dusklightコントローラーのよくある質問

Dusklightがコントローラーを認識しないのはなぜですか?

まずOSに表示されるか確認します。USBで基準を作り、重複したラッパーを無効にし、1台をPort 1へ割り当てます。OSでは見えるのにDusklightで使えない場合は、入力モードと仮想デバイス層を確認してください。

DusklightでTwilight Princessにコントローラーを接続する方法は?

接続後にゲーム外で確認し、Dusklightを開いてPort 1へ割り当てます。再現可能な場面で十字キー、スティック、ボタン、肩ボタン、トリガー、ポーズを試し、最初はModやテクスチャを使いません。

Switch Proコントローラーは使えますか?

ホストとコントローラーのモードによってUSBまたはBluetoothで使える場合があります。USBから試し、OSで確認し、入力層を1つにしてから表示されるボタン配置をチェックしてください。

一部のボタンだけ動く場合は?

入力モード、Port 1のプロファイル、重複した仮想デバイス、誤った軸割り当てを確認します。一度に1つだけ変更してください。ジャイロは独立して使えないことがあります。

アップデート後に入力が止まった場合は?

新しい版を同じゲームデータとクリーンな設定で試し、以前のプロファイルと入力モードを比較します。安定するまで以前のアプリを残しておくと安全です。

コントローラーの代わりにキーボードとマウスを使えますか?

利用しているプラットフォームと現在の版で安定して使える入力方法を選んでください。ゲームパッドからキーボードとマウスに切り替える場合は、テスト中に2つのデバイスが同じ操作を送らないよう、Port 1の古いプロファイルを分けるか消去します。

2026年8月6日に確認した情報: TwilitRealm公式サイト, Dusklight GitHubリポジトリ, Dusklightの問題追跡, TwilitRealmのインストールガイド.