/pokebot-nds

Primary LanguageLuaMIT LicenseMIT

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.

ko-fi

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

  1. Start the dashboard with start-dashboard.bat, or run these commands inside the dashboard/ folder:
    • npm i
    • npm start
  2. Use the dashboard's Config tab to customise the bot behaviour for your current task.
  3. 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