You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: Wiki/SetupGuide/Controllers/Controller-sys-botbase.md
+26-28Lines changed: 26 additions & 28 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,5 +1,7 @@
1
1
# Controller Setup: sys-botbase
2
2
3
+
***Update August 9, 2025: This guide has been updated for sys-botbase 3 (sbb3).***
4
+
3
5
This sys-botbase setup is intended for experienced CFW (custom firmware) Switch users who want to try out our computer-control (CC) programs without buying all the additional hardware that is needed.
4
6
5
7
If you do not have CFW (and are thus starting from scratch), we [recommend going back](../README.md#the-controller-the-computers-hands) and choosing one of the other controller options as they are more reliable than this option. You do not need CFW or sys-botbase to run CC programs. Likewise, the CC programs only use sys-botbase for its controller. It does not touch any of its "hacking" features like reading and modifying game memory.
@@ -33,11 +35,20 @@ Make sure you have everything else setup so that it looks like this:
33
35
34
36
If not, you should go back to the [general setup guide](../README.md) and start over.
35
37
36
-
### Step 1: Install sys-botbase and ldn-mitm
38
+
### Step 1: Install ldn_mitm
39
+
40
+
1. Download and unzip ld-mitm: https://github.com/Lusamine/ldn_mitm/releases/latest
41
+
2. Copy the contents into the root of your SD card.
42
+
43
+
### Step 2: Install sys-botbase 3 (sbb3)
44
+
45
+
1. Download and unzip sbb3: https://github.com/PokemonAutomation/sys-botbase-cpp/releases/latest
46
+
2. Copy the contents into the root of your SD card.
37
47
38
-
If you are reading this, you probably already have these setup. If not, [here's the guide](https://github.com/kwsch/SysBot.NET/wiki/Bot-Startup-Details).
48
+
Note that this is sys-botbase 3. This is an improved rewrite of the original sys-botbase that has additional features required by CC to achieve maximum performance and stability.
49
+
sbb3 is backwards compatible with the official sys-botbase (sbb2) aside from the removal of the ACNH features. So you should be able to still use all your existing programs that rely on sbb2.
39
50
40
-
### Step 2: Navigate your Switch to where it will accept a new controller.
51
+
### Step 3: Navigate your Switch to where it will accept a new controller.
41
52
42
53
sys-botbase will create a virtual wired controller that behaves like a real controller. So it can only connect if your Switch is ready for it.
43
54
@@ -48,18 +59,18 @@ Places where the Switch will accept a new controller:
48
59
49
60
<imgsrc="../Images/GripMenu.png">
50
61
51
-
### Step 3: Connect to the Switch
62
+
### Step 4: Connect to the Switch
52
63
53
64
1. At the top for the "Controller" option, click the dropdown and select `TCP: sys-botbase` .
54
-
2. Enter the IP address and port of your Switch. (e.g. `192.168.1.123:6000`)
65
+
2. Enter the IP address and port of your Switch. (e.g. `192.168.1.123:6000`) The port is always 6000 for all versions of sbb to date.
55
66
56
67
If everything worked correctly, it will look like this:
You can control your Switch from the keyboard. Click on the video display to activate the keyboard controls. Then try pressing some buttons. You can view the keyboard -> controller mapping by clicking on the "keyboard layout" at the bottom left corner of the program.
65
76
@@ -69,7 +80,7 @@ The default layout is the standard WASD setup for FPS games on the most common Q
If keyboard commands are working (along with video and audio), you are done!
75
86
@@ -100,7 +111,7 @@ These are standard network connection issues. Common causes:
100
111
- Local connection is enabled and ldn-mitm is not enabled. This will block the network connection.
101
112
- You have dual-band wifi where your Switch is connected to one band while your computer is connected to the other.
102
113
103
-
Sometimes, an older connection does not shutdown properly causing new connections to fail (i.e. a zombie state). You can try undocking your Switch and going in/out of a game several times, similarly with airplane mode. Otherwise, you may need to reboot the Switch.
114
+
If all else fails, try undocking your Switch and going in/out of a game several times, similarly with airplane mode. Otherwise, you may need to reboot the Switch.
104
115
105
116
106
117
### Connected, but keyboard commands don't work.
@@ -115,11 +126,7 @@ Most programs will block keyboard inputs if the program is running. So if you ha
115
126
116
127
The response time is how long it takes to round-trip from your computer to sys-botbase and back. It will always be longer than a ping due to overhead within sys-botbase and/or Atmosphere.
117
128
118
-
It should be less than 5ms, but can occasionally spike to over 100ms during periods of high traffic. This is normal. But if it stays above 50ms, you will have difficulty running many of the programs. So you will want to fix this. (usually by improving your network connection)
119
-
120
-
Sometimes the Switch will get into a temporary slow state where this response time stays very high (> 100ms). This can usually be cleared by rebooting the Switch.
121
-
122
-
Overall, this is not great and is why sys-botbase is less reliable than the other (microcontroller) options which are usually <1ms latency.
129
+
High reponse time used to be a huge problem with sys-botbase 2.4. But starting from sys-botbase 3.0, it is less of an issue since it can buffer commands to retain timing precision.
123
130
124
131
### "Last Ack: xxx seconds ago"
125
132
@@ -132,17 +139,9 @@ This means the Switch has stopped responding to the computer's commands. The mos
sys-botbase lacks the timing precision that the Arduino can achieve. Therefore programs that require precise controller timings will not run reliably over sys-botbase and are therefore blocked from running. (we don't want people to file bugs when they run the program and it breaks)
136
-
137
-
The programs on the sidebar are color-coded on what controllers they can run on:
138
-
-**Blue:** Runs on all controllers with no issues.
139
-
-**Green:** Runs on all controllers, but will have degraded performance/reliability on imprecise controllers (such as sys-botbase).
140
-
-**Purple:** Only runs on precise controllers. (will not run on sys-botbase)
141
-
-**Red:** Specialized programs that only run on specific controllers. (will not run on sys-botbase)
142
-
143
-
Thus sys-botbase can only run blue and green programs. For everything else, you will need to use one of the [microcontroller setups](README.md#the-controller-the-computers-hands).
142
+
If you are seeing this message, it means you are running sys-botbase 2.x. This version of sys-botbase lacks the timing precision needed to run many of our programs.
144
143
145
-
If you are a sysmodule developer and are interested in fixing sys-botbase, please hit us up in [Discord](https://discord.com/channels/695809740428673034/709201831066206268) to discuss. We think we know what the problem is and we have ideas on how to fix it. But we have neither the expertise nor the developer bandwidth to do it ourselves.
144
+
Please upgrade to sys-botbase 3.0 or later.
146
145
147
146
148
147
### Multi-Switch programs don't work.
@@ -154,11 +153,6 @@ There is no general solution to this. For some programs, you may be able to work
154
153
Using ethernet instead of wireless does not solve this problem as local communication mode will kill this as well.
155
154
156
155
157
-
### usb-botbase
158
-
159
-
usb-botbase is (generally) not an option because it requires the same USB port that is needed for the HDMI output.
160
-
161
-
162
156
163
157
164
158
@@ -185,3 +179,7 @@ usb-botbase is (generally) not an option because it requires the same USB port t
| Currently does not work on Switch 2. | Works on Switch 2. | Does not work on Switch 2 due to lack of CFW. |
102
102
| Cheapest and easiest to setup for the average user. | More expensive. Also easy to setup if you pick ESP32-S3. Others are harder to setup. | Requires a hacked Switch running custom firmware (CFW). |
103
-
| Can run LGPE programs.<br>Cannot run Sword/Shield day-skippers.<br>Runs all other programs.*| Cannot run LGPE programs.<br>Runs all other programs.*|Cannot run LGPE programs.<br>Runs most other programs.*<br>Cannot run programs that require timing precision. |
104
-
| Fast and reliable for most programs. | Fastest and most reliable. Best for high-speed programs (date-spam exploits, FCE). | Runs most programs well. Slow and unreliable for high-speed programs. |
103
+
| Can run LGPE programs.<br>Cannot run Sword/Shield day-skippers.<br>Runs all other programs.*| Cannot run LGPE programs.<br>Runs all other programs.*|sbb3: Identical to wired controllers.<br>sbb2: Cannot run programs that require timing precision. |
104
+
| Fast and reliable for most programs. | Fastest and most reliable. Best for high-speed programs (date-spam exploits, FCE). |sbb3: Identical to wired controllers.<br>sbb2: Runs most programs well. Slow and unreliable for high-speed programs. |
105
105
| Not recommended for remote access.<br>Not recommended for high density setups due to wireless interference. | Very good for remote access.<br>Very good for high density setups. | Not recommended for remote access. |
106
106
| Recommended for all users including beginners. | Recommended for users who want maximum performance and reliability. | Recommended for regular CFW users who want to try CC programs with minimal investment. |
107
107
@@ -193,3 +193,4 @@ Here are some misc. tips/tricks, and other hidden features of the CC programs!
0 commit comments