ВЕРСИИ (6)

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](https://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!](https://discord.nb.studio/)

# v1.0.6 - World Restrictions & Command Alias ### ✨ 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! * `DAILY` (runs every day) * `MONDAY` to `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 `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.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/](https://discord.nb.studio/)