BBContest - Automated Events v1.0.3

Automated Competitions | Anti-Exploit | Multi-UI Displays | Discord Integration

BBContest is a high-performance event plugin designed for Paper servers (1.21+). It allows you to run fully automated or manual competitions—such as mining, farming, fishing, and mob hunting—to keep your community active, competitive, and rewarded.

 Key Features

Built-In Contest Types

• MINE - Reward players for breaking configured ores or mining blocks.
• FARM - Track harvested crops with optional mature-crop-only protection.
• FISHING - Score fish, treasure, and caught items with separate item and entity support.
• KILLMOBS - Count mob kills while optionally filtering spawner mobs for fair competition.

Advanced Scheduling & Automation

• Cron Scheduling: Run contests automatically at exact times every day, week, or custom intervals (e.g., every Friday at 8 PM). Set it and forget it.
• Manual Control: Start, stop, pause, or resume contests anytime with intuitive admin commands.

Flexible Reward System

• Command-Based Rewards: Seamlessly integrates with EssentialsX, Vault-compatible economies, or any plugin that supports console commands.
• Instant Payouts: Automatically reward top players the moment a contest ends with per-rank and per-contest configurations.
• Reliability: Includes optional offline player handling and delayed reward execution to ensure every winner gets their prize.

Smart Anti-Exploit & Scoring

• Internal Tracker: Prevents scoring from player-placed, piston-moved, or redstone-automated blocks. No CoreProtect required.
• Mature Crops Only: Farming contests can be configured to only count fully-grown crops.
• Advanced Fishing: Separately track and score caught items versus caught entities for maximum precision.
• Spawner Protection: Automatically filter out mobs from spawners to maintain a fair competitive environment.

Lightweight UI & Filtering

• Multi-Layered Displays: Use Bossbars (progress), Actionbars (live rank), and Scoreboards (live score) simultaneously.
• Optimized GUI: A custom /bbc top menu that uses player heads while keeping rendering lightweight and responsive.
• WorldGuard & World Filtering: Limit scoring to specific worlds or WorldGuard regions (e.g., allow scoring only in the "Public Mine").

 PlaceholderAPI Support

Current Contest & Player Stats

• %bbcontest_type% — Displays the current active contest type.
• %bbcontest_time_left% — Displays the remaining time of the active contest.
• %bbcontest_time_next% — Displays the time until the next scheduled contest.
  
  
• %bbcontest_player_score% — Displays the player's current score in the active contest.
• %bbcontest_player_rank% — Displays the player's current rank in the active contest leaderboard.

Live Leaderboard (Top 1–21)

• %bbcontest_top_<n>_name% — Name of the player at rank n.
• %bbcontest_top_<n>_score% — Score of the player at rank n.

Contest History (Last 10 Events)

• %bbcontest_history_<index>_type% — Type of past contest.
• %bbcontest_history_<index>started_at% / %bbcontest_history<index>_finished_at% — Event timestamps.
• %bbcontest_history_<index>top<rank>_name% — Past winner's name.
• %bbcontest_history_<index>top<rank>_score% — Past winner's score.

 Technical Details

 Admin & Testing Tools

• Hot Reload: Update all configurations and rewards.yml instantly with /bbc reload.
• Webhook Testing: Built-in commands to test Discord announcements for starts, finishes, and "no-winner" scenarios.
• Audit Logs: Asynchronous logging system to help admins debug why specific actions were blocked by the anti-exploit system.

Thank you for supporting BBContest!

DISCORD https://discord.gg/6q8EDz4gkE