NBContest

his v1.0.7 update is a major evolution for NBContest, bringing both PlaceholderAPI (PAPI) support and a brand new advanced visual customization system to give server administrators full control.

---

📖 New Documentation Available

We are excited to launch our new comprehensive documentation site! 👉 Check it out here: docs.nb.studio/docs/nbcontest

---

📝 Changelog

🔗 1. PlaceholderAPI (PAPI) Support & Conditions

• [New] Native integration of PlaceholderAPI. Extract all your contest data to display them anywhere (TAB, holograms, GUI menus, chat).
• [New] Added 13 robust placeholders (see list below) working in real-time with smart fallback if no contest is active.
• [New] Structural placeholders (%nbcontest_event_type% and %nbcontest_has_objective%) to create ultra-precise conditions in third-party plugins (e.g., displaying a different scoreboard 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 objectives (Fishing, Mob Hunting, etc.), ensuring clean and seamless external displays.

🎨 2. Visual Customization & Visual Comfort

• [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 generic contest-started for Fishing).
• [New] YAML Lists Support (Multi-line): You can now write your messages as YAML lists in messages.yml (ideal for designing beautiful borders or line breaks).
• [New] Custom Podium (🥇🥈🥉): Ability to configure the format of each place on the final podium independently (top-line-1, top-line-2, top-line-3 in messages.yml). Showcase your winners with unique colors and symbols.
• [New] Placeholders in Start Message: The %amount% and %material% variables are now available and functional directly within the start message!
• [New] Selective Muting: You can individually disable any message from the plugin by simply setting it to "" in messages.yml. No more chat spam!
• [New] ActionBar Control: Added the configuration option actionbar.enabled: false in config.yml to disable the ActionBar display during contests.

---

📊 Available Placeholders (%nbcontest_...%)

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

---

💡 All your previous configurations and language settings remain 100% compatible with this version.

Thank you so much for your continuous feedback, bug reports, and suggestions! If you enjoy the plugin, please leave us a 5-star review! ⭐⭐⭐⭐⭐

💬 Join our Discord Server for Support & Questions!