Skip to content

The Lobbydex plugin: listing, live map and vote rewards

By the Lobbydex teamUpdated 6 min read
Short answer

Drop one jar into Spigot, Paper, Purpur or Folia: your server is listed and verified on its own, gets a live 3D map of its worlds, and takes votes with no Votifier port.

On this page11 sections

The Lobbydex plugin puts your server on Lobbydex and keeps it up to date. Drop it in and restart: there's nothing to set up. It's free, about 190 KB, and needs no open port.

What you get

  • Listed and verified on its own. On first start the plugin finds your listing (or creates one, never a duplicate) and gets it verified by plugin within a few minutes.
  • Your real player count, read from the server itself, every minute.
  • A live map of your worlds (1.13+): a 3D, textured map on your page that follows what players build (below).
  • Vote rewards with no open port. Votes arrive over the plugin's own connection, and your reward plugin keeps working.
  • TPS, uptime and your plugin list on your page, if you want them shown.
  • Your 3D lobby, kept current (1.13+), so our bot doesn't have to join.

Install it

  1. Download the plugin and put the jar in your server's plugins folder.
  2. Restart the server.
  3. Run lobbydex status on the console. Within a few minutes it says verified, and your map starts filling in.

That's all most servers need. If Lobbydex can't work out your address (shared hosts, unusual setups), set address: "play.yourserver.com" in plugins/Lobbydex/config.yml and restart.

Manage it from your account

The plugin lists your server, but the listing becomes yours (to edit, add a description, set up votes) when you claim it. On the console, run lobbydex claim, open the link it prints, and sign in with Discord. The link works once, for 30 minutes, so don't share it.

Type your address here to copy the exact command:

  1. Download the Lobbydex plugin 3.1.0 and put it in your server's plugins folder, then restart.
  2. Run this on the server console:lobbydex claim play.yourserver.com
  3. Open the link it prints, sign in with Discord and confirm. The listing is yours and verified.

Already claimed the listing? Link the plugin to it instead: on the listing's Manage page, under Lobbydex plugin, choose Create setup code, then run lobbydex setup LDX-XXXX-XXXX-XXXX on the console.

The plugin makes its own signing key and keeps it in plugins/Lobbydex/identity.properties. Keep that file private. If it leaks, run lobbydex rotate: the old key stops working at once.

The live map

Your page gets a map of every world, in 2D and in 3D (fly around with WASD), with real block shapes, textures and map art in item frames. It stays current as players build.

What leaves your server: only the visible surface. Each column goes from its top block down to the ground plus 2 blocks, plus the ground that open air reaches under platforms, bridges and overhangs.

What never does: caves, ores, closed rooms, anything deeper, and any area or world you hide.

How it stays light:

  • Only changed chunks are sent: each chunk's hash is compared first.
  • Reading runs in the background, at chunks-per-second you set.
  • On Paper, Purpur and Folia, parts of your worlds explored before the plugin was installed fill in from disk. Nothing is ever generated.

Builds made with commands show up too. /fill, /setblock, /clone and WorldEdit or FAWE (from players, the console, RCON or command blocks) update the map within seconds. Plugins that change blocks directly are caught by a re-read every 5 minutes.

Your controls, on your Manage page or in game:

  • Hide a world: lobbydex map hide-world <world> (and show-world).
  • Hide an area: lobbydex map hide-area <name> <radius> where you stand. On the console: lobbydex map hide-area <name> <world> <x1> <z1> <x2> <z2>. Hidden areas are removed from Lobbydex at once and never uploaded again; lobbydex map show-area <name> brings one back.
  • Show players: lobbydex map players on. Vanished players, spectators and anyone with lobbydex.map.hidden never show.
  • Depth: lobbydex map depth <0-16> sets how many blocks under the ground are kept (2 by default).
  • Pause or catch up: lobbydex map pause, resume, and resync to send everything again.

lobbydex map on its own shows how the map is doing: chunks sent, what's waiting, and how long reading takes.

Vote rewards

With vote-rewards: true (the default), votes on Lobbydex go to the plugin instead of your Votifier port:

  • NuVotifier installed? Each vote is fired as a normal Votifier vote from the service Lobbydex, so VotingPlugin, SuperbVote and the like reward it as usual. You can close the Votifier port to the internet.
  • No NuVotifier? List console commands under vote-commands in plugins/Lobbydex/config.yml, with {player} for the voter's name.

Votes wait up to 7 days if the server is down, and each vote is rewarded once, even across restarts.

Commands

All commands need lobbydex.admin (ops by default).

  • lobbydex status: verified or not, your listing link, and what's been sent.
  • lobbydex claim [address]: a link to claim the listing with your Lobbydex account.
  • lobbydex setup <code>: link the plugin to a listing you already claimed.
  • lobbydex map ...: the live map (see above).
  • lobbydex rotate: replace the signing key.
  • lobbydex unlink: disconnect the plugin from its listing.

Settings

In plugins/Lobbydex/config.yml (restart after changing it):

  • auto-setup: list and verify on first start (on). false links only with claim or setup.
  • address, server-name: the address players use and the name for a new listing, if Lobbydex can't work them out.
  • map.enabled, map.worlds, map.exclude-worlds: which worlds go on the map.
  • map.chunks-per-second, map.fill-in-explored, map.fill-in-per-second: how fast the map is read and filled in.
  • map.players-every-seconds, map.recheck-minutes: player marker and re-read intervals.
  • vote-rewards, vote-commands: as above.
  • share-performance, report-plugins: show TPS and uptime, and your plugin list (both on).
  • lobby-capture, lobby-capture-location: the 3D lobby view. Only loaded chunks are read, with positions relative to spawn.
  • update-check: once a day, look for a newer signed release and say so on the console. It never downloads or installs anything.

