Checks every incoming connection on AbuseIPDB and kicks if the score is higher than or equal to a preconfiged threshold.
AbuseIPDB-Blacklist
A Paper plugin that checks and kicks connections from IP addresses flagged on AbuseIPDB with a customizable reports threshold.
Prerequisites
- A PaperMC server running on 26.2 or higher
- An AbuseIPDB account and an API key (Free tier allows 1,000 requests/day, verified domain owners get 3000/day)
Installation
- Download the latest version of the plugin
- Drop it in your server's plugin folder
- Restart your server to generate the config.yml file
Configuration
plugins/AbuseIPDB-Blacklist/config.yml:
plugin-settings:
ip-report-threshold: 15
abuseipdb:
api-key: "YOUR_KEY_HERE"
max-age-days: 90
| Key | Description |
|---|---|
plugin-settings.ip-report-threshold |
The AbuseIPDB abuse confidence score (0-100) at or above which a connecting IP will be denied. |
abuseipdb.api-key |
Your AbuseIPDB API key. Get one from your AbuseIPDB account dashboard. |
abuseipdb.max-age-days |
Only considers AbuseIPDB reports from within this many days when calculating the abuse score. (How new the reports have to be to count) |
Commands
| Command | Description | Permission |
|---|---|---|
/toggleipdb |
Toggles the blacklist check on/off. Resets to enabled on server restart. | abuseipdb-blacklist.toggle |
/checkip <IP address> |
Checks an IP address on-demand, gives confidence report and adds to the IP address cache | abuseipdb-blacklist.checkip |
API Rate limits
AbuseIPDB have various limits, you can increase the free limit to 3000 by verifying a domain, and to 5000 by adding a contributor badge to your website.
| Tier | Rate limit |
|---|---|
| Free | 1,000 reqs/day |
| Free + Domain | 3,000 reqs/day |
| Free + Domain + Contributor Badge | 5,000 reqs/day |
| Basic ($19/mo OR $228/yr) | 10,000 reqs/day |
| Premium ($89/mo OR $1,068/yr) | 50,000 reqs/day |
For more information regarding rate-limits or pricing, check out AbuseIPDB's official API documentation.
License & Copyright
This project is licensed under the MIT license.
This means that you are free to use, copy, modify and otherwise distribute this project so long as you keep the original copyright notice.
© AlexNor.Eu 2026 [email protected]
Pages
Members