ServerStatusBot is a powerful plugin designed to integrate your Minecraft server with Discord, providing real-time updates about the server status directly in a specified Discord channel. This plugin is compatible only with Velocity.
Key Features:
- Real-Time Updates: Automatically updates the Discord embed with the current server status and player count.
- Customizable Embeds: Fully customizable embed messages, including title, description, fields, colors, images, thumbnails, and footer icons.
- Markdown Support: Supports markdown formatting in embed fields for enhanced text styling.
- Connection Resilience: Automatically attempts to reconnect to Discord in case of connection failures, with configurable retry settings.
- Offline Status Handling: Automatically updates the embed to reflect the server's offline status when the server shuts down or the plugin is disabled.
- Placeholders: Use placeholders to dynamically display information such as time, date, player count, and more.
Placeholders:
- %time% -> The time in the HH:mm format
- %date% -> The date in the dd/MM/yyyy format
- %date-us% -> The date in the MM/dd/yyyy format
- %player_count% -> The number of players online
- %max_players% -> The maximum number of players that can be online
- %players% -> The server's players
- %players_list% -> The server's players list
Installation Instructions:
- Create a new Discord Application here.
- Enable the "MESSAGE CONTENT INTENT" permission.
- Grant the necessary permissions in your Discord Server.
- Select a channel to be the status channel and copy the ID.
- Configure the plugin:
Edit the config.yml file in your server's plugins folder to customize the bot settings and embed messages.
bot-token: "YOUR_BOT_TOKEN" guild-id: "YOUR_GUILD_ID" channel-id: "YOUR_CHANNEL_ID" update-message: 120 connection-attempts: 3 reconnect-interval: 5 online-embed: title: "Server Status" timestamp: false color: "#7edb64" fields: - name: "> **Status**" value: "```fix\nOnline```" inline: true - name: "> **Players**" value: "```cs\n%player_count%```" inline: true - name: "IP:" value: "```prolog\nONEWAYCRAFT.NET```" inline: false - name: "Bedrock port:" value: "```yaml\n19132```" inline: false avatar: "" avatar_url: "" image: "https://i.imgur.com/lX19VI7.png" thumbnail: "" footer: "Last update: %time%" footer_icon: "" offline-embed: title: "Server Status" timestamp: false color: "#ca3931" fields: - name: "> **Status**" value: "```ml\nOffline```" inline: true - name: "> **Players**" value: "```%player_count%```" inline: true - name: "IP:" value: "```onewaycraft.net```" inline: false - name: "Bedrock port:" value: "```yaml\n19132```" inline: false avatar: "" avatar_url: "" image: "https://i.imgur.com/kDJ3uCV.png" thumbnail: "" footer: "Shutdown time: %date% - %time%" footer_icon: "" - Start your server:
The plugin will automatically connect to Discord and start updating the embed with the server status.
Support and Contributions:
- If you encounter any issues or have any feedback, please feel free to open an issue on our GitHub repository.
- Contributions are welcome! Please fork the repository and submit pull requests for any enhancements or bug fixes.
License:
This project is licensed under the MIT License. See the LICENSE file for details.
Acknowledgments:
- Thanks to the creators of the JDA library for their excellent Discord API wrapper.
- Thanks to the Velocity, BungeeCord, and Bukkit communities for their support and documentation.
Similar projects
Plugin →Let Me Despawn
Improves performance by tweaking mob despawn rules. Say bye to pesky unintentional persistent mobs.
25MSueta
JourneyMap
Real-time map used for mapping in-game or your browser as you explore.
14.7MSueta
Emotecraft
Create your own emotes in Minecraft.
7.5MSueta
Simple Tpa
A simple tpa plugin which sends requests
5.4MSueta
Common Network
Forge and Fabric Unified Networking Solution
3.9MSueta
Set Home
A lightweight plugin for players to set their homes.
3.8MSueta