https://github.com/pumpkin-mc/botmark

A tool to stress test Minecraft servers by simulating numerous bot connections
https://github.com/pumpkin-mc/botmark

Last synced: 4 months ago
JSON representation

A tool to stress test Minecraft servers by simulating numerous bot connections

• Host: GitHub
• URL: https://github.com/pumpkin-mc/botmark
• Owner: Pumpkin-MC
• License: mit
• Created: 2025-02-23T15:02:01.000Z (8 months ago)
• Default Branch: master
• Last Pushed: 2025-02-26T19:30:42.000Z (8 months ago)
• Last Synced: 2025-05-30T08:15:19.839Z (5 months ago)
• Language: Rust
• Size: 18.6 KB
• Stars: 18
• Watchers: 1
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          


[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

![Current version)](https://img.shields.io/badge/current_version-1.21.4-blue)

A tool to stress test Minecraft servers by simulating numerous bot connections, helping identify performance bottlenecks and stability issues.

![Screenshot_20250223_154536](https://github.com/user-attachments/assets/b1379060-e375-44dc-95a3-91f1f2fb52dd)



### 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)

  

- **`--spam_message ""` (Optional):**

  - Will send a Chat message with the specefied `spam_message_delay`.

  - Example: `--spam_message "Hello, I'm a Robot"`

- **`--spam_message_delay ` (Optional, Default: `210`):**

  - The delay (in milliseconds) between spam message.

  - Example: `--spam_message_delay 100` (100 milliseconds delay)