Prints every banned IP address on the server so you can copy the exact entry into the field above.
Run from the server console or as an operator (permission level 3). The ban lifts immediately, no restart needed.
/pardon-ip only lifts IP bans from banned-ips.json. If the player was banned with /ban, their account sits in banned-players.json and stays blocked until you also run /pardon with their name. Players hit by /ban-ip while online often have both entries.
The /pardon-ip command lifts an IP ban. Give it the exact IPv4 address that was banned with /ban-ip and the server removes the entry from banned-ips.json immediately, letting everyone on that address connect again with no restart required.
Unlike /ban-ip, which accepts the name of an online player, /pardon-ip takes only a raw IPv4 address: four numbers from 0 to 255 separated by dots. The server checks the format first, so a player name, an IPv6 address or a typo fails with Invalid IP address before the ban list is even consulted. If the format is fine but the address is not on the list, you get Nothing changed. That IP isn't banned instead.
Running it requires permission level 3, so any operator on a default server (ops get level 4) and the server console both qualify. Like the rest of the ban commands, it exists on multiplayer servers only; singleplayer and LAN worlds never register it. The unban is written straight to banned-ips.json and takes effect on the next connection attempt.
The full syntax, straight from the game's command tree:
/pardon-ip <target>Copy-ready examples:
/banlist ipsStep one: prints every banned IP address so you can copy the exact entry to pardon./pardon-ip 198.51.100.7Lifts the IP ban on 198.51.100.7 and removes the entry from banned-ips.json./pardon-ip 203.0.113.25Same command, different address. The target must match the banned entry exactly./pardon SteveThe account-ban counterpart: removes the player Steve from banned-players.json./ban-ip 198.51.100.7 GriefingThe inverse command, if you ever need to put the IP ban back with a reason.Most failed unbans come down to pardoning the wrong thing, so it pays to follow the whole flow:
1. Run /banlist ips from the console or as an operator. It prints every banned address along with who banned it and why.
2. Copy the address character for character and run /pardon-ip with it, or paste it into the generator above and copy the finished command.
3. The server confirms with Unbanned IP and deletes the entry from banned-ips.json. The player can reconnect immediately; nothing needs a restart.
4. If they still cannot join, check /banlist players: a player banned with /ban as well needs a separate /pardon PlayerName to clear the account ban.
There is also a manual route: stop the server, open banned-ips.json next to the server jar, delete the object whose ip field matches, save and start the server again. That is the only way to remove an entry that /pardon-ip cannot parse, such as an IPv6 address picked up by banning an online player on an IPv6 connection. Editing the file while the server is running does not work, because the server rewrites it from memory.
Run /pardon-ip followed by the exact banned address, for example /pardon-ip 198.51.100.7, from the server console or as an operator with permission level 3. If you do not know the address, run /banlist ips first to print every banned IP. The ban lifts the moment the command runs and the player can reconnect immediately.
The target must match the IPv4 pattern: four numbers from 0 to 255 separated by dots. Player names, hostnames, IPv6 addresses and typos all fail with that error before the ban list is even checked. To unban an account use /pardon with the player name; to remove an IPv6 entry, stop the server and delete it from banned-ips.json by hand.
The address you typed is not in banned-ips.json. Either it has a typo, the ban was already lifted, or the player was banned by account with /ban rather than by IP. Run /banlist ips to see the exact entries and copy the address character for character.
No. The command removes the entry from banned-ips.json on the spot and the unban takes effect immediately. The player from that address can reconnect the next time they try, with no restart, reload or whitelist change needed.
No. Minecraft servers keep two separate ban lists: /pardon-ip removes entries from banned-ips.json only, while account bans live in banned-players.json and are lifted with /pardon followed by the player name. A player who was banned both ways needs both commands before they can join again.
No. The ban family of commands (/ban, /ban-ip, /banlist, /pardon and /pardon-ip) is only registered on dedicated multiplayer servers. Singleplayer worlds and LAN sessions never have IP bans to lift, so the command simply does not exist there.
Need to ban an address instead? Or browse more Minecraft tools: