Koolo

Koolo is a small bot for Diablo II: Resurrected. Koolo project was built for informational and educational purposes only, it's not intended for online usage. Feel free to contribute opening pull requests with new features or bugfixes.

Disclaimer

Can I get banned for using Koolo? The answer is a crystal clear yes, you can get banned although at this point I'm not aware of any ban for using it. I'm not responsible for any ban or any other consequence that may arise from it.

Features

Blizzard Sorceress, Nova Sorceress and Hammerdin are currently supported
Supported runs: Countess, Andariel, Ancient Tunnels, Summoner, Mephisto, Council, Eldritch, Pindleskin, Nihlathak, Tristram, Lower Kurast, Stony Tomb, The Pit, Arachnid Lair, Baal, Tal Rasha Tombs, Diablo (WIP), Cows
Bot integration for Discord and Telegram
"Companion mode" one leader bot will be creating games and the rest of the bots will join the game... and sometimes it works
Pickit based on NIP files
Auto potion for health and mana (also mercenary)
Chicken when low health
Inventory slot locking
Revive mercenary
CTA buff and class buffs
Auto repair
Skip on immune
Auto leveling sorceress and paladin (WIP)
Auto gambling

Requirements

Diablo II: Resurrected
Diablo II: LOD 1.13c (required by https://github.com/blacha/diablo2/tree/master/packages/map)

Quick Start

If you haven't done yet, install Diablo II: LOD 1.13c
Download the latest Koolo release, or alternatively you can build it from source
Extract the zip file in a directory of your choice.
Open config/config.yaml with your favorite text editor and ensure D2LoDPath config is pointing to your Diablo II: LOD 1.13c installation directory.
Configure custom bot settings under config/config.yaml and config/pickit/*.nip files for pickit rules.
Open Diablo II: Resurrected and ensure the game resolution is set to windowed mode and 1280x720 or 1920x1080 in HiDPI mode.
Enter the game with your character.
Run koolo.exe.

How it works

Koolo reads game memory and interacts with the game injecting clicks/keystrokes to the game window. It uses the following third party libraries:

https://github.com/hectorgimenez/d2go
https://github.com/hectorgimenez/diablo2 (forked from blacha's repo)

Development environment

Note: This is only required if you want to build the project from source. If you want to run the bot, you can just download the latest release.

Setting the development environment is pretty straightforward, but the following dependencies are required to build the project.

Dependencies

Building from source

Open the terminal and run the following commands in project root directory:

git clone https://github.com/hectorgimenez/koolo.git
cd koolo
build.bat

This will produce the "build" directory with the executable file and all the required assets.

Updating with latest changes

In order to fetch latest main branch changes run the following commands in project root directory:

git pull
build.bat

Note: build directory will be deleted, so if you customized any file in there, make sure to backup it before running build.bat.

morecool/koolo