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.
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 mismatched DLLs or a bad config.json.
- Remove your extra
PKHeX.Core.dllandPKHeX.Core.Automod.dllfiles; you should only be using these if you are willing to risk problems with development builds. - You may have to delete config.json and redo your settings if your problem is not with DLLs. 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.
Updates frequently require changes to the program. 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 "Field not found" or "Method not found" every time I try to trade.
Ensure that you have the latest commit. Remove any PKHeX.Core.dll or PKHeX.Core.AutoMod.dll files in the SysBot.exe directory; these should only be added if you want to risk unstable development builds. SysBot.exe already contains stable versions of these DLLs.
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. - 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. Remove these cores when a new stable PKHeX/SysBot.NET is released.
- 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. Remove these pkl files when a new stable PKHeX is released.
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, you may need to remove everything in the atmosphere/contents folder except for sys-botbase (and ldn_mitm if running SWSH). Once you have made those changes, reboot your Switch and try again.
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 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 can happen on spotty internet. 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.
Seed checking only returns an error about z3.
Review the guide and ensure that you have installed z3 properly. Make sure you have the correct version and you have unblocked the dlls. You may need to check that you have the most recent Visual C++ Redistributable installed. In rare cases, you may need to take ownership of the dlls on a Windows PC (Google how to do this).
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).
My bot keeps ending up in Union Circle or Raids.
My bot keeps accidentally opening the News in the Poké Portal.
My bot is having trouble loading and orienting itself in the Poké Portal.
Make sure you are on the latest release. Do not put your character in a town. Stand on the beach where you fight Nemona or out at sea where you do not have a lot of surrounding objects. If you do not want to move your character or continue to have the problem, you can increase Timings > ExtraTimeLoadPortal, which will make each trade loop slower but should give you more time to load the Poké Portal to avoid a desync.
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 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.
- The unlock word is
dragonfly. Use the!unlockcommand in the #bot-testing channel with the secret word to gain access. (e.g. If you think the secret word ishawks, you would type!unlock hawks.)
- The unlock word is