🎣 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)
!With Resource Pack	!Vanilla

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

1. When a player catches a fish, there's a configurable chance (%) to trigger a CAPTCHA
2. A GUI opens with random fish and trash items - the player must click on a fish
3. Clicking on trash counts as a wrong click - after X wrong clicks, the player fails
4. Successful CAPTCHA completions grant rewards and count toward Shield progress
5. After Y successful CAPTCHAs, the player receives a Shield
6. While shielded, the player is immune to CAPTCHA for the shield duration
7. 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)

!bStats

---

---

⭐ Don't forget to leave a review if you like the plugin! ⭐

---