MinecraftStateMessages

SpigotMC

A powerful Minecraft server plugin that sends real-time server status notifications to Discord via w

28 downloads

latest v1.0.1 SpigotMC

1.8 – 1.21

MinecraftStateMessages

[IMG]

A powerful Minecraft server plugin that sends real-time server status notifications to Discord via webhooks with customizable embeds.

Features • Installation • Configuration • Support

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Features

Real-time Notifications - Instant Discord notifications when your server starts or stops
Customizable Embeds - Beautiful, fully customizable Discord embeds with color coding
Flexible Configuration - Easy-to-use YAML configuration with sensible defaults
Lightweight - Minimal performance impact on your server

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Installation

Download the latest MinecraftStateMessages.jar
Place the JAR file in your server's plugins/ directory
Restart your server
Configure the plugin by editing plugins/MinecraftStateMessages/config.yml
Run /reload or restart the server to apply changes

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

⚙️ Configuration

After the first run, a config.yml file will be generated in plugins/MinecraftStateMessages/. Here's a detailed breakdown of all configuration options:

Basic Settings

Code (YAML):

# Message sent to Discord when the server starts
server-start-message : "Server has been started!"

# Message sent to Discord when the server stops
server-stop-message : "Server has been stopped!"

# Your Discord webhook URL - get this from Discord Server Settings > Integrations > Webhooks
discord-webhook-url : "https://discord.com/api/webhooks/your-webhook-url"

Embed Settings

Code (YAML):

# Enable or disable Discord embeds (if false, sends plain text messages)
embed-enabled : true

# Color for server start notifications
# Supported: green, red, blue, yellow, orange, purple, gray/grey, black, white
# Or use hex codes: "#2ECC71" or "2ECC71"
embed-start-color : "green"

# Color for server stop notifications
embed-stop-color : "red"

# Title displayed at the top of the embed
# Leave empty ("") to hide the title completely
embed-title : "Minecraft Server"

Color Reference

Color Name	Hex Code	Usage
green	#2ECC71	Perfect for start messages
red	#E74C3C	Perfect for stop messages
blue	#3498DB	General information
yellow	#FFFF00	Warnings
orange	#E67E22	Alerts
purple	#9B59B6	Special events
gray/grey	#95A5A6	⚪ Neutral
black	#23272A	⚫ Discord dark theme
white	#FFFFFF	⚪ Bright

You can also use any custom hex color:

Code (YAML):

embed-start-color : "#FF6B6B" # Custom coral red
embed-stop-color : "4ECDC4" # Custom turquoise (# is optional)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Configuration Examples

Code (YAML):

server-start-message : "✅ Server Online"
server-stop-message : "❌ Server Offline"
discord-webhook-url : "https://discord.com/api/webhooks/123456789/abcdefg"
embed-enabled : true
embed-start-color : "green"
embed-stop-color : "red"
embed-title : "" # Empty = no title shown

Code (YAML):

server-start-message : " The server is now online and ready for players!"
server-stop-message : " The server is now offline for maintenance."
discord-webhook-url : "https://discord.com/api/webhooks/123456789/abcdefg"
embed-enabled : true
embed-start-color : "#00FF00"
embed-stop-color : "#FF0000"
embed-title : " AwesomeCraft Network"

Code (YAML):

server-start-message : "[SERVER] Started successfully!"
server-stop-message : "[SERVER] Shutting down..."
discord-webhook-url : "https://discord.com/api/webhooks/123456789/abcdefg"
embed-enabled : false # Sends plain text instead of embeds
embed-start-color : "green"
embed-stop-color : "red"
embed-title : ""

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Setting Up Discord Webhook

Open your Discord server
Go to Server Settings → Integrations → Webhooks
Click New Webhook or Create Webhook
Customize the webhook name and channel
Click Copy Webhook URL
Paste the URL into discord-webhook-url in your config.yml

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

️ Advanced Usage

Title Visibility

The embed-title field has special behavior:

Set to any text: Displays that text as the embed title

Code (YAML):

embed-title : "My Awesome Server"
Set to empty string (""): No title will be shown

Code (YAML):

embed-title : ""
Not specified/removed: No title will be shown (same as empty)

Multiple Webhooks (Advanced)

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.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Troubleshooting

Problem: No messages appear in Discord

Solutions:

✅ Verify your webhook URL is correct
✅ Ensure discord-webhook-url is not set to the default placeholder
✅ Check server console for error messages
✅ Confirm the webhook hasn't been deleted in Discord
✅ Test the webhook URL using a tool like webhook.site

Problem: Embeds show wrong colors or no color

Solutions:

✅ Use supported color names (see Color Reference above)
✅ If using hex codes, ensure format is correct: "#FF0000" or "FF0000"
✅ Reload the plugin after changing colors

Problem: Title appears even when set to empty

Solutions:

✅ Ensure embed-title: "" is exactly like this (empty quotes)
✅ Remove any spaces between quotes: ❌ " " → ✅ ""
✅ Reload/restart server after config changes

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Permissions

This plugin requires no special permissions. It only needs:

File system access for config management
Network access for webhook requests

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Support & Links

Get Help & Stay Connected

Support Server: dsc.gg/gglvxd - Get help, report bugs, or suggest features
‍ Developer: gglvxd.net - Visit the developer's website
Organization: Fryde - Powered by Fryde

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Developed with ❤️ by gglvxd

Special thanks to the Bukkit/Spigot community, Discord Webhook API, and Fryde Organization

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Made with by gglvxd | Powered by Fryde

If you like this plugin, consider giving it a ⭐ rating and joining our Discord!

Versions

Release

1.0.1

Release

1.0.0

Comments 0

No comments yet. Be the first to share your thoughts.

MinecraftStateMessages

Versions

Comments 0

Download MinecraftStateMessages