Skip to content

USB botbase

berichan edited this page Oct 25, 2021 · 8 revisions

USB functionality works on Android, with experimental native support for Windows, OSX and Linux. The code is heavily based on NHSE's USB injection functionality, which I also wrote, but no longer uses Libusbdotnet.

USB functionality is great because you can visit an island using local network play and inject and throw a bunch of cool things like gold/nmts/fossils or anything else you'd like on the floor and leave them there. I use this to transfer items from my offline atmosphere console to my mariko online console all the time, but I am not responsible if you get banned for this.

You will firstly need to download and install USB-botbase from https://github.com/Koi-3088/USB-Botbase/releases to your console, no driver or library is required on your Android device as this functionality is handled by the app. On Windows, you will need to follow the setup instructions on the USB-botbase page minus pyusb which is NOT required. On MacOSX you will simply need to install libusb by opening the terminal and running the command brew install libusb

For Android only:

  1. You will need an Android device that supports USB Host Mode (OTG). I have yet to find a modern device that doesn't support this, but this stackexchange question might help you figure out if yours does or doesn't: https://android.stackexchange.com/questions/36887/how-can-i-determine-if-my-device-has-usb-host-mode-otg-support

  2. You will need a USB A-to-C cable with an OTG adapter, I'm not sure if this works with MicroUSB so if you do check then please let me know. Most adapters are $2-$4.

This is a picture of my Android setup; the OTG hub side goes into the Android device:

Usage

Go into the Settings (gear in the top left corner) of the app and change the injector protocol to UsbBotAndroid or UsbBot, then close the Settings panel by pressing x in the top right corner.

Next, connect your console to your device

  • On an Android device using the USB A-to-C cable with the OTG adapter, with the adapter side in your Android device. This popup will show up within the app:

Hit "OK" then, press "Search for USB" in the bottom left corner. If everything is successful then the "Read USB" and "Write USB" buttons will become active:

The "No connection active" red text will remain, this is normal as there shouldn't be a network connection active. You may read and write to your inventory as normal, it's totally normal for the first read/write to take a little longer than subsequent read/writes.

Clone this wiki locally