# NewMinecraftServers Companion
NewMinecraftServers Companion connects your Paper server to [NewMinecraftServers](https://newminecraftservers.net/), a free Minecraft server list.
**Features**
Claim your listing in one command. Start a claim on the website, then run /nms claim
. The plugin shows the code in your server list for up to two minutes and restores your normal MOTD as soon as it's verified. It never edits server.properties.
Live status in game. /nms status compares what the website sees with your server right now.
Player and uptime history. /nms stats shows peak and average players, uptime, and busiest times (90 days once linked).
Look up any listed server with /nms lookup .
Works from the console and in game. Clickable help, links, and copyable codes.
**Requirements**
Paper 1.20.4 or newer (tested on 1.20.4 and 26.2). Spigot is not supported.
**Commands**
/nms help | status | stats [24h|7d|30d|90d] | lookup | listing: everyone
/nms claim | claim cancel | link | unlink | reload: operators
**Permissions**
newminecraftservers.status, .lookup, .listing (default: everyone)
newminecraftservers.claim, .link, .reload (default: op)
Privacy
The plugin only talks to newminecraftservers.net. It sends your server's address, your claim code, or its link token when you run a command that needs them. It never sends player names, UUIDs, IPs, chat, or analytics. The source code is public: [GitHub](https://github.com/aarongainz/newminecraftservers-companion).Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.20, 1.21, 1.21.1
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Hangar — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
newminecraftservers is a free Minecraft Java mod. Compatible with Minecraft 1.20, 1.21, 1.21.1, 1.21.10 and newer. Available via Hangar. Download it and open it directly in the game.