?
Host a serverModrinth App
Sign in
ModsResource PacksData PacksShadersModpacksPluginsServers
Settings
DiscordStatus

DiscordStatus

A lightweight Minecraft plugin that allows you to display and monitor your Minecraft Server status directly on Discord through a dedicated Discord Bot.

83downloads
2followers
83downloads
2followers

Compatibility

Minecraft: Java Edition

1.21.x

Platforms

Links

Report issues View source Visit wiki

Tags

Creators

Details

Licensed MIT
Published 5 months ago
Updated 4 months ago

Description

DiscordStatus is a lightweight Minecraft server plugin that connects your ingame server activity with your Discord community. It is built for server owners who want a reliable and always updated Discord status presence without manually posting updates.

The plugin keeps a dedicated Discord status message synchronized with your server state, so players can immediately see whether the server is online or offline. It also reports player activity events, making Discord a practical companion space for your Minecraft server.

Core Features

  • Live online/offline server status displayed in a Discord embed.
  • Automatic player join and leave notifications in Discord.
  • Customizable online and offline status text, including:
    • status title
    • status description
    • embed color
  • Configurable embed sections so each server can choose what to show:
    • description
    • server icon thumbnail
    • MOTD
    • online player count
    • player list
    • server version
  • Slash-command based management for status text, colors, and toggles, allowing quick updates without constantly editing files.

What It Enables for Server Owners

  • Keep your community informed in real time, even when they are not ingame.
  • Reduce repetitive manual announcements in Discord.
  • Present a clear and professional server status panel to players.
  • Tailor exactly which status details are visible based on your server style and privacy preferences.
  • Manage presentation and behavior quickly through commands and configuration.

Installation

Install the plugin jar

  1. Download the latest release from Modrinth.
  2. Place the DiscordStatus.jar file in your server plugins folder.
  3. Start the server once to generate plugins/DiscordStatus/config.yml.

Create a Discord application and bot

  1. Open the Discord Developer Portal: https://discord.com/developers/applications
  2. Click New Application and enter a name (for example Status Bot).
  3. You should now be on a page where you can configure your Application, if not click on the Application you just created.
  4. Go to the Bot section on the left side.
  5. Under Token, click Reset Token (or Copy Token) then paste the token into the value of discordToken in plugins/DiscordStatus/config.yml.
  6. In the same Application on the left side go to OAuth2 > OAuth2 URL Generator.
  7. Under Scopes, select:
    • bot
    • applications.commands
  8. Under Bot Permissions, select at least:
    • View Channels
    • Send Messages
    • Embed Links
    • Read Message History
    • Manage Messages (used when refreshing/replacing status messages)
  9. On the very bottom of the page a URL will be generated. Open the generated URL and invite the bot to your server.

Enable Developer Mode in Discord (for copying IDs)

  1. Open Discord Settings.
  2. Go to Advanced.
  3. Enable Developer Mode.

After Developer Mode is enabled, right-click and use Copy Server ID / Copy Channel ID / Copy Message ID to fill in the rest of the values in plugins/DiscordStatus/config.yml.

  • discordServerID: right-click your server icon > Copy Server ID
  • updatesChannelID: right-click your updates channel > Copy Channel ID
  • statusChannelID: right-click your status channel > Copy Channel ID
  • statusMessageID:
    • optional on first run
    • you can leave it empty and let the plugin create/store it automatically
    • if needed later, right-click the status message > Copy Message ID

Tip: updatesChannelID and statusChannelID can be the same channel if you prefer.

Final Steps

  1. Configure the rest of the plugins/DiscordStatus/config.yml (A default file template can be found below).
  2. Restart the Minecraft Server for the changes to take effect.
  3. Enjoy the Minecraft Plugin :)

Configuration

Default config.yml:

discordToken: "YOUR_BOT_TOKEN"
discordServerID: "YOUR_DISCORD_SERVER_ID"
updatesChannelID: "YOUR_DISCORD_CHANNEL_ID"
statusChannelID: "YOUR_STATUS_CHANNEL_ID"
statusMessageID: "YOUR_STATUS_MESSAGE_ID"

sendJoinMessage: true
sendLeaveMessage: true
joinMessage: "`{player}` joined the Server!"
leaveMessage: "`{player}` left the Server!"

statusMessageTitleOnline: "🟢 Server is Online"
statusMessageDescriptionOnline: "The Minecraft server is currently online and operational."
statusColorOnline: "#00FF00"

statusMessageTitleOffline: "🔴 Server is Offline"
statusMessageDescriptionOffline: "The Minecraft server is currently offline, please check again later."
statusColorOffline: "#FF0000"

showDescription: true
showServerIcon: true
showMotd: true
showPlayersOnline: true
showPlayerList: true
showServerVersion: true

phraseMessageOfTheDay: "Message of the Day"
phrasePlayersOnline: "Players Online"
phrasePlayerList: "Player List"
phraseNoPlayersOnline: "No players online."
phraseServerVersion: "Server Version"
phraseStatusUpdated: "Status Updated"

Notes:

  • statusColorOnline and statusColorOffline must use #RRGGBB format.
  • statusMessageID can be left empty, the plugin will create/update it automatically.

If you like this project, please consider giving it a star on GitHub! Your support means the world to me and motivates me to keep building and improving projects like this! :)

~ Sh4dowking