Skip to main content

BMG Server Management Bot

BMGServerManager Discord Bot

Manage your game servers directly from Discord. BMGServerManager connects to your Pterodactyl panel and posts a live status embed in any channel you choose — showing CPU, RAM, disk, uptime, and server state — with buttons to start, stop, and restart without ever opening the panel.

What it does

Live Status Embeds

Each linked server gets its own embed in Discord that updates automatically, showing real-time CPU, RAM, disk usage, and whether the server is online, starting, stopping, or offline.

Power Controls

Start, stop, and restart your servers with a single button click directly from Discord. No need to open the Pterodactyl panel.

Action Logs

Set a log channel and every power action — start, stop, restart — is automatically logged with who did it, which server, and when.

Holdfast Config Selector

Running Holdfast? A built-in config selector lets you pick a server config file from a dropdown menu and apply it as a startup variable — no panel access required.

Update / Reinstall

Trigger a server reinstall straight from Discord. The bot will ask you to confirm before doing anything, so there's no risk of accidentally pressing it.

Secure by Design

Your Pterodactyl API key is encrypted before it's stored. Nobody else can use your key, and you can remove it from the bot at any time.

Before you start

You'll need the following before setting up the bot:

  • A Discord account with permission to add bots to your server
  • A Pterodactyl panel account with at least one server
  • A Client API key from your Pterodactyl panel (not an Application key)

How to get your Client API key:

  1. Log into your Pterodactyl panel
  2. Click your name or avatar in the top right corner
  3. Select API Credentials from the dropdown
  4. Give your key a description (e.g. Discord Bot) and click Create
  5. Copy the key shown — you won't be able to see it again once you leave the page

Make sure you're creating a Client API key, not an Application key. The Client key is found in your own account settings, not the admin panel.

How to set it up

  1. Add the bot to your Discord server
    Click this invite link and select the Discord server you want to add it to. Make sure to grant all the requested permissions — these are needed for the bot to post and edit embeds.
  2. Register your API key
    In any channel, type /bmgsm setup and enter your Pterodactyl Client API key when prompted. The bot will verify it works and save it securely. This only needs to be done once.
  3. Link a server to a channel
    Go to the Discord channel where you want the embed to appear and type /bmgsm link. If you have more than one server, you'll get a dropdown to choose which one. The embed will appear immediately and start updating.
  4. Optionally set a log channel
    If you'd like to keep a record of who starts and stops servers, type /bmgsm setlog in your chosen log channel. You'll need the Manage Server permission to do this.
  5. That's it!
    The embed will keep itself up to date automatically. You can link multiple servers across different channels, and each one will have its own embed.

All commands

All commands start with /bmgsm.

Command What it does Who can use it
/bmgsm setup Registers your Pterodactyl Client API key with the bot. Required before you can link any servers. Manage Server permission required
/bmgsm link Posts a live server status embed in the current channel. If you have multiple servers, you'll be shown a list to choose from. Anyone with an API key registered
/bmgsm unlink Removes a server embed. If there are multiple linked servers, you'll get a dropdown to pick which one to remove. The person who linked it, or anyone with Manage Channels
/bmgsm forget Deletes your stored API key from the bot entirely. Manage Server permission required
/bmgsm setlog Sets the channel where power action logs are posted. Run this command in the channel you want to use. Manage Server permission required
/bmgsm removelog Removes the log channel. Logs will stop being posted. Manage Server permission required

Game-specific features

Some game types have extra buttons built into their embed. These only appear if the bot detects that the server is running the right game.

Config Selector Holdfast

The embed will show a Select Config button. Clicking it fetches the available config files directly from your server and shows them in a dropdown. Choose one and it's instantly set as the active config — no panel login needed.

The new config takes effect the next time the server starts.

Update / Reinstall Holdfast

The embed will show an Update / Reinstall button. Clicking it will ask you to confirm before doing anything. Once confirmed, the server reinstall is triggered through the panel.

The server must be offline before reinstalling. The bot will temporarily lose connection to the server while the reinstall is in progress — this is normal.

Common questions

  • Is my API key safe?

    Yes. Your API key is encrypted as soon as you submit it and is never stored in plain text. You can remove it at any time by running /bmgsm forget.

  • Can I link more than one server?

    Yes. You can link as many servers as you have on your account. Each one gets its own embed and can be placed in a different channel if you like. Run /bmgsm link for each server you want to add.

  • Why did my embed disappear?

    If the embed message is manually deleted from Discord, the bot will automatically post a fresh one the next time it polls. You don't need to do anything — it should reappear within a few seconds.

  • What does the error embed mean?

    If the embed shows an error instead of your server stats, it usually means the bot couldn't reach the panel at that moment — for example if the panel is briefly offline or your server is being reinstalled. It will go back to normal automatically once the panel is reachable again.

  • Who can press the Start, Stop, and Restart buttons?

    Anyone who can see the channel the embed is posted in. If you want to restrict access, place the embed in a channel that only certain roles can view.

  • Can I have embeds in multiple Discord servers?

    Yes. The bot can be added to as many Discord servers as you like. Each Discord server manages its own linked embeds independently.

Got a suggestion?

We're always looking to improve BMGServerManager. If you have a feature idea or something you'd like to see added, we'd love to hear from you — head over to our Discord and let us know in the suggestions channel.

Post a Suggestion