AbuseIPDB-Blacklist

# AbuseIPDB-Blacklist A Paper plugin that checks and kicks connections from IP addresses flagged on [AbuseIPDB](https://www.abuseipdb.com) with a customizable reports threshold. ## Prerequisites - A [PaperMC](https://papermc.io/) server running on 26.2 or higher - An AbuseIPDB account and an [API key](https://www.abuseipdb.com/account/api) (Free tier allows 1,000 requests/day, verified domain owners get 3000/day) ## Installation 1. Download the latest version of the plugin 2. Drop it in your server's plugin folder 3. Restart your server to generate the config.yml file ## Configuration **plugins/AbuseIPDB-Blacklist/config.yml:** ```yaml 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](https://www.abuseipdb.com/account/api). | | `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 ` | 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](https://docs.abuseipdb.com/). ## License & Copyright This project is licensed under the [MIT](https://opensource.org/license/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 [alex@alexnor.eu](mailto:alex@alexnor.eu)