Skip to content
BasaltProjectPublic

About

Bot swarm and stress testing for Minecraft servers, written in C++23

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

61 Commits

Folders and files

Repository files navigation

Basalt Basalt

Basalt Swarm

A stress testing and bot swarm tool for Minecraft servers, Java and Bedrock.

Java Edition Bedrock Edition C++ Platforms License

⚠️ 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.

About

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.

Usage

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 bots

Bots can also run commands, chat, place and break blocks, or follow a script. BasaltSwarm --help lists every option.

Building

git clone https://github.com/BasaltProject/Swarm.git
cd Swarm
cmake --preset release
cmake --build build/release

Needs CMake 3.28+, Ninja and Clang. The binary ends up in build/release/bin/.

License

GPL-3.0.

Basalt is not affiliated with Mojang Studios or Microsoft. Minecraft is a trademark of Mojang Studios.

About

Bot swarm and stress testing for Minecraft servers, written in C++23

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages