🔒 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.