[](https://opensource.org/licenses/MIT)
A tool to stress test Minecraft servers by simulating numerous bot connections, helping identify performance bottlenecks and stability issues.
### How to Run
1. **Disable Online Mode & Encryption:** Ensure that `online-mode=false` in your server's `server.properties` file. This is crucial for Botmark to connect as it simulates offline-mode clients. **(Warning: only do this in a test environment)**.
2. **Run Botmark:** Use the following command in your terminal, adjusting the arguments as needed:
```bash
./botmark --ip --count [OPTIONS]
```
### Command-Line Arguments
Here's a detailed breakdown of all available command-line arguments:
- **`--ip ` (Required):**
- The IP address and port of the Minecraft server to stress test.
- Example: `127.0.0.1:25565` or `example.com:25565`
- **`-c, --count ` (Optional, Default: `1`):**
- The number of bots to simulate connecting to the server.
- Example: `--count 50`
- **`-d, --delay ` (Optional, Default: `200`):**
- The delay (in milliseconds) between each bot connection.
- Example: `--delay 100` (100 milliseconds delay)
- **`-t, --timeout ` (Optional, Default: `5000`):**
- The timeout (in milliseconds) for each bot connection.
- Example: `--delay 500` (500 milliseconds delay)
- **`--enable_spam_message ` (Optional, Default: `true`):**
- Enable periodic chat spam messages.
- Example: `--enable_spam_message true`
- **`--spam_message ""` (Optional, Default: `Please do not spam!`):**
- Will send a Chat message with the specified `spam_message_delay`.
- Example: `--spam_message "Hello, I'm a Robot"`
- **`--spam_message_delay_min ` (Optional, Default: `150`):**
- The minimal delay (in milliseconds) between spam message.
- Example: `--spam_message_delay_min 100` (100 milliseconds delay)
- **`--spam_message_delay_max ` (Optional, Default: `250`):**
- The maximal delay (in milliseconds) between spam message.
- Example: `--spam_message_delay_max 250` (250 milliseconds delay)
- **`--enable_rotation ` (Optional, Default: `true`):**
- Enable random head rotations.
- Example: `--enable_rotation true`
- **`--enable_swing ` (Optional, Default: `true`):**
- Enable random arm swings.
- Example: `--enable_swing true`
- **`--enable_movement ` (Optional, Default: `true`):**
- Enable random bot movement and walking.
- Example: `--enable_movement true`
- **`--enable_jumping ` (Optional, Default: `true`):**
- Enable jumping while moving.
- Example: `--enable_jumping true`
- **`--enable_physics ` (Optional, Default: `true`):**
- Enable physics simulation (gravity, friction, inertia, server knockback).
- Example: `--enable_physics true`