# MinecraftStateMessages<\/p>\n
\n
\n<\/p>\n
A powerful Minecraft server plugin that sends real-time server status notifications to Discord via webhooks with customizable embeds.<\/p>\n
[Features](#-features) \u2022 [Installation](#-installation) \u2022 [Configuration](#-configuration) \u2022 [Support](#-support)<\/p>\n
—<\/p>\n<\/div>\n
## \ud83d\udccb Features<\/p>\n
– **\ud83d\udd14 Real-time Notifications** – Instant Discord notifications when your server starts or stops
\n– **\ud83c\udfa8 Customizable Embeds** – Beautiful, fully customizable Discord embeds with color coding
\n– **\ud83d\udd27 Flexible Configuration** – Easy-to-use YAML configuration with sensible defaults
\n– **\ud83c\udfaf Lightweight** – Minimal performance impact on your server<\/p>\n
## \ud83d\udce6 Installation<\/p>\n
1. Download the latest `MinecraftStateMessages.jar` from the releases page
\n2. Place the JAR file in your server’s `plugins\/` directory
\n3. Restart your server
\n4. Configure the plugin by editing `plugins\/MinecraftStateMessages\/config.yml`
\n5. Run `\/reload` or restart the server to apply changes<\/p>\n
## \u2699\ufe0f Configuration<\/p>\n
After the first run, a `config.yml` file will be generated in `plugins\/MinecraftStateMessages\/`. Here’s a detailed breakdown of all configuration options:<\/p>\n
### Basic Settings<\/p>\n
“`yaml
\n# Message sent to Discord when the server starts
\nserver-start-message: “Server has been started!”<\/p>\n
# Message sent to Discord when the server stops
\nserver-stop-message: “Server has been stopped!”<\/p>\n
# Your Discord webhook URL – get this from Discord Server Settings > Integrations > Webhooks
\ndiscord-webhook-url: “https:\/\/discord.com\/api\/webhooks\/your-webhook-url”
\n“`<\/p>\n
### Embed Settings<\/p>\n
“`yaml
\n# Enable or disable Discord embeds (if false, sends plain text messages)
\nembed-enabled: true<\/p>\n
# Color for server start notifications
\n# Supported: green, red, blue, yellow, orange, purple, gray\/grey, black, white
\n# Or use hex codes: “#2ECC71” or “2ECC71”
\nembed-start-color: “green”<\/p>\n
# Color for server stop notifications
\nembed-stop-color: “red”<\/p>\n
# Title displayed at the top of the embed
\n# Leave empty (“”) to hide the title completely
\nembed-title: “Minecraft Server”
\n“`<\/p>\n
#### \ud83c\udfa8 Color Reference<\/p>\n
| Color Name | Hex Code | Preview |
\n|————|———-|———|
\n| `green` | `#2ECC71` | \ud83d\udfe2 Perfect for start messages |
\n| `red` | `#E74C3C` | \ud83d\udd34 Perfect for stop messages |
\n| `blue` | `#3498DB` | \ud83d\udd35 General information |
\n| `yellow` | `#FFFF00` | \ud83d\udfe1 Warnings |
\n| `orange` | `#E67E22` | \ud83d\udfe0 Alerts |
\n| `purple` | `#9B59B6` | \ud83d\udfe3 Special events |
\n| `gray`\/`grey` | `#95A5A6` | \u26aa Neutral |
\n| `black` | `#23272A` | \u26ab Discord dark theme |
\n| `white` | `#FFFFFF` | \u26aa Bright |<\/p>\n
You can also use any custom hex color:
\n“`yaml
\nembed-start-color: “#FF6B6B” # Custom coral red
\nembed-stop-color: “4ECDC4” # Custom turquoise (# is optional)
\n“`<\/p>\n
### Configuration Examples<\/p>\n
#### Example 1: Minimal Setup (No Title)
\n“`yaml
\nserver-start-message: “\u2705 Server Online”
\nserver-stop-message: “\u274c Server Offline”
\ndiscord-webhook-url: “https:\/\/discord.com\/api\/webhooks\/123456789\/abcdefg”
\nembed-enabled: true
\nembed-start-color: “green”
\nembed-stop-color: “red”
\nembed-title: “” # Empty = no title shown
\n“`<\/p>\n
#### Example 2: Branded Server
\n“`yaml
\nserver-start-message: “\ud83c\udfae The server is now online and ready for players!”
\nserver-stop-message: “\ud83d\uded1 The server is now offline for maintenance.”
\ndiscord-webhook-url: “https:\/\/discord.com\/api\/webhooks\/123456789\/abcdefg”
\nembed-enabled: true
\nembed-start-color: “#00FF00”
\nembed-stop-color: “#FF0000”
\nembed-title: “\ud83c\udf1f AwesomeCraft Network”
\n“`<\/p>\n
#### Example 3: Simple Text Messages (No Embeds)
\n“`yaml
\nserver-start-message: “[SERVER] Started successfully!”
\nserver-stop-message: “[SERVER] Shutting down…”
\ndiscord-webhook-url: “https:\/\/discord.com\/api\/webhooks\/123456789\/abcdefg”
\nembed-enabled: false # Sends plain text instead of embeds
\nembed-start-color: “green”
\nembed-stop-color: “red”
\nembed-title: “”
\n“`<\/p>\n
## \ud83d\udd17 Setting Up Discord Webhook<\/p>\n
1. Open your Discord server
\n2. Go to **Server Settings** \u2192 **Integrations** \u2192 **Webhooks**
\n3. Click **New Webhook** or **Create Webhook**
\n4. Customize the webhook name and channel
\n5. Click **Copy Webhook URL**
\n6. Paste the URL into `discord-webhook-url` in your config.yml<\/p>\n
## \ud83d\udee0\ufe0f Advanced Usage<\/p>\n
### Title Visibility<\/p>\n
The `embed-title` field has special behavior:
\n– **Set to any text**: Displays that text as the embed title
\n “`yaml
\n embed-title: “My Awesome Server”
\n “`
\n– **Set to empty string (`””`))**: No title will be shown
\n “`yaml
\n embed-title: “”
\n “`
\n– **Not specified\/removed**: No title will be shown (same as empty)<\/p>\n
### Multiple Webhooks (Advanced)<\/p>\n
Want to send notifications to multiple Discord channels? You can modify the webhook URL dynamically or create multiple configurations. For advanced setups, consider forking this plugin and adding multi-webhook support.<\/p>\n
## \ud83d\udd0d Troubleshooting<\/p>\n
### Webhook not sending<\/p>\n
**Problem**: No messages appear in Discord<\/p>\n
**Solutions**:
\n– \u2705 Verify your webhook URL is correct
\n– \u2705 Ensure `discord-webhook-url` is not set to the default placeholder
\n– \u2705 Check server console for error messages
\n– \u2705 Confirm the webhook hasn’t been deleted in Discord
\n– \u2705 Test the webhook URL using a tool like webhook.site<\/p>\n
### Colors not working<\/p>\n
**Problem**: Embeds show wrong colors or no color<\/p>\n
**Solutions**:
\n– \u2705 Use supported color names (see [Color Reference](#-color-reference))
\n– \u2705 If using hex codes, ensure format is correct: `”#FF0000″` or `”FF0000″`
\n– \u2705 Reload the plugin after changing colors<\/p>\n
### Title showing when it shouldn’t<\/p>\n
**Problem**: Title appears even when set to empty<\/p>\n
**Solutions**:
\n– \u2705 Ensure `embed-title: “”` is exactly like this (empty quotes)
\n– \u2705 Remove any spaces between quotes: \u274c `” “` \u2192 \u2705 `””`
\n– \u2705 Reload\/restart server after config changes<\/p>\n
## \ud83e\udd1d Support & Links<\/p>\n
### Get Help & Stay Connected<\/p>\n
\n
\n<\/p>\n<\/div>\n
– **\ud83d\udcac Support Server**: dsc.gg\/gglvxd – Get help, report bugs, or suggest features
\n– **\ud83d\udc68\u200d\ud83d\udcbb Developer**: gglvxd.net – Visit the developer’s website
\n– **\ud83c\udfe2 Organization**: Fryde – Powered by Fryde<\/p>\n
## \ud83d\udcdd Permissions<\/p>\n
This plugin requires no special permissions. It only needs:
\n– File system access for config management
\n– Network access for webhook requests<\/p>\n
## \ud83d\udcdc License<\/p>\n
This project is licensed under the MIT License – see the [LICENSE](LICENSE) file for details.<\/p>\n
## \ud83d\ude4f Credits<\/p>\n
Developed with \u2764\ufe0f by gglvxd<\/p>\n
—<\/p>\n
**Made with \ud83d\udc9c by gglvxd | Powered by Fryde**<\/p>\n
*If you like this plugin, consider giving it a \u2b50 and joining our Discord!*<\/p>\n<\/div>\n","protected":false},"excerpt":{"rendered":"
A powerful Minecraft server plugin that sends real-time server status notifications to Discord via webhooks with customizable embeds.<\/p>\n","protected":false},"featured_media":102254,"template":"","meta":{"_minecraft_slug":"minecraftstatemessages","_minecraft_project_id":"MBS6nbK0","_minecraft_author":"GGLVXD","_minecraft_license":"MIT","_minecraft_downloads":29,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"minecraftstatemessages.zip","_minecraft_size_bytes":7866,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T22:08:18.301283Z","_minecraft_date_created":"2026-02-02T18:45:23.439367Z","_minecraft_date_modified":"2026-02-01T20:51:06.632936Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/minecraftstatemessages","_minecraft_icon_attachment_id":102254,"_minecraft_imported_at":"2026-06-05T20:59:07+00:00","_minecraft_import_hash":"4e7c3d4407b5556b7d14a3a2cb450f50","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,127,128,129,123,92],"mod_loader":[132,133,134],"minecraft_version":[339,340,341,357,359,360,379,382,385,438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,95,96,154,155,108,37,745,40,801,41,808,809,810,811,812,813,814,815,73,71,72,746,747,748,749,750,74,38,751,752,753,754,755,756,78,767,768,769,770,771,79,780,781,782,783,784,80,785,786,81,787,82,796,797,798,799,800,22,23,24,25,26,27,28,29,30,31,860,861,862,863,864,791,792,793,794,795,802,803,804,805,806,807],"class_list":["post-102253","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-technology","mod_category-utility","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-10","minecraft_version-1-10-1","minecraft_version-1-10-2","minecraft_version-1-11","minecraft_version-1-11-1","minecraft_version-1-11-2","minecraft_version-1-12","minecraft_version-1-12-1","minecraft_version-1-12-2","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-pre1","minecraft_version-1-21-pre2","minecraft_version-1-21-pre3","minecraft_version-1-21-pre4","minecraft_version-1-21-rc1","minecraft_version-1-21-1","minecraft_version-1-21-1-rc1","minecraft_version-1-21-10","minecraft_version-1-21-10-rc1","minecraft_version-1-21-11","minecraft_version-1-21-11-pre1","minecraft_version-1-21-11-pre2","minecraft_version-1-21-11-pre3","minecraft_version-1-21-11-pre4","minecraft_version-1-21-11-pre5","minecraft_version-1-21-11-rc1","minecraft_version-1-21-11-rc2","minecraft_version-1-21-11-rc3","minecraft_version-1-21-2","minecraft_version-1-21-2-pre1","minecraft_version-1-21-2-pre2","minecraft_version-1-21-2-pre3","minecraft_version-1-21-2-pre4","minecraft_version-1-21-2-pre5","minecraft_version-1-21-2-rc1","minecraft_version-1-21-2-rc2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-4-pre1","minecraft_version-1-21-4-pre2","minecraft_version-1-21-4-pre3","minecraft_version-1-21-4-rc1","minecraft_version-1-21-4-rc2","minecraft_version-1-21-4-rc3","minecraft_version-1-21-5","minecraft_version-1-21-5-pre1","minecraft_version-1-21-5-pre2","minecraft_version-1-21-5-pre3","minecraft_version-1-21-5-rc1","minecraft_version-1-21-5-rc2","minecraft_version-1-21-6","minecraft_version-1-21-6-pre1","minecraft_version-1-21-6-pre2","minecraft_version-1-21-6-pre3","minecraft_version-1-21-6-pre4","minecraft_version-1-21-6-rc1","minecraft_version-1-21-7","minecraft_version-1-21-7-rc1","minecraft_version-1-21-7-rc2","minecraft_version-1-21-8","minecraft_version-1-21-8-rc1","minecraft_version-1-21-9","minecraft_version-1-21-9-pre1","minecraft_version-1-21-9-pre2","minecraft_version-1-21-9-pre3","minecraft_version-1-21-9-pre4","minecraft_version-1-21-9-rc1","minecraft_version-1-8","minecraft_version-1-8-1","minecraft_version-1-8-2","minecraft_version-1-8-3","minecraft_version-1-8-4","minecraft_version-1-8-5","minecraft_version-1-8-6","minecraft_version-1-8-7","minecraft_version-1-8-8","minecraft_version-1-8-9","minecraft_version-1-9","minecraft_version-1-9-1","minecraft_version-1-9-2","minecraft_version-1-9-3","minecraft_version-1-9-4","minecraft_version-25w34b","minecraft_version-25w35a","minecraft_version-25w36a","minecraft_version-25w36b","minecraft_version-25w37a","minecraft_version-25w41a","minecraft_version-25w42a","minecraft_version-25w43a","minecraft_version-25w44a","minecraft_version-25w45a","minecraft_version-25w46a"],"yoast_head":"\n