Mitigation

Filtering settings determine how MineGuard handles incoming connections to your server.

CPS threshold

CPS (Connections Per Second) is the number of new connections per second. When CPS exceeds the threshold, enhanced filtering activates.

Configured in the panel. The default value works well for small servers. For larger projects with frequent connections, raising the threshold is recommended.

Ban duration

How long a suspicious IP is blocked after triggering the filter. Configured in the panel.

Allow duration

How long a verified player is allowed access without being re-checked. Configured in the panel.

Mitigation message

The message a player sees while being checked. Supports Minecraft color codes (§). Maximum 200 characters.

Session limits

Max sessions per IP — limits the number of simultaneous connections from a single address. Useful against bots that swarm from the same IP.

Max logins per second — rate limit for connections from a single IP (0–100). Protects against rapid connection spamming.

Reconnect cooldown — delay before reconnecting after a disconnect (0–60 seconds).

VPN/Proxy blocking

Blocks connections via VPNs, proxy servers, and data centers. Two possible actions:

• Block — deny the connection entirely
• Captcha — redirect to the web captcha for verification (requires Captcha to be enabled)

Client blocking

You can block connections from specific client types:

• vanilla — unmodified client
• forge — Forge mod loader
• fabric — Fabric mod loader

Enhanced filtering

Additional checks during connection filtering. Enabled via a separate toggle in the network settings.