Poll a server and send customizable webhook embed if the status changes.
Requires Python 3.7+
Update pip and dependencies
$ python3 -m pip install --upgrade pip
$ python3 -m pip install --upgrade setuptools wheelInstall
$ python3 -m pip install --upgrade mc-status-webhook$ python3 mc_status_webhook.py -u "<webhook url>" [options]or set the appropriate environment variables.
See CLI arguments and Environment variables for configuration.
Example scripts are also provided in the 'examples' directory. Get msw-example.cmd for Windows or msw-example.sh for Linux and modify it to your needs.
Note 1: It is strongly recommended to run mc-status-webhook on the same machine or local network as the Minecraft server to avoid false notifications due to connection issues and wasting bandwidth. In this case use the loopback address 127.0.0.1 or the local address of the machine.
Note 2: When working with BungeeCord-based proxies, use
-sor--full-statusto request full status information, because BungeeCord does not respond to just ping. Note that this will fetch more data such as MOTD, icon, version, sample players and will use more bandwidth if the update time is set too low.
| Argument | Type | Default | Required | Description |
|---|---|---|---|---|
| -H, --host | str | 127.0.0.1 | No | Server address |
| -p, --port | int | 25565 | No | Server port |
| -t, --update-time | float | 10.0 | No | Time in seconds between checking the server status |
| -i, --initial-status | bool | No | Send a webhook with the server status on application start | |
| -s, --full-status | bool | No | Request full status info instead of just pinging (for BungeeCord-based proxies) | |
| -u, --webhook-url | str | Yes | Discord webhook URL | |
| -d, --debug | bool | No | Log debug messages | |
| --online-color | str | 30c030 | No | Webhook color hex when the server is online |
| --offline-color | str | ff4040 | No | Webhook color hex when the server is offline |
| --online-thumb-url | str | <online icon> | No | Webhook thumbnail URL when the server is online ('none' = disabled) |
| --offline-thumb-url | str | <offline icon> | No | Webhook thumbnail URL when the server is offline ('none' = disabled) |
| --status-title | str | Status | No | Webhook status title |
| --status-online-value | str | Online | No | Webhook status value when the server is online |
| --status-offline-value | str | Offline | No | Webhook status value when the server is offline |
| --address-title | str | Address | No | Webhook address title |
| --address-value | str | No | Webhook address value when the server is online |
| Environment variable | Equivalent argument |
|---|---|
| MSW_HOST | -H, --host |
| MSW_PORT | -p, --port |
| MSW_WEBHOOK_URL | -u, --webhook-url |
| MSW_ONLINE_COLOR | --online-color |
| MSW_OFFLINE_COLOR | --offline-color |
| MSW_ONLINE_THUMB_URL | --online-thumbnail-url |
| MSW_OFFLINE_THUMB_URL | --offline-thumbnail-url |
| MSW_STATUS_TITLE | --status-title |
| MSW_STATUS_ONLINE_VALUE | --status-online-value |
| MSW_STATUS_OFFLINE_VALUE | --status-offline-value |
| MSW_ADDRESS_TITLE | --address-title |
| MSW_ADDRESS_VALUE | --address-value |
MIT license. See LICENSE for more information.