Troubleshoot

Troubleshooting Guide

Common issues and their solutions when using NexusBot.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émon 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.