Troubleshooting
This is a basic guide for common issues that users have with SysBot.NET. Read this page before asking for help. If your issue is listed here, you will be directed to read this page; we don't want to answer questions that are already answered!
Make sure you look at the Logs tab and check the entire log (scroll up) if you have errors.
The program also creates text logs in the logs folder which can contain more information. The file with no date on it is the current day's log.
Most problems should be immediately obvious from these two places.
You should also look at the Switch and see what is happening. It is very hard to know where things are going wrong if you only look at logs, and not at the actual screen.
I do not have CFW.
You are out of luck unless you are able to hack your Switch and install CFW. The rest of this guide will not be helpful to you until you solve this problem.
I am not on the latest commit, or my program is not fully updated.
Many issues people have are already fixed on more recent builds. The most recent release is not the same as the most recent commit! You can build these yourself, or download the latest build from Project Pokémon. Please do not report issues unless you are on the latest commit. If you are using a fork, direct questions to the owner of the fork.
Nothing happens when I try to open SysBot.exe.
This is usually a problem with a bad config.json.
- Move your
config.jsonto a new folder, then open/close SysBot.exe to generate a new template. You can open your original in a text editor and copy values into the Hub to set up a new bot.
The game recently updated and now the program no longer works.
You should be getting an error in the logs about how the expected game version does not match. An older version of the program cannot know about a newer version of the game that came out after it. Wait for an update that fixes compatibility and then download the new version of the program from the usual place.
I am having an error about "Specified argument was out of the range of valid values (Parameter 'size')" when connecting.
This is happening because you are not on the latest version of sys-botbase or usb-botbase. Go to Bot Startup and find the link to the latest version. Restart your Switch after installing.
I am having an error about "Field not found" or "Method not found" every time I try to trade.
This should not be happening on stable releases. If you are running an unstable development build, your PKHeX.Core and Auto-Legality Mod are probably mismatched. Support is not provided for unstable development builds; troubleshoot these errors yourself, revert to the previous stable release, or wait for the next stable release.
I am unable to trade or generate a Pokémon that is newly released.
I do not know how to make new event Pokémon legal in SysBot.
- Ensure that you are on the latest commit of SysBot.NET.
- For new Mystery Gift Pokémon, follow the instructions for setting up
MGDBPathon Legality Settings. If the Pokémon is from Scarlet/Violet, you will need to update PKHeX.Core as well for the date legality restrictions. - For new Tera Raid Pokémon, you likely only need to update your PKHeX Core to UNSTABLE development builds, but do not do this unless you understand what you are doing.
- For new Pokémon GO Pokémon, you can build PGET and extract the pkl files to put in the same folder as SysBot.exe after building it yourself to get a folder full of separate files. This will not work with stable single-file releases.
I am seeing empty, garbage, or incorrect trainer data and trainer ID when I connect to SysBot.NET.
I am seeing language "Hacked" when I connect to SysBot.NET.
I am getting the error "Trainer data is not valid" when I start my bots.
The program told me to come here to fix my invalid trainer data problem.
When you first connect, the bot should display your trainer name and 6-digit trainer ID and then check your text speed and language. If you do not see this, this means your RAM is displaced, or you are running an old version of the program on a new update.
- RAM shifts are usually due to Edizon's cheat engine (even if no cheats are loaded), Tesla, CaptureSight, or layeredFS / game mods. You can temporarily disable all Atmosphère cheats by holding L while booting up the game to see if these are the problem; this will not fix the problem if the bot reboots your game. If you still cannot fix the problem after removing the known offenders, remove everything in the
atmosphere/contentsfolder except for sys-botbase (and ldn_mitm if running SWSH). Once you have made those changes, reboot your Switch and try again. - If the problem is that your program is out-of-date, you either need to figure out how to update it yourself or wait for a new release.
I instantly get a crash every time I try to connect or start a bot.
I get an error about something like SysBot.Base.SwitchSocketAsync.Read(Byte[] buffer).
I get an error about something like System.Net.Sockets.Socket.Connect(IPAddress[] addresses, Int32 port).
Please carefully review the Troubleshooting Connection Errors page.
I am getting the error "Provided Pokémon content is blocked from trading!" when I try to trade a specific Pokémon.
SysBot.NET has filters for ads, which include periods and certain URL and streamer suffixes. This is due to users using free SysBots to generate ads for their own streams/websites. This is intentionally strict due to abuse.
I have changed (some setting) but it is not working.
Close the program and restart it.
I see trainer data when I connect and the bot produces messages, but the game is not moving at all.
Dock your joycons and disconnect any extra controllers. It is also acceptable to disconnect all controllers entirely from the system menu. Check the Controller menu from Home screen and ensure that you see a Pro Controller (see below) at the bottom when the bot is activated. If you see "No other controllers are connected" after starting the bot, re-install sys-botbase or usb-botbase and restart your Switch.
The bot does not finish entering the Link Code, enters all 1's in the Link Code, or the Link Code doesn't match.
You may have a weak Wi-Fi connection. If your Wi-Fi network is unable to handle fast keypresses, increase the timing under Operation > Timings > KeypressTime. This will only affect the Link Code, not other button presses.
I am getting error messages on Discord such as "The server responded with error 403: Forbidden".
Your bot doesn't have permission to manage messages. The bot is attempting to clear trade requests and failing. You need to either set its permissions or re-invite your bot with permission to manage messages. Review the Discord Integration page.
I want to set my custom OT/TID/SID for the Pokémon created by the bot.
This should be in config. Alternatively, you can create a directory with pkm files from trainers in the games you want to use and link that in the hub. See the Link Trade bot page and Legality Settings pages for more information on ALM configuration.
I don't know how to get my TID16/SID16.
SysBot is not accepting my 6 digit TID in the config.
Review how to find and add your TID16/SID16 on the Legality > Custom Trainer Data page.
I put files in my Distribution directory but the bot can't find them or won't trade them.
Read the logs for errors (scroll all the way to the top). Check that:
- the files are legal,
- they can be Surprise Traded if you're trying to Surprise Trade,
- you are putting the files in a location where the bot has access (NOT OneDrive),
- you do not have ads in the Pokémon's nickname or OT,
- you have at least two unique trainer names,
- you have either restarted the program or used
$poolreloadafter adding new files.
Pokémon are generating with different IVs than specified.
Certain games have PID/IV correlation that must be respected for legality. If you want very specific IVs, you may need to alter your set to target different games, e.g. =Gen7=True for Stakataka so it generates from USUM rather than SWSH where Max Lair has Xoroshiro correlation. See this page for how Auto-Legality Mod generates Pokémon.
Pokémon I request as level 50 are generating at level 100.
This is intended behavior since formats that scale Pokémon to level 50 still allow Hyper-Training and moves learned after level 50. See this page for how Auto-Legality Mod generates Pokémon.
I am getting the error "Echo: Exception: TwitchLib.Client.Exceptions.BadStateException: Must be connected to at least one channel." on Twitch.
Your bot was slow to connect to Twitch when it tried to send an Echo. This should be fine as long as your bot connects eventually and responds.
The bot quits working midway through a routine randomly, but works other times.
My connection keeps dropping even though I have very fast/strong internet!!
Random changes in the routine are usually due to bad Wi-Fi connection to your router. This is not to be confused with your internet connection; you can have very fast internet but weak Wi-Fi locally in your home. Move the Switch closer to your router. Use usb-botbase if you do not have a stable connection with sys-botbase over Wi-Fi.
I am having trouble getting my bot to respond on Discord.
Go over the Discord Integration Troubleshooting section.
RaidBot keeps crashing whenever it opens the raid.
This is often a symptom of sideloading files via layeredfs. Read the Raid Bot page carefully.
I am getting an error like The type initializer for 'SysBot.Base.RecordUtil`1' threw an exception.
Somehow, the bot is failing to log trades to the text file in records. You can bypass the issue by starting over in a new folder, but please provide more information so we can handle this for other users.
My bot doesn't open the Y menu but presses other buttons.
You must have access to the Y menu first by beating the first gym and going downstairs in the Pokémon Center. This menu can only be opened while outside.
I get an error on startup about "Game" being out of range or it says the title is invalid.
This is a mismatch between the program and game. Ensure that you are on the latest version of SysBot.NET (re-download it to be sure) and you have updated the game to the latest online version. You should be running BDSP mode for BDSP (see Bot Startup).
People say they are receiving the wrong Pokémon from Ledy Distribution and everything else about my setup is correct.
Your game may be taking longer than expected to load the box. You can increase Timings > ExtraTimeOpenBox to give it more time to load the box.
My Switch keeps falling asleep even though I have AntiIdle on.
AntiIdle does not work for SV, because pressing B to keep the Switch awake exits the Poké Portal. You need to disable Sleep Mode in your Switch settings.
Read the SysBot.NET Wiki for the bot you are trying to run to be sure you are not missing anything else in the settings. Make sure you have rebooted your Switch.
- If these still don't resolve your issue, come to the ALM Discord linked on the repository's main page.
- Ask any SysBot.NET questions in #sysbot-net-help. You need to tell us what is happening in-game and what the logs say, if applicable, for us to troubleshoot. You can unlock access to this channel by reading very carefully. Asking for help in this channel is a confirmation that you know what is on this page. Please state what you have already tried on this page.
- The unlock word is
cardinalbut spelled backwards. Use the!unlockcommand in the #bot-testing channel with the secret word to gain access. (e.g. If you think the secret word ischerry, you would type!unlock cherry.)
- The unlock word is