So migriert ihr von Unitys altem Input Manager zum Input System, ohne die Steuerung zu zerstören
Kurz und knapp
Migriert euer Unity-6-Projekt vom alten Input Manager auf das Input System, ohne Spielersteuerung, UI oder übrige Input-Aufrufe zu zerbrechen.
Ihr installiert das Input System, drückt auf Play, und Unity wirft einen Fehler: Ihr versucht, Input mit der UnityEngine.Input-Klasse zu lesen, aber Active Input Handling zeigt bereits auf das Input System Package. Oder der Play Mode startet, und das Pausenmenü reagiert auf keinen einzigen Klick mehr.
Dieser Artikel zeigt eine sichere Reihenfolge für die Migration eines bestehenden Unity 6 Projekts vom alten Input Manager zum neuen Input System, ohne Steuerung oder UI zu zerstören. Lasst beide Backends an, ersetzt eure Input-Aufrufe, repariert das EventSystem und schaltet den alten Manager erst ab, wenn noch alles funktioniert. Die Schritte folgen der offiziellen Input System Dokumentation vom 20. November 2026. Installiert das aktuelle Input System Package aus dem Package Manager. Fixiert keine Paketversion aus diesem Artikel, weil neuere Releases folgen werden.
Warum in Unity 6 migrieren
Unitys Handbuch behandelt den eingebauten Input Manager mittlerweile als Legacy-Feature. Er ist deprecated, wird für neue Projekte nicht empfohlen, und Unity sagt, dass er in einer zukünftigen Version des Editors entfernt wird. Der alte Manager bleibt verfügbar, damit bestehende Projekte weiterlaufen können. Ein geplanter Wechsel ist trotzdem besser, als zu warten, bis ein zukünftiges Upgrade das alte Backend für euch entfernt.
Lasst beide Backends während der Migration an
Wenn euer Projekt das Input System noch nicht enthält, öffnet Window > Package Manager, wechselt zur Unity Registry und installiert das Input System Package. Ab Unity 6.1 fügen manche Projektvorlagen es bereits hinzu. Leere Projekte oft nicht.
Während der Installation fragt Unity, ob die Input System Backends aktiviert und die Input Manager Backends deaktiviert werden sollen. Wenn ihr Yes wählt, startet der Editor mit nur dem neuen System neu. Jeder übrige Input.GetAxis- oder Input.GetButton-Aufruf schlägt dann fehl, und uGUI-Menüs, die noch das alte Input-Modul verwenden, versagen mit ihnen.
Stellt das Backend stattdessen selbst ein. Geht zu Edit > Project Settings > Player, öffnet Other Settings und setzt Active Input Handling auf Both. Der Editor wird neu starten. In diesem Modus definiert Unity sowohl ENABLE_LEGACY_INPUT_MANAGER als auch ENABLE_INPUT_SYSTEM, sodass alter und neuer Code nebeneinander laufen können.
#if ENABLE_INPUT_SYSTEM
// New Input System backends are enabled.
#endif
#if ENABLE_LEGACY_INPUT_MANAGER
// Old Input Manager backends are enabled.
#endif
Behandelt Both als Brücke. Lasst es an, bis eure eigenen Skripte, das EventSystem und alle Drittanbieter-Assets umgezogen sind. Wechselt erst zu Input System Package (New), nachdem Play Mode und ein Build ohne die Exception und mit funktionierender UI laufen.
Ersetzt GetAxis und GetButton durch Actions
Der empfohlene Workflow ist, benannte Actions zu lesen, nicht rohe Gerätetasten. Sofern ihr nicht mehr als ein Action-Asset braucht, weist ein einzelnes Asset als projektweite Actions zu.
Öffnet Edit > Project Settings > Input System Package und erstellt oder weist die standardmäßigen projektweiten Actions zu, falls keine gesetzt sind. Die Standardeinstellungen enthalten eine Player-Map und eine UI-Map mit Actions wie Move (ein Vector2-Wert) und Jump, bereits gebunden für Tastatur, Maus, Gamepad, Touch und XR. Ihr erreicht sie über InputSystem.actions. Sie sind standardmäßig aktiviert und werden beim Start vorgeladen, und im Editor bei jedem Eintritt in den Play Mode.
Findet jede Action einmal, lest sie dann jeden Frame. Die Action jedes Mal per Name zu suchen, wie Input.GetAxis("Horizontal") es tat, ist der langsame Pfad in der neuen API.
using UnityEngine;
using UnityEngine.InputSystem;
public class PlayerMovement : MonoBehaviour
{
InputAction moveAction;
InputAction jumpAction;
void Start()
{
moveAction = InputSystem.actions.FindAction("Move");
jumpAction = InputSystem.actions.FindAction("Jump");
}
void Update()
{
Vector2 move = moveAction.ReadValue<Vector2>();
if (jumpAction.WasPressedThisFrame())
{
// jump
}
}
}
Die Namen im UnityEngine.InputSystem-Namespace mappen auf die alten Aufrufe so:
Input.GetAxis("Horizontal")undInput.GetAxis("Vertical")werden zumoveAction.ReadValue<Vector2>()Input.GetButton("Jump")wird zujumpAction.IsPressed()Input.GetButtonDownwird zuWasPressedThisFrame()Input.GetButtonUpwird zuWasReleasedThisFrame()Input.GetKey(KeyCode.Space)wird zuKeyboard.current.spaceKey.isPressedInput.GetMouseButton(0)wird zuMouse.current.leftButton.isPressedInput.mousePositionwird zuMouse.current.position.ReadValue()
Zwei Details sind wichtig, wenn sich die Steuerung gleich anfühlen soll. Die Standard-Move-Action ist ein 2D-Wert, also werden die alten Horizontal- und Vertical-Achsen zu einem Vektor, nicht zwei Floats. Und ReadValue wendet keine alte Gravity- und Sensitivity-Glättung an, sodass eine Taste oder ein Button sofort ihren vollen Wert erreicht. Wenn eure Bewegung auf dieser Rampe beruhte, müsst ihr sie absichtlich nachbauen. Input.GetAxisRaw hat kein direktes Äquivalent. ReadUnprocessedValue() unterscheidet sich nur von ReadValue, wenn Prozessoren an die Action angehängt sind.
Direkte Gerätelesevorgänge wie Keyboard.current sind ein schneller Ersatz, nicht der langfristige Workflow, und das aktuelle Gerät kann null sein, wenn diese Hardware fehlt.
Ein paar ältere Input Manager Features hängen noch von eurer Unity-Version ab. Ab Unity 6.4 funktionieren MonoBehaviour-Mausereignisfunktionen wie OnMouseDown mit dem Input System. Bei früheren Unity 6 Releases tun sie möglicherweise nichts, sobald nur das neue Backend aktiv ist. Wenn euer Projekt Location, Compass oder Device Orientation verwendet, prüft die Input System Dokumentation für euren Editor, bevor ihr den alten Manager abschaltet. IMGUI (OnGUI) ist nicht kompatibel mit dem Input System, also muss ein so gebautes Debug-Menü möglicherweise auf Both bleiben.
Haltet die UI funktionsfähig
Wenn ihr Unity UI (uGUI) verwendet, braucht ihr immer ein Input-Modul auf dem EventSystem, um das Input System in die UI einzuspeisen. Das ältere StandaloneInputModule spricht noch mit dem Legacy Input Manager. Wenn Active Input Handling nur auf das neue Package gesetzt ist, ist dieses Modul eine häufige Quelle der UnityEngine.Input-Exception.
Wählt das EventSystem in der Szene aus. Wenn das Input System Package installiert ist, bietet der Inspector einen Button, der StandaloneInputModule durch InputSystemUIInputModule ersetzt. Das neue Modul kommt vorkonfiguriert mit Standard-UI-Actions. Wenn Active Input Handling bereits auf das neue Package oder auf Both gesetzt ist, fügt Unity das neue Modul auch automatisch hinzu, wenn ihr ein frisches uGUI-Element in die Szene platziert.
UI Toolkit ist anders. Ab Unity 2023.2, was Unity 6 einschließt, kann UI Toolkit die UI-Actions aus euren projektweiten Actions ohne extra Modul lesen. Ihr braucht InputSystemUIInputModule plus ein EventSystem, wenn UI Toolkit und uGUI die gleiche Szene teilen.
Wenn ihr auch die PlayerInput-Komponente verwendet, weist das gleiche Action-Asset sowohl PlayerInput als auch InputSystemUIInputModule zu und setzt das UI Input Module Feld auf PlayerInput. Dann treibt die gleiche Gerätezuweisung sowohl den Spieler als auch die UI an. Wenn eure Skripte Actions lesen, während PlayerInput in Benutzung ist, lest PlayerInput.actions, nicht InputSystem.actions, weil PlayerInput eine gefilterte Kopie für das Gerät jedes Spielers behält.
Die Exception und übrige Input-Aufrufe
Der Runtime-Fehler lautet normalerweise: InvalidOperationException: You are trying to read Input using the UnityEngine.Input class, but you have switched active Input handling to Input System package in Player Settings. Er erscheint, wenn Active Input Handling auf Input System Package (New) gesetzt ist und etwas noch UnityEngine.Input aufruft.
Lest den Stack Trace, bevor ihr zufällige Skripte ändert. Er beginnt oft in StandaloneInputModule oder BaseInput.GetButtonDown, nicht in eurer Bewegungsklasse. Nachdem ihr das EventSystem repariert habt, durchsucht euren eigenen Code nach Input.GetAxis, Input.GetButton, Input.GetKey, Input.GetMouseButton und Input.mousePosition. Dann prüft Drittanbieter-Assets und Plugins. Active Input Handling zurück auf Both zu setzen ist ein gültiger temporärer Schritt. Die dauerhafte Lösung ist, den Aufrufer zu migrieren oder das Plugin zu aktualisieren.
Wann PlayerInput sich lohnt
Die PlayerInput-Komponente ist optional. Fügt sie hinzu, wenn ihr Send Messages (OnJump, OnMove(InputValue value)), Invoke Unity Events oder einen PlayerInputManager für lokalen Multiplayer wollt. Ein Singleplayer-Spiel, das bereits in Update pollt, kann bei FindAction und ReadValue bleiben.
Eine kurze Migrations-Checkliste
- Installiert das aktuelle Input System Package aus dem Package Manager, setzt dann Active Input Handling auf Both.
- Erstellt oder weist die standardmäßigen projektweiten Actions zu.
- Ersetzt eure eigenen
Input-Aufrufe. Findet jede Action einmal, lest sie dann jeden Frame. - Wenn ihr uGUI verwendet, ersetzt
StandaloneInputModuledurchInputSystemUIInputModuleund klickt euch mit einer Tastatur und einem Gamepad durch die Menüs. - Prüft
OnMouse-Events, Touch, Location, Compass und IMGUI gegen eure Unity-Version. - Aktualisiert Plugins, die noch
UnityEngine.Inputaufrufen, oder lasst Both an, bis eine Lösung existiert. - Wenn Play Mode und ein Build ohne die Exception und mit funktionierender UI laufen, setzt Active Input Handling auf Input System Package (New).
Bevor ihr diesen letzten Schalter umlegt, spielt Bewegung, Menüs und On-Screen-Buttons durch. Input ist ein clientseitiges Engine-Thema. horizOn ist ein Game-Backend mit einem Unity SDK für Accounts, Cloud Save, Leaderboards und In-Game-News. Die Migration des Input Systems ändert nicht, wie ihr dieses SDK verwendet, und es ersetzt oder umhüllt Unitys Input-Stack nicht.