BBContest — The Professional Event Solution
Automated Competitions | Anti-Exploit | Multi-UI Displays | Discord IntegrationBBContest 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
| Category | Specifications |
| Platform | Paper 1.21+ |
| Storage | YAML (Default) or MySQL (Optimized with shaded drivers) |
| Integrations | PlaceholderAPI, WorldGuard, and command-based reward support for EssentialsX or Vault-compatible economies. |
| Performance | Optimized interval-based UI updates and async audit logging for minimal TPS impact. |
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
