What it does
Claim your server and track its players, in game
Claim your listing
Run /nms claim with the code from the website. We spot it in your server list, and the listing is yours.
Track your player base
Link once, then /nms stats shows peak and average players, uptime and busiest hours over up to 90 days.
Look up other servers
Check any listed server with /nms lookup. Handy for sizing up a rival or picking the best time for an event.
No player data sent
It never sends player names, UUIDs, IPs or chat, and only talks to newminecraftservers.net when you run a command.
How it works
Set up in three steps
Drop in the jar
Download it from SpigotMC or BuiltByBit, put it in your plugins folder and restart. Needs Paper 1.20.4+.
Link and claim
Run /nms link <address> for stats, then /nms claim <code> with the code from the website to take ownership.
Check your numbers
Run /nms stats any time. The same numbers are on your listing’s Stats tab on the website, with full charts.
Not claimed yet? Start from Claim your listing to get your code. The plugin is one of three ways to verify.
Commands
Every command
| Command | What it does | Who can run it |
|---|---|---|
/nms status | What the website saw on its last check, next to your live player count. | Everyone |
/nms stats [24h|7d|30d|90d] | Peak and average players, uptime, busiest hour and weekday. | Everyone |
/nms lookup <address> [24h|7d|30d] | The same numbers for any server on the list. | Everyone |
/nms listing | A clickable link to your listing. | Everyone |
/nms claim <code> | Proves you own the server, using the code from the website. | Operators |
/nms claim cancel | Stops a running claim and restores your MOTD straight away. | Operators |
/nms link <address> | Connects this server for 90-day history, adding it to the list if it is new. | Operators |
/nms unlink | Disconnects the server. The public listing and its history stay. | Operators |
/nms reload | Reloads the config file. | Operators |
/newminecraftservers works as an alias. Permissions are newminecraftservers.status, .lookup and .listing (everyone) and .claim, .link and .reload (operators).
Privacy
Nothing about your players leaves the server
- No player names, UUIDs, IP addresses or chat.
- No analytics, ads or background reporting.
- Only talks to newminecraftservers.net, which is compiled in.
- Every command works from the console as well as in game.
Open source under the MIT license
Every line is on GitHub. Check what it sends before you install it, build the jar yourself, or open an issue or pull request if something is missing.
FAQ
Questions about the plugin
Is the plugin free?
Yes. It is free on SpigotMC and BuiltByBit, has no paid tier, and the code is open source under the MIT license.
Does it work on Spigot, Purpur or Folia?
It runs on Paper 1.20.4 and newer, tested up to 26.3. Paper forks like Purpur should work. Plain Spigot and Folia are not supported.
Does it work behind BungeeCord or Velocity?
Install it on a backend Paper server. The proxy answers the server list, so to claim, put the code in your proxy MOTD or use the DNS check.
Do I need the plugin to claim my server?
No. You can add a code to your MOTD yourself or use a DNS TXT record. The plugin is just quickest, and it restores your MOTD for you.
Where do the player numbers come from?
From our own checks. We ping every listed server the way the game does, every few minutes. Nothing is counted inside your server.
Will it slow my server down?
No. It does nothing until someone runs a command, web requests run off the main thread, and results are cached for a minute.
Put your server’s numbers one command away
Rather use the website? Every listing has a Stats tab with the full charts, and adding your server is free.