The Lobbydex bot brings live Minecraft data into your Discord: status panels that keep themselves up to date, charts, vote rewards and lookups. Add it to a server you manage, then type /help.
Commands
| Command | What it does | Who |
|---|---|---|
| /server | Status, players, version, addresses, ping and a 24 h chart, with Vote and Open buttons. | Anyone |
| /top | The busiest servers right now (Java, Bedrock or both). | Anyone |
| /graph | Players or ping over 24 hours, 7 days or 30 days, as a chart. | Anyone |
| /vote | A vote button and the server's votes and rank this month. | Anyone |
| /random | A random busy server to try, optionally by game mode. | Anyone |
| /status add · remove · list · clear | Live status panels (below). | Manage Server |
| /rewards setup · off · list | Vote rewards (below). | Manage Server |
| /help | This list, in Discord. | Anyone |
Live status panels
/status add server:posts a panel in the channel (or the one you pick) and edits it every 2 minutes: status, players, ping, version, addresses and rank.- Run it again with another server to add it to the same panel: up to 10 servers a panel, 10 panels a Discord server.
alerts:truealso posts when a server goes down or comes back. A single-server panel shows a 24-hour players chart (graph:falseturns it off).- Delete the panel message by accident and it's posted again; remove it for good with
/status clear.
Vote rewards
/rewards setup server: role: channel: hours:: when someone in your Discord votes for your server on Lobbydex, they get the role for that many hours (24 by default) and a thank-you in the channel. Either one on its own works too.- Votes count when the voter signs in to Lobbydex with the same Discord account. The role comes off by itself when the time is up; voting again extends it.
- Put the Lobbydex role above the reward role in Server Settings → Roles, or Discord won't let the bot give it.
- In-game rewards are separate: Votifier or the Lobbydex plugin, set up on your listing's manage page.
Listing and verifying your Discord
Adding the bot to your own Discord server also lists it on Lobbydex if it isn't yet, claims it to your account and marks it Bot verified. The bot makes a permanent invite so the listing never shows a dead link.
Permissions it asks for
| Permission | Why |
|---|---|
| Create Invite | List your Discord on Lobbydex and replace its invite if it stops working. |
| View Channels, Send Messages, Embed Links | Status panels, alerts and vote thank-yous. |
| Manage Roles | Vote reward roles, and taking them back when they run out. |
It never reads messages. Slash commands work without any of these.
Charts anywhere
The charts are plain images, so they work on sites and READMEs too:
URL
https://lobbydex.com/api/chart/{slug}.png?metric=players&range=week&theme=dark| Parameter | Values | Default |
|---|---|---|
| metric | players, ping (Minecraft) | players |
| range | day, week, month | day |
| p | minecraft, discord, bots | minecraft |
| theme | dark, light | dark |