Skip to content

Troubleshoot

Jump to bottom
Gemini CLI edited this page Apr 11, 2026 · 3 revisions

Troubleshooting Guide

Common issues and their solutions when using DudeBot.NET.

Connection Issues

"Failed to connect to device."

This error occurs when the bot cannot reach your Nintendo Switch.

  • Check IP Address: Ensure the IP address entered in the Settings tab matches the one shown on your Switch (Settings > Internet).
  • Verify sys-botbase: Ensure you have sys-botbase or usb-botbase installed on your Switch. You should see a blue light (on some versions) or be able to ping the Switch from your PC.
  • Firewall: Make sure your PC's firewall isn't blocking the application. Try disabling it temporarily to test.
  • Network: Ensure both the PC and the Switch are on the same local network.

Bot stays in "Connecting..." indefinitely

  • Restart the sys-botbase service by rebooting your Switch.
  • Check if another application (like Tesla overlay or another bot) is already using the connection.

In-Game Setup Issues

Bot is clicking but nothing happens

  • Text Speed: Ensure in-game Text Speed is set to Fast.
  • Casual Controls: For SWSH, ensure Casual Controls are Disabled.
  • Location: The bot usually expects you to be in the Overworld (not in a menu) before starting.
  • Controller Type: Ensure the bot is set to the correct controller type (usually Pro Controller) in the settings.

Trading Errors

  • Box 1: Most routines expect the bot to start in Box 1, Slot 1.
  • Internet Connection: Ensure your Switch is connected to the Internet (Link Trade requires Y-Comm/Poké Portal to be online).
  • Nintendo Switch Online: A valid NSO subscription is required for online trading.

Discord Bot Issues

"Discord connection lost"

  • Check your internet connection.
  • Verify your Discord Bot Token in config.json.
  • Ensure the bot has the necessary permissions (Message Content Intent must be enabled in the Discord Developer Portal).

Commands not responding

  • Verify the CommandPrefix in config.json (default is $).
  • Check the Channel Whitelist settings to ensure the bot is allowed to respond in that channel.
  • Ensure the user has the required Roles (e.g., RoleCanTrade) assigned in Discord.

Logging & Debugging

If you encounter an issue not listed here:

  1. Check the Logs tab in the WinForms application.
  2. Look into the /logs folder in the bot directory for detailed error reports.
  3. Join the support Discord for further assistance.

Clone this wiki locally