🔒 ipsSecurityList
Advanced IP-based security for Paper & Spigot servers.
ipsSecurityList adds a powerful network-level protection layer to your Minecraft server by allowing only approved IP addresses and networks to connect.
Whether you're running a private SMP, a development environment, an admin-only server, or a hardened infrastructure setup, ipsSecurityList helps keep unwanted connections out before they even reach your server.
Because sometimes a whitelist isn't enough.
✨ Features
🌐 IP Allowlist Protection
Allow only specific IP addresses or networks to join your server.
📡 IPv4 & IPv6 Support
Full support for both modern internet protocols.
🎯 CIDR Range Support
Allow entire network ranges with flexible CIDR notation.
⚡ Async Pre-Login Protection
Blocks unauthorized connections before the login process completes.
🚦 Connection Rate Limiting
Reduce spam, scanning attempts, and connection abuse.
⏳ Temporary Access System
Grant temporary access without modifying permanent configurations.
🚨 Panic Mode
Instantly lock down your server when needed.
📢 Discord Webhook Logging
Receive security events directly in your Discord server.
🔄 Trusted Proxy Support
Works correctly behind modern proxy and forwarding setups.
📝 Per-IP MOTD Responses
Display custom messages based on connection source.
👤 UUID Whitelist Support
Combine network restrictions with player identity verification.
⚙️ YAML Configuration
Simple and familiar configuration system.
🪶 Lightweight & Optimized
Built for minimal performance impact.
🧩 Modern Paper API
Designed using modern Paper development practices.
🔄 Reload-Safe Architecture
Configuration reloads without unnecessary instability.
🐞 Detailed Logging & Debug Mode
Get the information you need when troubleshooting.
🎯 Why ipsSecurityList?
Traditional Minecraft whitelists only verify usernames and UUIDs.
ipsSecurityList adds a network-level verification layer, preventing unauthorized users from reaching the server login process in the first place.
This makes it especially useful for:
- 🏠 Private SMP servers
- 🧪 Development & testing environments
- 👑 Admin-only servers
- 🌍 LAN-over-hosting setups
- 🛡️ Hardened public infrastructure
⚡ Performance
ipsSecurityList uses asynchronous login handling and efficient in-memory caching to minimize overhead and avoid unnecessary processing during connection attempts.
Security shouldn't come with a TPS tax.
🛠️ Commands
/ipsl reload
/ipsl allow <ip>
/ipsl remove <ip>
/ipsl tempallow <ip> <time>
/ipsl panic
🔑 Permissions
ipssecuritylist.admin
ipssecuritylist.reload
ipssecuritylist.allow
ipssecuritylist.remove
ipssecuritylist.panic
📋 Configuration
Everything is configurable through config.yml, including:
- Allowed IP addresses
- CIDR network ranges
- Discord webhook integration
- Custom MOTDs
- Rate limits
- Proxy settings
- Debug options
🔐 Security Recommendations
For maximum protection, combine ipsSecurityList with:
online-mode=true- Proper proxy forwarding configuration
- Firewall rules
- Network-level rate limiting
A plugin can guard the gate.
A firewall makes sure nobody even finds the gate.
