Minecraft Server Status Module
Polls a Minecraft Java server and keeps a live Components V2 status message in Discord with player count, MOTD, version, and latency.
Overview
Lio pings your Minecraft Java server on a schedule and edits one status message in Discord — no manual updates needed.
When the server is online, the panel shows MOTD, player count (with a visual bar), optional online player names, version, ping, and the join address.
When the server is offline or unreachable, the panel switches to an offline layout with the server address and a short hint.
Only Minecraft Java Edition is supported (Server List Ping). Bedrock servers are not compatible with this module.
Setup
- Dashboard → Server → Modules → Minecraft Server Status → Enable.
- Open Configure — set Host / IP (e.g. play.example.com) and Port (default 25565).
- Pick a Status channel (text or announcement) where the live panel should live.
- Set Update interval (minutes) — how often Lio re-checks the server (1–30, default 2).
- Save settings — Lio posts the status message on first save when a channel is set.
- Use Resend panel in the sidebar if the message was deleted or you changed the channel.
The bot must stay online for polling. Updates stop if the module is disabled or host/channel fields are empty.
Key settings
- Host / IP — hostname or IP shown to members; SRV records (_minecraft._tcp) are resolved automatically when present.
- Port — query port (default 25565); omitted from the displayed address when it is the default port.
- Status channel — single message is created and edited in place on each poll.
- Update interval — minimum one check per minute; typical values 2–5 minutes.
- Show MOTD — message of the day from the server list response.
- Show version — reported Minecraft version string.
- Show player count — online/max with a progress-style bar when max players is known.
- Show latency — round-trip ping in milliseconds from the bot host to the game server.
- Show online player sample — up to eight usernames when the server exposes them.
Status panel & embed draft
By default Lio uses a built-in Components V2 layout (green when online, red when offline) with a footer timestamp on each update.
Optional: edit the Status embed draft in the module sidebar to customize the banner area. Lio injects live stats below your design and replaces placeholders in text fields.
- {status} — full formatted stats block (online/offline details)
- {online} — online or offline
- {players} — current player count
- {maxPlayers} — max slots
- {motd} — message of the day (formatting codes stripped)
- {version} — server version
- {latency} — ping in ms or — when unknown
Use {status} in a text block for a compact all-in-one section, or combine individual placeholders for a custom layout.
How updates work
The bot checks your server on a schedule and updates the same Discord message in your status channel.
The message ID is remembered so each update edits in place — not a new post every time.
Changing host, port, or display toggles takes effect on the next check after you save. Resend panel forces a fresh message if needed.
Usage in Discord
- Members read the status channel — there are no slash commands or buttons for this module.
- Share the channel link so players see live occupancy before joining.
- Panel text follows the server bot language (Dashboard → Settings → Bot language) for built-in labels.
Troubleshooting
- Always offline → wrong host/port? Firewall blocking the bot server? Game server down?
- Bedrock server → use a Java server or a Bedrock-specific tool; this module uses Java ping only.
- No panel message → status channel set and saved? bot Send Messages + Embed Links in that channel?
- Panel not updating → module enabled? bot online? interval not set too high for your test?
- Wrong player count → server hides player list or uses plugins that alter list ping data.
- SRV not applied → DNS must expose _minecraft._tcp for your hostname; otherwise use the real host/port manually.
- Deleted message → click Resend panel in module config to post a new one.