A stress testing and bot swarm tool for Minecraft servers, Java and Bedrock.
⚠️ Development use only. Swarm is for development environments and benchmarking. Never use it against servers you do not own or have explicit permission to test.
Swarm connects large swarms of bots to a server to test its performance, concurrency and stability. It speaks both
editions: Java from 1.8 to 26.3, and Bedrock with --bedrock. A Java bot claims whatever version --version asks
for, so a server that translates older clients can be tested with the same swarm.
Swarm deliberately does not use Wire. A bot that speaks through the same code as the server it tests cannot catch a bug in that code, because both sides would make the same mistake.
BasaltSwarm --ip 127.0.0.1:25565 --count 500 --physics # 500 Java bots with physics
BasaltSwarm --count 16 --spread 2048 --physics # spread over a grid
BasaltSwarm --count 50 --version 26.1 # claim an older version
BasaltSwarm --bedrock --count 20 # Bedrock botsBots can also run commands, chat, place and break blocks, or follow a script. BasaltSwarm --help lists every option.
git clone https://github.com/BasaltProject/Swarm.git
cd Swarm
cmake --preset release
cmake --build build/releaseNeeds CMake 3.28+, Ninja and Clang. The binary ends up in build/release/bin/.
Basalt is not affiliated with Mojang Studios or Microsoft. Minecraft is a trademark of Mojang Studios.