Which servers it runs on

One jar for Spigot, Paper, Purpur and Folia, Minecraft 1.8.8 and newer, Java 8 or newer. The live map and lobby captures need 1.13 or newer.

On Paper the Lobbydex check rides in the player list you see when hovering over the player count. Spigot can't change that list, so there it shows as a dark gray line under your MOTD, only for the few minutes a day a check is due.

Behind a proxy?

On a Velocity network our checks reach the proxy, not the backends, so install the Lobbydex plugin for Velocity on the proxy. A backend behind a proxy sees it and doesn't try to verify, so it doesn't list itself either. The live map isn't available for backends behind a proxy yet. BungeeCord isn't supported yet.

For plugin developers

Other plugins can talk to Lobbydex through com.lobbydex.api.LobbydexApi, from Bukkit's services manager:

  • markChanged(location), or a chunk or area: tell the map about block edits that fire no events.
  • setHiddenOnMap(uuid, true): keep a player off the map (for vanish plugins).
  • isMapActive(), isVerified(), listingUrl().

What's new

Lobbydex plugin releasesDownload 3.1.0· 184 KB
  1. 3.1.0latestNov 17, 2026
    • Block shapes on the live map: slabs, stairs, doors, trapdoors, fences, walls, panes, logs and the rest now show with their real shape and rotation. Only the properties that change how a block looks are sent (facing, half, shape, axis...), never things like power or age. Every chunk is sent once more after the update to pick this up.
    • Map art: maps in item frames (glow frames too) show on the live map. Each map's picture is sent once and again only when it changes; placing, turning or knocking out a framed map updates the map within seconds, and the regular re-check catches maps drawn later. Frames in hidden areas, or below the mapped surface, are never sent. Maps a plugin draws per player have no picture on the server and stay blank.
    • Ground under overhangs and platforms: the live map now keeps the ground that open air reaches under floating platforms, bridges, cliff overhangs and big trees, so there are no more holes under them in the 3D view. Caves and closed rooms still stay off the map.
    • Water and other tall stretches of one block are stored as vertical runs, so map uploads are smaller.
    • On-server lobby captures keep block shapes and rotation too.
    • lobbydex map shows how many maps are on Lobbydex and waiting to be sent.
    • Builds from the console, RCON or command blocks (/setblock, /fill, /clone) now update the map within seconds, like a player's; before, they waited for the regular re-check.
    • Nothing to set up. Drop the jar in and restart: on its first start the plugin lists your server on Lobbydex (or finds its listing, without duplicating it), and within a few minutes it's verified. lobbydex claim still ties the listing to your Lobbydex account whenever you like. auto-setup, address and server-name in config.yml cover servers Lobbydex can't find on their own.
    • Live world map (1.13+): your listing gets a map of every world, kept up to date as players build. Only the visible surface leaves the server (down to the ground plus 2 blocks by default: no caves, no ores), only chunks that changed are sent (each chunk's hash is compared first), and the reading runs gently in the background. On Paper and Purpur (and Folia) the parts of your worlds explored before the plugin was installed fill in too, loaded from disk and never generated.
    • The Nether's map shows its floor, not the bedrock roof.
    • Owner controls, on your manage page or in game: hide worlds, hide areas (lobbydex map hide-area <name> <radius> where you stand), show players on the map, change the depth. Hidden areas are removed from Lobbydex at once and never uploaded again. Vanished players, spectators and anyone with lobbydex.map.hidden never show.
    • Builds made with commands show up too: /fill, /setblock, /clone, /place and WorldEdit or FAWE commands mark the area around whoever ran them, and loaded chunks are re-read every 5 minutes (map.recheck-minutes) for plugins that edit blocks directly.
  2. 2.1.0Nov 15, 2026
    • Update notices: once a day the plugin checks lobbydex.com for a newer stable release and, only when its Ed25519 release signature checks out against the key built into the plugin, says so on the console and in lobbydex status, with the download page. It never downloads or installs anything. update-check: false turns it off.
  3. 2.0.0Nov 15, 2026
    • One jar for Spigot, Paper, Purpur and Folia, Minecraft 1.8.8 to current, on Java 8 or newer. Rewritten from the ground up: no Paper-only or new-Java APIs, with Paper and Folia features found at runtime. Keys from 1.0 load unchanged.
    • On Spigot (and Paper before 1.12), the server list has no player sample to add to, so the Lobbydex check shows on a dark gray line under the MOTD while a proof is due (a few minutes a day at most). Paper keeps it in the player hover list.
    • TPS on Spigot is measured by the plugin (Paper reports its own). Folia reports no TPS (it runs one per region).
    • Lobby captures from the plugin (1.13+): about once a week, when Lobbydex asks, the plugin reads the loaded chunks around spawn and sends the blocks for the 3D lobby view on your listing. Positions are relative to spawn, never world coordinates, and nothing is loaded or generated for it. lobby-capture: false turns it off; lobby-capture-location: "world,x,y,z" points it at a lobby away from the world spawn.
    • Running a network? The new Lobbydex for Velocity goes on the proxy, where our checks arrive; on a backend behind a proxy this plugin says so.

See the downloads page for every version, its changelog and checksums.

Was this helpful?