jstnmthw/koolo

Diablo II Resurrected bot written in Go

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. Koolo reads game memory and interacts with the game injecting clicks/keystrokes to the game window. As good as it can.

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 (IMPORTANT: It will NOT work without it, this step is not optional)

Quick Start

• Open Diablo II: Resurrected and ensure the game resolution is set to windowed mode and 1280x720 or 1920x1080 in HiDPI mode. You can close the game after this step.
• If you haven't done yet, install Diablo II: LOD 1.13c
• Download the latest Koolo release (recommended for most users), or alternatively you can build it from source
• Extract the zip file in a directory of your choice.
• Run koolo.exe.
• Follow the setup wizard, it will guide you through the process of setting up the bot, you will need to setup some directories and character configuration.
• If you want to back up/restore your configuration, and for manual setup, you can find the configuration files in the config directory.

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

• Download Go >= 1.22
• Install git

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.