IPWhitelister
A lightweight Paper/Spigot plugin (Minecraft 1.21–1.21.8) that restricts player logins by IP address, with full configurability and Discord webhook notifications.
Quick challenge
How far can you run before the mobs catch you?
Minecraft check
Confirm your run
Complete the quick check to get your code.
IPWhitelister
📖 Description
IPWhiteLister is a simple yet powerful plugin for Minecraft server administrators who want fine‑grained control over player access by IP address.
✨ Features
🔒 Per‑player IP whitelist Define a list of allowed IP addresses for each player.
🌍 Flexible access logic
Players not listed in the config can join from any IP.
Players listed in the config are checked against their allowed IPs.
📢 Discord notifications
Sends a webhook message whenever a player attempts to join from a blocked IP.
⚡ Admin commands
/ipwhitelist add <player> <ip> — add an IP to a player
/ipwhitelist remove <player> <ip> — remove an IP from a player
/ipwhitelist list <player> — list all IPs for a player
/ipwhitelist delete <player> — completely remove a player from the whitelist
/ipwhitelist reload — reload the configuration without restarting the server
⚙️ Configuration
All messages and notifications are configurable in config.yml. Supports placeholders %player% and %ip%.
``` discord-webhook: "https://discord.com/api/webhooks/YOUR_WEBHOOK_URL"
messages: kick-ip-not-allowed: "§cYour IP is not allowed on this server!" console-blocked: "%player% was blocked with IP: %ip%" discord-blocked: "🚫 Player %player% tried to join with a blocked IP: `%ip%`"
players: Rodion: - "127.0.0.1" - "192.168.1.100" ```