Common Setup Mistakes

These are the most frequent setup-related mistakes when using the on-screen joystick system. Please check these points before reporting a bug.

• No EventSystem in the UI:
  Without an active EventSystem, joysticks will not register input.
• Incorrect UI hierarchy:
  The joystick handle must be a direct child of the joystick background. Otherwise, references cannot be set automatically.
• Touch Area too small or misplaced:
  Finger movement is only detected within the defined TouchArea. Check its size and placement.
• Overlapping finger input:
  If multiple joysticks share screen space, one may block the other. Ensure each joystick has its own input zone.
• Mixing input systems:
  Do not mix devices (e.g., gamepad + keyboard) on the same joystick. Use a consistent input source.
• Incorrect Joystick Identifier:
  Set the correct Identifier in the Inspector. Otherwise, input will be ignored.