PokéBot NDS

This repository is dedicated to creating a multi-purpose automated tool for the mainline DS Pokémon games. The bot can perform most monotonous tasks in these games, with all languages supported.

Reported Issues and donations are very appreciated, as making this project widely compatible as the sole developer takes a lot of time and work.

Getting Started

Prerequisites

You'll need to install node.js, and have a recent version of BizHawk or DeSmuME in order to use this tool.

Installation

Recommended: Install Github Desktop and locally clone this repository to stay up to date with the latest versions of the bot. (You can also clone the dev branch to preview upcoming features)

Alternatively, download the latest release as a .zip archive and extract it anywhere you like.

Setup

Start the dashboard with start-dashboard.bat, or run these commands inside the dashboard/ folder:
- npm i
- npm start
Use the dashboard's Config tab to customise the bot behaviour for your current task.
Open your emulator's Lua Console, and load pokebot-nds.lua.
- BizHawk: Tools > Lua Console
- DeSmuME: Tools > Lua Scripting > New Lua Script Window

The game will then be connected to the dashboard, which you can view info for on the Dashboard tab. The bot will immediately start acting according to your Config, and log any encounters to the dashboard.

Bot Modes

	DPPt	HGSS	BW	B2W2
Starter resets	✅	✅	✅	✅
Random encounters	✅	✅	✅	✅
Phenomenon encounters			✅	✅
Gift resets	✅	✅	✅	✅
Static encounters	✅	✅	✅	✅
Fishing	✅	✅	✅	✅
Egg hatching	✅	✅	✅	✅
Headbutt Trees		✅
Thundurus/Tornadus dex resets			✅
Hidden Grottos				✅

Additional Features

	DPPt	HGSS	BW	B2W2
Auto-catching	✅	✅	✅	✅
Auto-battling	✅	✅	✅	✅
Thief farming	✅	✅	✅	✅
Pickup farming	✅	✅	✅	✅
Voltorb Flip		✅

Special Thanks

The contributors of BizHawk and DeSmuME for providing a basis to make this project possible
40 Cakes for the Gen III PokéBot that originally inspired this project
evandixon for demystifying the NDS Pokemon format

wyanido / pokebot-nds

readme