Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Bot framework for multiple protocols.
branch: master

This branch is 43 commits behind DarkStorm652:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.


This project is an attempt at a better rewrite of the Minecraft client for use in automating Minecraft that I started around early July of last year. This isn't limited to simply botting; other uses include (completely) custom clients, server monitors, and more. Multi-protocol support was recently added, allowing the same version of the bot to run on different Minecraft versions (assuming that the corresponding protocol version provider is in the protocols/ directory).

An example task that loads WorldEdit schematic files and constructs them (written by someone else who has since lost the source)

Getting Started

With Eclipse

Open Eclipse.
Right-click in the package explorer area and click Import...
Select Git > Projects from Git and click Next.
Select URI and click Next.
Paste the Git URL for DarkBot ( and click Next, then click Next again at the Branch Selection dialog.
Change the directory to [your eclipse workspace]/DarkBot (change the [] to the actual path to your workspace by clicking browse) and click Next.
Select Use the New Project wizard and click Finish.
In the New Project wizard, select Java Project and click Next.
Type in DarkBot (exact capitalization). If you typed it in properly and all previous steps have been followed, options in the wizard should disable themselves. Click Finish if this is the case.
Once cloned, expand the project in your package explorer. There will likely be a large amount of errors. Right-click "src" and click Build Path > Remove from Build Path. The folder src should move down below "JRE System Library" and all errors should disappear.
Expand src, then expand each folder within src. In each of these folders, right-click each folder (named java, resources, protocols, etc.) and click Build Path > Use as Source Folder.
Expand lib, right click every .jar file, and click Build Path > Add to Build Path.
Right-click build.xml and click Run As > Ant Build (the first option).
Wait for the build to complete and run DarkBot.jar from cmd with --help for args.
Hurray! The plus side to this method (though it may seem lengthier than the one below) is that you can right-click the project folder and click Team > Pull to get new updates. Make sure you run build.xml after every time you update.


Without Eclipse

Clone the project with git or download the source zip from the github page and extract it.
Open the folder and run build.xml (this may require cmd to execute).
Wait for the build to complete and run DarkBot.jar from cmd with --help for args.
Hurray! The downside to this is that you have to delete the folder and redo these steps every time you want to update.


To Run

Open Terminal or Command Prompt
Switch to the directory with DarkBot.jar (cd path/to/DarkBot.jar with Terminal or cd C:\path\to\DarkBot.jar with Command Prompt)

For CLI:

Print arguments with java -cp DarkBot.jar org.darkstorm.darkbot.mcspambot.DarkBotMC --help
Use java -cp DarkBot.jar org.darkstorm.darkbot.mcspambot.DarkBotMC <args> where <args> consists of arguments from the list printed before (such as --username or --server server:port)

For GUI:

Run 'java -cp DarkBot.jar org.darkstorm.darkbot.darkbotmc.DarkBotMC'

Something went wrong with that request. Please try again.