🎣 AntiAutoFish
Smart Anti-Autofish Plugin with Shield System & FishBan
📖 Description
AntiAutoFish is a comprehensive anti-autofish plugin for Paper/Spigot servers. Unlike other plugins that use simple detection methods, it offers an intelligent CAPTCHA system with rewards, a FishBan system for temporarily banning suspicious players, and a unique Shield system that rewards fair players.
📚 Full Wiki & Documentation
✨ Features
- 🎯 Smart CAPTCHA - Players see a GUI with fish and trash items and must click on the correct fish
- 🛡️ Shield System - Fair players earn a shield that protects them from CAPTCHA for a set duration
- ⛔ FishBan - Players who repeatedly fail CAPTCHA receive a temporary fishing ban
- 🎁 Rewards - Configure rewards (commands/messages) for successfully completing CAPTCHA
- 🌍 Multi-world - Enable or disable the plugin per world
- 🌐 Multi-language - Built-in support for English, Czech, German, Spanish, Russian, and Japanese
🖼️ GUI Examples
| With Resource Pack | Vanilla (No Resource Pack) |
|---|---|
 |
 |
GUI Design inspired by InfiniteFishing - Custom Fishing Games.
Note: The custom resource pack shown in the "With Resource Pack" image is not included in this plugin.
⚙️ How It Works
- When a player catches a fish, there's a configurable chance (%) to trigger a CAPTCHA
- A GUI opens with random fish and trash items - the player must click on a fish
- Clicking on trash counts as a wrong click - after X wrong clicks, the player fails
- Successful CAPTCHA completions grant rewards and count toward Shield progress
- After Y successful CAPTCHAs, the player receives a Shield
- While shielded, the player is immune to CAPTCHA for the shield duration
- Failed CAPTCHAs count toward the threshold - after Z failures, the player gets a fishing ban
🛡️ Shield System Details
The Shield system is what makes this plugin unique:
- Dynamic Duration - Shield duration is calculated based on player performance (faster = longer shield)
- Cooldown - After shield expires, players enter a cooldown before earning another
- Configurable - Min/Max duration, cooldown length, and required tests are all configurable
- Admin Commands - Give or remove shields/cooldowns manually
💬 Discord Webhook Integration
Send real-time notifications to your Discord server for all important events:
- Fishing Ban - When a player is banned from fishing
- Fishing Unban - When a player is unbanned (admin or expired)
- Player Kick - When a player is kicked for failing CAPTCHA
- CAPTCHA Failed - When a player fails the CAPTCHA test
- CAPTCHA Passed - When a player passes the CAPTCHA test
- Shield Received - When a player receives a shield
- Shield Expired - When a player's shield expires
Features:
- Fully customizable embeds (title, color, description, thumbnail, footer)
- Individual on/off toggle for each event
- Player avatar support via Cravatar
- Placeholder support:
$playerName,$executor,$duration,$reason,$extra,$failed - Toggle expired ban notifications separately
📋 Commands & Permissions
Main Command: /antiautofish, /aaf, /antifish
| Command | Description | Permission |
|---|---|---|
/aaf reload |
Reload the configuration | antiautofish.admin |
/aaf stats [player] |
View player statistics | antiautofish.stats |
/aaf shield <player> add/remove <time> |
Manage shields | antiautofish.admin |
/aaf shieldcooldown <player> add/remove <time> |
Manage cooldowns | antiautofish.admin |
/aaf ban <player> <duration> [reason] |
Ban a player from fishing | antiautofish.ban |
/aaf unban <player> |
Unban a player from fishing | antiautofish.unban |
/aaf bancheck <player> |
Check a player's ban status | antiautofish.bancheck |
Permissions:
| Permission | Description |
|---|---|
antiautofish.bypass |
Bypass all CAPTCHA checks |
antiautofish.announce |
See announcements when players fail CAPTCHA |
antiautofish.admin |
Access to admin commands |
antiautofish.ban |
Can ban players from fishing |
antiautofish.unban |
Can unban players from fishing |
antiautofish.bancheck |
Can check ban status of players |
antiautofish.stats |
Can view own statistics |
antiautofish.stats.other |
Can view other players' statistics |
📁 Configuration
| File | Description |
|---|---|
config.yml |
Main plugin settings (locale, debug, modules) |
antiautofish.yml |
CAPTCHA settings (trigger chance, GUI items, rewards, shield) |
fishban.yml |
Fishing ban settings (duration, reason) |
shield.yml |
Shield system settings (duration, cooldown, history) |
discord.yml |
Discord webhook configuration |
languages/*.yml |
Translation files (cs, en, de, es, ru, ja) |
📦 Requirements
- Server: Paper 1.20.6+ (Spigot may work but Paper is recommended)
- Java: 17 or higher
- Optional: PlaceholderAPI (for placeholders in messages)
🔧 PlaceholderAPI Support
All messages support PlaceholderAPI placeholders. Use %player_name%, %server_tps%, or any other PAPI placeholder in your messages.
%aaf_captcha_fail% - Current failed CAPTCHA streak
%aaf_captcha_success% - Total successful CAPTCHAs
%aaf_captcha_total% - Total CAPTCHA attempts
%aaf_shield_time% - Shield remaining time (formatted)
%aaf_shield_time_raw% - Shield remaining time (milliseconds)
%aaf_shield_cooldown% - Cooldown remaining time (formatted)
%aaf_shield_cooldown_raw% - Cooldown remaining time (milliseconds)
%aaf_shield_active% - Shield active (true/false)
%aaf_banned% - Banned from fishing (true/false)
%aaf_ban_time% - Ban remaining time (formatted)
%aaf_ban_time_raw% - Ban remaining time (milliseconds)
%aaf_check_count% - GUI open status (1/0)
SUPPORT
For support or feature suggestions, contact me:
- Discord (Web)
- discord://-/users/771295264153141250 (App)
⭐ Don't forget to leave a review if you like the plugin! ⭐
