BotGuard

BotGuard is a small Spigot/Paper plugin for whitelist servers that still get noisy scanner traffic. It scores suspicious login attempts, bans obvious bot IPs, and keeps a simple login history so admins can see which players use which addresses.

Features

• nickname pattern scoring, for names like Test379455 or Player123456;
• automatic IP ban when the score reaches the configured threshold;
• login history by player name and IP address;
• OP/admin alert when a whitelisted player logs in from a new IP;
• commands for checking recent logins, shared IPs, and suspicious accounts;
• plain YAML storage, no database setup required.

Build

Open the folder in IntelliJ IDEA as a Maven project, or build it from PowerShell:

powershell -NoProfile -ExecutionPolicy Bypass -File .\build.ps1

The jar will be created here:

target/BotGuard-1.0.0.jar

Install

1. Build the jar.
2. Put target/BotGuard-1.0.0.jar into the server plugins folder.
3. Start the server once.
4. Edit plugins/BotGuard/config.yml.
5. Run /botguard reload.

Commands

/botguard reload
/botguard test <nick> [ip]
/botguard player <nick>
/botguard ip <ip>
/botguard recent
/botguard suspicious
/botguard stats
/botguard pardonip <ip>

Permission: botguard.admin (op by default).