minecraft-stress-test

Automate the stress testing of your 1.21 Minecraft server with bots. This project will log offline-mode bots into the specified server which will fly around and explore the world.

Building

Download the source code with

git clone https://github.com/PureGero/minecraft-stress-test.git

Build the source code with

mvn

Running

Ensure the following values are set in your server.properties:

online-mode=false
allow-flight=true

Run the bot with

java -jar target/minecraft-stress-test-1.0.0-SNAPSHOT-jar-with-dependencies.jar

Or, specify optional parameters:

java
    -Dbot.count=1
    -Dbot.ip=127.0.0.1
    -Dbot.port=25565
    -Dbot.login.delay.ms=100
    -Dbot.radius=1000
    -jar target/minecraft-stress-test-1.0.0-SNAPSHOT-jar-with-dependencies.jar

Note that bots are unable to respawn, we recommend giving them creative mode.

Commmands

You can type some commands into the console to control the bots on the fly.

count 1000
Set the bot count to 1000. This will either connect more bots, or disconnect existing bots as needed.

speed 0.2
Set the bots' movement speed. The default is 0.1 blocks/tick.

radius 600
Set the radius of the area the bots can move around in. The default is 1000 blocks.