Dusklight Gyro-Steuerung & Maussteuerung — Vollständige Einstellungsanleitung

Gyro-Steuerung oder Maussteuerung in Dusklight einrichten. Alle 10 Input-Einstellungen erklärt — direkt aus dem Quellcode, mit plattformspezifischen Empfehlungen.

Veröffentlicht 2026-05-10 ·Aktualisiert 2026-06-16

Dusklight unterstützt sowohl Gyro-Steuerung (bewegungsbasiertes Zielen über einen Controller mit Gyroskop) als auch Maussteuerung (eingeführt in v1.0.0-rc.1). Das ist eines der wichtigsten Upgrades gegenüber dem originalen GameCube-Release — Bogen- und Schleuder-Zielen mit modernen Präzisionskontrollen.

Die Mausunterstützung ist inzwischen weit über das reine Zielen hinausgewachsen: v1.4.0 ergänzt Maussteuerung für die Third-Person-Kamera und Maus-/Touch-Unterstützung für In-Game-Menüs (über die Einstellung „Mouse/Touch in Menus” umschaltbar). v1.4.0 bringt außerdem natives Telefon-Gyro auf Android und iOS — Mobile-Spieler brauchen damit keinen Gyro-Controller mehr.

Diese Anleitung ist gegen src/dusk/ui/settings.cpp auf dem main-Branch verifiziert — jeder Einstellungsname und jeder helpText ist direkt aus dem Quellcode übernommen.

Wo die Einstellungen zu finden sind

Einstellungen → Input → Gyro

Dieser Bereich enthält 10 separate Einstellungen (verifiziert verbatim):

Gyro Input Method — Sensor oder Mouse
Gyro Aim — Umschalter
Gyro Rollgoal — Umschalter
Gyro Pitch Sensitivity — Schieberegler
Gyro Yaw Sensitivity — Schieberegler
Rollgoal Sensitivity — Schieberegler
Gyro Deadband — Schieberegler
Gyro Smoothing — Schieberegler
Invert Gyro Pitch — Umschalter
Invert Gyro Yaw — Umschalter

Gyro Input Method — Sensor vs. Mouse

Das ist der wichtigste Schalter. Zwei Modi:

Sensor-Modus

Liest Bewegungsdaten direkt vom Gyroskop/IMU des Controllers. Schnell, niedrige Latenz, keine Übersetzungsschicht. Das willst du bei:

DualShock 4 / DualSense
Switch Pro Controller
8BitDo Pro 2 / Ultimate
Steam Deck (LCD oder OLED)
Jedem anderen Controller mit nativem Gyro

Mouse-Modus (eingeführt in v1.0.0-rc.1)

Behandelt den konfigurierten Input als virtuelle Maus und nutzt Mausbewegung als Zielsignal. Aus den v1.0.0-rc.1-Release-Notes (verbatim):

„Added Mouse input for ‘gyro source’ (mouse aiming)”

Nutze den Mouse-Modus wenn:

Du wirklich mit der Maus zielen willst (PC + Tastatur/Maus-Setup)
Du Gyro über Steam Inputs „Gyro to Mouse”-Funktion leitest (z. B. auf dem Steam Deck, wenn du diesen Workflow bevorzugst)
Ein Controller dessen Gyro nicht nativ von Dusklight erkannt wird, aber Steam Input ihn lesen kann

⚠️ Nicht beides gleichzeitig aktivieren. Wenn du den nativen Sensor-Modus in Dusklight aktivierst und gleichzeitig Steam Inputs Gyro-to-Mouse für denselben Controller, kämpfen die Inputs gegeneinander.

Empfehlungen je Plattform

Windows Desktop (ohne Steam)

Sensor-Modus — DualShock / DualSense / Pro Controller / 8BitDo Pro 2 verbinden sich per Bluetooth oder USB, und Dusklight liest das Gyro direkt
Mouse-Modus — für Tastatur + Maus Spieler

Windows Desktop (über Steam)

Sensor-Modus für native niedrige Latenz
Mouse-Modus, wenn du bereits in ein Steam-Input-Gyro-to-Mouse-Profil investiert hast

macOS

Sensor-Modus für DualShock 4/5, Switch Pro Controller (iOS 16+ und macOS 13+ unterstützen das)
Mouse-Modus für Tastatur+Maus, aber Achtung: Tastatur-Binding ist aktuell auf macOS kaputt (#830)

Linux Desktop

Sensor-Modus — Linuxs hid-nintendo- und hid-playstation-Kernel-Module stellen das Gyro dem Userspace zur Verfügung; Dusklight erkennt es

Steam Deck

Sensor-Modus für das native IMU des Decks — empfohlen
Nicht mit Steam-Input-Gyro-to-Mouse doppeln

Android

Sensor-Modus — Bluetooth-Controller mit Gyro (8BitDo Pro 2, DualSense) funktionieren
Ab v1.4.0 wird das eigene Gyro (und Rumble) des Telefons nativ unterstützt — ein Gyro-Controller ist nicht mehr nötig

iOS

Sensor-Modus — DualShock 4/5 per Bluetooth gekoppelt, Switch Pro Controller per Bluetooth (iOS 16+) und 8BitDo Pro 2
Ab v1.4.0 wird das eigene Gyro (und Rumble) von iPhone/iPad nativ unterstützt — ein Gyro-Controller ist nicht mehr nötig

Jede Einstellung erklärt

Gyro Aim (Umschalter)

Der Hauptschalter. Aus = kein Gyro-Einfluss auf das Zielen. Ein = Gyro trägt zur Zielrichtung bei.

Gyro-Effekte sind nur aktiv, wenn du wirklich zielst (Bogen, Schleuder, Adlerauge usw.) — Dusklight wendet Gyro nicht auf Kamera oder Bewegung während des normalen Spiels an.

Gyro Rollgoal (Umschalter)

„Rollgoal” bezieht sich auf das Murmel/Kugel-Rollminispiel (Plumms Dorfminispiel, die Rollstufen). Dieser Schalter aktiviert Gyro speziell für dieses Minispiel.

Gyro Pitch Sensitivity (Schieberegler)

Wie schnell sich das vertikale Zielen auf Gyro-Kippen nach oben/unten bewegt. Höher = schneller.

Gyro Yaw Sensitivity (Schieberegler)

Wie schnell sich das horizontale Zielen auf Gyro-Drehen nach links/rechts bewegt.

Rollgoal Sensitivity (Schieberegler)

Unabhängige Sensitivität für das Rollminispiel — du kannst also z. B. niedrige Pitch/Yaw-Sensitivität fürs Bogenschießen und hohe Sensitivität fürs Minispiel einstellen.

Gyro Deadband (Schieberegler)

Die Mindestmenge an Gyro-Bewegung, die als Input registriert wird. Höher = ignoriert kleines Handzittern; niedriger = reaktiver, aber empfindlicher. Erhöhe das, wenn dein Fadenkreuz leicht driftet, wenn du stillstehst.

Gyro Smoothing (Schieberegler)

Wie stark Dusklight den Input über die Zeit glättet. Höher = stabil, aber träge; niedriger = reaktiv, aber rauschiger.

Invert Gyro Pitch / Yaw (Umschalter)

Dreht die entsprechende Achse um. Nützlich, wenn deine bevorzugte Bewegungsrichtung vom Standard abweicht.

Empfohlene Startwerte

Das sind vernünftige Standardwerte — nach Geschmack anpassen:

Einstellung	Startwert
Gyro Input Method	Sensor (oder Mouse für Tastatur+Maus)
Gyro Aim	Ein
Gyro Rollgoal	Ein (wenn du das Minispiel spielst)
Gyro Pitch Sensitivity	50 %
Gyro Yaw Sensitivity	50 %
Rollgoal Sensitivity	50 %
Gyro Deadband	10–20 % (erhöhen bei Drift, senken wenn kleine Bewegungen nicht ankommen)
Gyro Smoothing	20 % (senken für Twitch-Präzision)
Invert Gyro Pitch	Aus
Invert Gyro Yaw	Aus

Das sind Orientierungswerte, keine Messungen — TwilitRealm hat kein empfohlenes Preset veröffentlicht.

Maussteuerung einrichten (PC Tastatur + Maus)

Wenn du Dusklight wie einen PC-Shooter spielen willst:

Einstellungen → Input → Gyro → Gyro Input Method → Mouse
Einstellungen → Input → Gyro → Gyro Aim → Ein
Aim/Fire über Einstellungen → Input → Controller → Configure Controller auf Maustasten legen (das Tastatur/Maus-Binding-System wurde in v0.6.2 hinzugefügt)
Gyro Pitch / Yaw Sensitivity nach Geschmack anpassen — im Mouse-Modus werden das die Maus-Sensitivitäten

⚠️ Das Tastatur-Binding auf macOS ist bei v1.0.0 kaputt (#830). Bis zum Patch einen Controller nutzen.

Häufige Gyro-Probleme und Lösungen

Fadenkreuz driftet, wenn man stillsteht

Gyro Deadband erhöhen. Wenn es weiter driftet, braucht das Gyro deines Controllers möglicherweise Kalibrierung — die Firmware-Tools des Herstellers prüfen.

Zielen fühlt sich zittrig / überempfindlich an

Gyro Smoothing erhöhen und Pitch/Yaw Sensitivity senken.

Zielen fühlt sich träge an

Gyro Smoothing senken.

Gyro reagiert gar nicht

Sicherstellen, dass Gyro Input Method auf Sensor steht (nicht Mouse)
Sicherstellen, dass Gyro Aim aktiviert ist
Prüfen, ob dein Controller-Gyro vom OS erkannt wird — ein anderes Spiel mit Gyro-Unterstützung außerhalb von Dusklight testen
Auf Steam Deck speziell: nicht gleichzeitig Steam-Input-Gyro-to-Mouse für denselben Controller aktivieren

Gyro funktioniert, aber nur manchmal

Gyro aktiviert sich typischerweise nur beim Zielen (Bogen/Schleuder). Während des normalen Spiels bewegt es die Kamera nicht. Sicherstellen, dass du den Aim-Button gedrückt hältst.

Gyro auf iPhone über Bluetooth-Controller

DualShock 4/5 stellen Gyro für iOS erst ab iOS 13 zur Verfügung. Der Switch Pro Controller stellt Gyro ab iOS 16 zur Verfügung. Ältere Geräte haben keine native Gyro-Unterstützung.

Gyro fühlt sich in verschiedenen Räumen anders an

Gyro-Messwerte können durch die Ruheposition des Controllers beim Koppeln beeinflusst werden. Wenn du den Standort gewechselt hast, Controller neu koppeln.

Einstellungspfade zusammengefasst (verbatim aus dem Quellcode verifiziert)

Ziel	Pfad
Zwischen Gyro und Maussteuerung wechseln	Einstellungen → Input → Gyro → Gyro Input Method
Gyro ein-/ausschalten	Einstellungen → Input → Gyro → Gyro Aim
Gyro für Rollminispiel	Einstellungen → Input → Gyro → Gyro Rollgoal
Gyro-Vertikalgeschwindigkeit einstellen	Einstellungen → Input → Gyro → Gyro Pitch Sensitivity
Gyro-Horizontalgeschwindigkeit einstellen	Einstellungen → Input → Gyro → Gyro Yaw Sensitivity
Handzittern-Input reduzieren	Einstellungen → Input → Gyro → Gyro Deadband
Gyro-Reaktion glätten	Einstellungen → Input → Gyro → Gyro Smoothing
Gyro-Vertikalachse umkehren	Einstellungen → Input → Gyro → Invert Gyro Pitch
Gyro-Horizontalachse umkehren	Einstellungen → Input → Gyro → Invert Gyro Yaw