This update is a major evolution for NBContest, bringing native PlaceholderAPI (PAPI) support and a brand new advanced visual customization system to give server administrators full control over their events!


New Documentation Available!
We are excited to launch our new comprehensive documentation site!
Click here to view the documentation
Learn how to configure the plugin, use the new placeholders, customize messages, and more.

Changelog

1. PlaceholderAPI (PAPI) Support & Advanced Conditions

• [New] Native integration of PlaceholderAPI. You can now extract all live contest data and display it anywhere: TAB list, holograms (DecentHolograms, etc.), GUI menus (DeluxeMenus), or chat formats!
• [New] Added 13 robust placeholders (see list below) working in real-time with smart fallback formatting if no contest is active.
• [New] Structural placeholders (%nbcontest_event_type% and %nbcontest_has_objective%) allowing you to create ultra-precise conditions in third-party plugins (e.g., displaying a different scoreboard format depending on whether the event has a farming objective or not!).
• [Optimization] The %nbcontest_amount% and %nbcontest_progress% placeholders now return an empty string "" on events without objective targets (like Fishing or Mob Hunting), ensuring clean and seamless external displays.

2. Advanced Visual Customization

• [New] Specific Start/End Messages per Event: You can now configure different messages per event type (e.g., contest-started-farming to display the objective only during farming events, and a generic contest-started for Fishing).
• [New] YAML Lists Support (Multi-line): You can now write your messages as lists in messages.yml (perfect for beautiful chat boxes, headers, footers, or multi-line alerts!).
• [New] Custom Podium (): Ability to configure the format of each place on the final podium independently using top-line-1, top-line-2, and top-line-3 keys in messages.yml. Highlight your winners with unique colors and symbols!
• [New] Start Message Placeholders: The %amount% and %material% variables are now fully functional and supported directly within the start message!
• [New] Selective Muting (Anti-Spam): You can individually disable any message from the plugin by simply setting it to "" in messages.yml to make it completely silent. No more chat spam!
• [New] ActionBar Toggle: Added a new configuration option actionbar.enabled: false in config.yml to allow disabling the ActionBar display during contests.

Placeholder	Description	Render Active	Render Inactive
%nbcontest_is_running%	Indicates whether a contest is active	true	false
%nbcontest_event_name%	Name of the ongoing event (translated)	Harvesting	(empty)
%nbcontest_event_type%	Raw type of the event (e.g. farming, fishing)	farming	(empty)
%nbcontest_has_objective%	Returns true if the event has a quantitative objective	true	false
%nbcontest_time_left%	Raw remaining time in seconds	124	0
%nbcontest_time_left_formatted%	Formatted remaining time (MM:SS)	02:04	00:00
%nbcontest_material%	Target block material translated (farming only)	Diamond	(empty)
%nbcontest_amount%	Required objective target amount (farming only)	100	(empty)
%nbcontest_progress%	Global collective progress (farming only)	42	(empty)
%nbcontest_my_score%	Current score of the player looking at it	15	0
%nbcontest_my_rank%	Leaderboard rank of the player	2	N/A
%nbcontest_leaderboard_name_X%	Name of player at position X (e.g. 1, 2, 3)	PlayerName	---
%nbcontest_leaderboard_score_X%	Score of player at position X (e.g. 1, 2, 3)	25	0

Update v1.0.6

✨ New Features

• Allowed Worlds System: Added a new active-worlds configuration setting in config.yml. You can now easily restrict contests so that players can only earn points in specific worlds (e.g., your survival world and not your lobby). (<by default, all worlds are allowed if the list is completely empty>).
• Command Alias: Added /nbc as a quick, native shortcut for the /nbcontest command!

Bug Fixes

• Fixed an issue where the /nbcontest reload command wasn't properly updating the world restrictions in the active event manager.
• World name verification is now case-insensitive (treating World and world identically) for better compatibility with world management plugins.

v1.0.5 - Advanced Scheduling Update

✨ New Features

• Calendar-Based Scheduling: You can now schedule events on specific days!
  • Code (Text):

    DAILY
    (runs every day)
    Code (Text):

    MONDAY
    to
    Code (Text):

    SUNDAY
    (runs only on specific days) []Mix and match! Have a daily event at 6 PM and a special event every Friday at 8 PM.
  
  Targeted Farming Contests:
  • You can now specify which crop to farm for a scheduled event! Example: Potato Contest on Saturdays, Wheat Contest on Sundays. If no type is specified, it remains random as before.

Improvements

• Scheduling Logic: Completely rewritten scheduler to handle complex daily/weekly patterns. Config Format: Updated
  Code (Text):

  auto-events
  configuration to be more structured and readable (backward compatibility maintained for simple lists).
• Optimization: Scheduler check frequency optimized for better server performance.

Bug Fixes

• Fixed an issue where scheduled times might drift slightly depending on server restart times. Improved error handling for invalid timezone configurations.

Version 1.0.4
- Added real-time scoreboard system
- Added option to enable/disable boss bar
- Added option to enable/disable scoreboard
- Improved configuration organization with detailed comments
- Improved messages organization with sections
- Added comprehensive documentation

NBContest v1.0.3 - Changelog

[+] Added support for multiple reward commands
- Rewards for Top 1/2/3 can now contain several commands instead of only one.
- Both formats are now supported:
• Single command (string)
• Multiple commands (list)
- Allows plugin users to execute multiple actions such as giving items, sending messages, running economy commands, plugin-specific commands, and more.

[+] Improved reward processing
- New internal system to dispatch each command safely.
- Added placeholder support for `%player%` in all reward commands.

[*] Backward compatibility ensured
- Old configurations using a single command still work without any changes.

Example: Top 1 reward can now execute 3+ commands for the winner!

NBContest v1.0.2 - Changelog

[+] Improved Sugar Cane handling
- Fixed an issue where breaking sugar cane did not increase the farming score.
- Added logic to detect stacked sugar cane (up to 3 blocks high).
- Breaking a middle cane now correctly counts multiple destroyed blocks.

[+] Enhanced BlockBreak listener
- Added custom behavior for vertical plants like sugar cane.
- Prevents farming abuse by ignoring manually placed blocks.
- Keeps existing logic for ageable crops (wheat, carrots, potatoes, etc.).

[*] General improvements
- Code cleanup and improved readability.
- More reliable event validation when farming contests are active.

This update ensures sugar cane is now fully supported in farming contests!

NBContest v1.0.1 - Changelog

New Features:

• MiniMessage (Adventure) support for all plugin messages, including:
  • Chat messages
  • BossBars
• Automatic event scheduling via config:
  • Define multiple times per event (e.g., farming, fishing, etc.)
  • Configurable timezone support (e.g., Europe/Paris)
  • Auto-starts events based on server time (checks every minute)
• New `/nbcontest reload` command now reloads auto-events and language file

Improvements:

• Full refactor of the language system (`messages.yml`) using placeholders
• All material and event names now support localization and customization
• All messages now use MiniMessage formatting (colors, gradients, bold, etc.)
• Cleaner internal code structure and separation of logic

️ Fixes & "Anti-Cheat":

• Pumpkin/Melon exploit fix: players can no longer place and break pumpkins to gain points
• Proper crop maturity check using `Ageable` before counting farming points
• Auto-events are triggered only once per scheduled time

Need help or want to suggest a feature?
Join us on Discord: https://discord.nb.studio/