BBContest - Automated Events | Oraxen v1.0.4

BBContest v1.0.4 is a major update! Alongside a new safeguard for scheduled contests, this version introduces a complete Fishing Event system — fish rarities, upgradeable fishing rods, socketable baits, treasure hunting, a full in-game fish market, and native Oraxen support for custom items.

Minimum Online Players for Scheduled Contests​

You can now set a global minimum player requirement in config.yml. If the server doesn't have enough players online when a contest is scheduled to start, BBContest will automatically skip that run instead of starting an empty event.

contest:
default-duration: 600 # seconds
# Minimum online players required to start a contest automatically. Set to 0 to disable this check.
min-players: 0

Click to expand...

Keep min-players: 0 to disable the check entirely and preserve the exact same behavior as before this update.

Per-Contest Type Overrides​

contest:
min-players: 5

types:
farm:
display: '<gradient:#F1C40F:#FFD700><b>FARMING</b></gradient>'
bossbar-color: GREEN
min-players: 3

fishing:
display: '<gradient:#00C6FF:#0072FF><b>FISHING</b></gradient>'
bossbar-color: BLUE
min-players: 8

Click to expand...

If a contest type doesn't have its own min-players set, it automatically falls back to the global contest.min-players value.

Manual Start Stays Flexible​

Admin-triggered starts via /bbcontest start bypass the minimum player check by default. Want manual starts to follow the same rule?

contest:
enforce-min-players-on-manual-start: false

Click to expand...

New Configurable Message​

messages:
contest-not-enough-players: '%prefix% <#FF7675>Not enough players online to start the %bbcontest_type% contest! (<#F1C40F>%current_players%<#FF7675>/<#F1C40F>%min_players%<#FF7675> required)'

Click to expand...

Placeholder	Description
%prefix%	Your configured BBContest prefix
%bbcontest_type%	The contest's display name
%current_players%	Current online player count
%min_players%	The required minimum player count

All-New Fishing Contest with Rarities, Rods, Bait & Treasure​

The FISHING contest type has been completely built out into a standalone progression system, not just a simple catch-and-score event.

Fish Rarity & Scoring System — Common → Uncommon → Rare → Epic → Legendary → Mythic, with random weight and 1★–5★ stars.

global-settings:
points:
weight_multiplier: 2.0
rarities:
MYTHIC:
chance_weight: 1.0
base_points: 250.0
stars:
max_stars: 5
points_per_star: 5
messages:
contest-not-enough-players: '%prefix% <#FF7675>Not enough players online to start the %bbcontest_type% contest! (<#F1C40F>%current_players%<#FF7675>/<#F1C40F>%min_players%<#FF7675> required)'

Click to expand...

Legendary and Mythic catches automatically trigger a server-wide broadcast.


Upgradeable Fishing Rods

rods:
pro_rod:
stats:
bait_power: 1.5
treasure_chance: 10.0
double_catch: 5.0
bait_slots: 3

Click to expand...

Socketable Bait System — drag and drop baits onto a rod to apply stacking bonuses.

baits:
common_fishing_bait:
stats_bonus:
treasure_chance: 5.0
rarity_bonus:
LEGENDARY: 5.0

Click to expand...

Treasure Hunting — item rewards, economy payouts, or custom commands, with unique sounds and broadcasts.

kraken_fragment:
rarity: LEGENDARY
reward_type: ITEM
broadcast_message: '%prefix% <#F1C40F>%player% <#F5F6FA>just caught a <#E67E22>Kraken Relic Fragment<#F5F6FA>!'

Click to expand...

In-Game Fish Market — sell fish via GUI, price auto-calculated from rarity, stars, and weight.

pricing:
price_per_kg: 50.0
price_per_star: 100.0
rarities:
MYTHIC:
base_price: 8000.0
multiplier: 2.0

Click to expand...

Open with /bbcontest shop or /bbcontest market. Blacklist support included.


Native Oraxen Support — fish, rods, baits, and treasures all support Oraxen item IDs, with automatic fallback to vanilla materials.

New Admin Commands
/bbcontest give rod <player> <rod_id> [amount]
/bbcontest give bait <player> <bait_id> [amount]

Configuration Updates​

New files: events/fishing/fish.yml, rods.yml, baits.yml, treasure.yml, shop.yml, plus new messages.fishing.* entries in message.yml, and contest.min-players / contest.enforce-min-players-on-manual-start in config.yml.

Update Note​

Existing config.yml and message.yml are not overwritten on update. Manually add the new keys and fishing config files to enable these features.

Step	Action	Description
1	Update	Update the plugin to the latest version (v1.0.4)
2	Edit Config	Add new keys/messages + fishing event files
3	Reload	Restart your server OR run /bbcontest reload

BBContest v1.0.3 is here! This update focuses on enhancing Discord Webhook customization and improving visual configurations. You can now use local image files for webhook thumbnails with an optional URL fallback, making your setup much easier without relying solely on external image hosting services.

What's New?​

Webhook Thumbnail Support for Local Files & URLs​

• You can now configure both local files and URL fallbacks directly:
  YAML
  
  file: "farming_bbcontest.png"
  url: "https://example.com/farming_bbcontest.png"
  
  
• Local Image Path: plugins/BBContest/images/ (This folder will be automatically created when the plugin loads or reloads).
• How it works:
  • If the local file exists, the plugin will upload it directly to the Discord webhook.
  • If the local file is missing or empty, the plugin falls back to the configured URL.
  • Note: The legacy direct-URL thumbnail format is still fully supported.

Improved Discord Embed Color Parsing​

• Added flexible support for various color formats in Discord Embeds:
  YAML
  
  color: "&e&l"
  color: "<#F1C40F>"
  color: "<gradient:#F1C40F:#F39C12>"
  
  
• Gradient Handling: Since Discord only supports a single solid color per embed, BBContest will automatically parse and use the first color of the gradient.

Configuration Updates​

• Refreshed and improved the default styling and content for both config.yml and leaderboard.yml.

Update Note​

If your server is upgrading from an older version and already has an existing webhook.yml, the plugin will not overwrite your files to protect your data.
Please manually update the thumbnails section in your configuration to the new file + url format to take advantage of the new local upload features.

Click to expand...

You can now set custom Start and Finish thumbnail URLs for each contest type. This allows your Discord notifications to visually match the active in-game event.

Supported Contest Types​

• FARM
• MINE
• KILLMOBS
• FISHING

How to Configure​

To use this feature, add the following placeholder to your webhook embed configuration in webhook.yml:

thumbnail: "%bbcontest_thumbnail%"

Click to expand...

• Dynamic Matching: The plugin automatically displays the correct image based on the active contest type and event status.
• No-Winner Rule: Events with no winners (no-winner) will automatically use your designated Finish thumbnail.

Step	Action	Description
1	Update	Update the plugin to the latest version.
2	Edit Config	Open webhook.yml and add your image URLs for each contest type.
3	Reload	Restart your server OR run the reload command: /bbcontest reload