ВЕРСИИ (23)

**Configurable Sounds:** All plugin sounds (confirm, fail, warn, menu clicks, etc.) are now fully configurable via config.yml. ``` # Sound Settings # You can find all sound names here: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html sounds: confirm: BLOCK_NOTE_BLOCK_CHIME fail: ENTITY_ENDERMAN_TELEPORT warn: BLOCK_NOTE_BLOCK_BASS value_increase: UI_BUTTON_CLICK value_decrease: UI_BUTTON_CLICK menu_refresh: BLOCK_PISTON_CONTRACT menu_back: ITEM_BUNDLE_DROP_CONTENTS menu_click: UI_BUTTON_CLICK search_open: UI_CARTOGRAPHY_TABLE_TAKE_RESULT menu_forward: BLOCK_ENCHANTMENT_TABLE_USE teleport: BLOCK_ENCHANTMENT_TABLE_USE ``` **Dynamic Placeholders:** Added new location-based placeholders that automatically fetch data based on the player's current location (no coordinates needed). - **%nclaim_claim_main_value%:** Shows the main value of the claim at the player's location. - **%nclaim_claim_total_value%:** Shows the total value of the claim at the player's location. - **%nclaim_coop_count%:** Shows the co-op member count of the claim at the player's location. - **%nclaim_total_size%:** Shows the total size (chunk count) of the claim at the player's location. - **%nclaim_sale_status%:** Shows the sale status/price of the claim at the player's location. - **%nclaim_claim_expiry%:** Shows the expiration time of the claim at the player's location. **UI Improvements:** Added missing lore descriptions to various menu items in language files for better user experience.

# Core & Performance - **NBT-API Update:** Bumped to version 2.15.5. Fixed compatibility issues with Minecraft 1.21.1. - **Auto-Migration:** Implemented a new configuration versioning system. Config, GUI, and Lang files now automatically update with new keys while preserving your existing settings. - **Hologram Support:** Optimized FancyHolograms and DecentHolograms integration with improved default offsets. - **Database & Storage**: General optimizations for claim data loading and saving. # Security & Bug Fixes - **Exploit Fix (End Crystals):** Prevented End Crystals from damaging blocks inside claims. Non-owners can no longer detonate crystals within claimed territories. - **Exploit Fix (Flying Machines):** Blocked piston-based flying machines from entering and griefing claims. - **Admin Interaction:** Fixed an issue where admins accidentally opened the claim menu. Admins must now Sneak + Right-Click to access management menus. - **TNT Logic:** End Crystals will no longer cause block damage if TNT damage setting is disabled. # UI & UX Improvements - **Admin Menu Filters:** Added new filtering options based on sale status (All, For Sale, Not For Sale). - **Selection Visibility:** Selected claims in the Admin Menu now show an item amount of 2 for better visual feedback. - **Dynamic Menus:** Changed claim_id to display_slug in the My Claims menu for better readability. - **Actionbars:** Added {display_name} support to movement actionbars. - **Naming System:** You can now give your claim a custom name during the initial purchase. # Commands & Management - **Claim Naming:** Added /nclaim name <name> for players to set custom display names for their claims. - **Admin Slug Management:** Admins can now view all claim slugs and manage names via /nclaim name <slug> <name>. - **Claim Marketplace:** Fully implemented the claim selling system. Players can set prices and list claims via the GUI. _With this version, the config structure has changed, so the plugin will back up your old files to the backups folder upon startup and then update them. If you encounter any issues, you can reach us via Discord._

Added: You can now unclaim specific land chunks directly from the expansion menu. Fixed: Resolved an issue where Armor Stands were destroyed by TNT or Creeper explosions even when claim protection was enabled. Fixed: Patched a console error occurring on 1.17 servers caused by missing Wind Charge entities.

> Added **"Move Claim Block"** and **"Teleport to Claim"** buttons. > Added a new **"claim distance"** option to `config.yml` for server owners to configure **how close players can purchase claims** to each other. ```yaml claim_distance:   chunks: 1 # How many chunks away from nearby claims can a player create a claim.   bypass_coop_players: true # If true, the distance rule will not apply to player who is coop in the nearby claim. ``` > **MySQL database connection has been made more stable**. (This fix was provided by ZoopaMario via [PR #2](https://github.com/aysihuniks/NClaim/pull/2) and has been merged.) > **Fixed directional issues** in the expand menu.

**Claim Expand Menu**: Increased from 35 chunks to 117 chunks. **Duplicate Message Fix**: Resolved the issue where the "too close to another claim" message was duplicated. **Placeholders**: You can now change the color of the unclaimed chunk message in %nclaim_owner%, as well as the claim owner’s name. **Admin Menu Search**: Searching no longer requires the full player name. For example, typing adm will now return results like admin or administrator. **Claim Expand Menu Direction**: The menu now properly aligns with the direction you are facing when opening the claim block. For example, when opening it while looking forward, the brown or lime wool block in front of the claim block will now display correctly instead of showing the back side. **Claim Management**: Admins can now fully manage any claim from the admin menu. Known issues have been resolved. **New Placeholders**: `%nclaim_claim_count%` and `%nclaim_claim_count_<player>%`: Show how many claims a player has. `%nclaim_coop_count%` and `%nclaim_coop_count_<player>%`: Show how many coops a player is part of. **Update Messages**: Update notifications will now be sent only to `OP`s or players with the `nclaim.admin` permission, instead of being sent to the console. **Config.yml**: Added support for setting up a webhook message that will be sent when a claim expires.

Deleted debug codes

**Configurable Claim Block Type:** Added `default_claim_block_type` to `config.yml` for setting the default marker block for new claims. **Projectile & Explosion Permissions:** Wind Charge and Breeze Wind Charge shooters are now properly detected; claims check shooter permissions before allowing explosions or interactions. **Block and Entity Interaction Protection:** Claim protection now prevents Wind Charge from activating doors, buttons, trapdoors, and damaging protected entities such as Item Frames and Paintings inside protected regions.

A **confirmation menu** has been added when **deleting selected** claims in the **Admin Menu**. The **/nclaim list** command has been added; with this command, **you can** now **quickly manage your claims** and **view the claims** you are a co-op member of. Fixed the issue where the plugin would not work if **FancyHolograms** or **DecentHolograms** was not installed.

**Co-op players can now interact with claim blocks** Claim owners can set permissions for most menus (excluding claim deletion and permission management menus).  **Customizable Claim Settings via `guis.yml`** You can now configure default claim settings, decide if they are changeable, and set authorization requirements directly in `guis.yml`: ``` villager_interactions: default_value: false changeable: true # permission: "nclaim.change_claim_villager_interaction_setting" display_name: "&6Villager Trading" material: "VILLAGER_SPAWN_EGG" lore: - "" - "&fAllow villager interactions" - "" - "&7Status: {status}" - "" - "&eClick to toggle" ``` **Smart Spawner Support Added** Smart Spawner integration is now available. **Co-op Permissions Page Fixed** Missing permissions on the co-op permissions page have been addressed.

> **Admin Dashboard Menu Removed** > The old Admin Dashboard menu has been removed. You can now access the full claim management menu by typing /nclaim admin menu. (We might re-add the admin menu with more options in future updates). > **Customizable Claim Hologram Details** > You can now toggle the visibility of various sections on claim holograms! This includes the title, owner, expiration time, co-op count, and total size. > Here's how to configure it in your config.yml: ``` hologram_settings: show_title: true # Show title in hologram? show_owner: true # Show owner name in hologram? show_time_left: true # Show time left in hologram? show_coop_count: true # Show co-op player count in hologram? show_total_size: true # Show total claim size in hologram? show_edit: true # Show edit text in hologram? ``` > **Configurable Expiration Time Colors** > You can now customize the colors (green, yellow, red) for the "Time Left" display based on different thresholds! > > Example configuration in your config.yml: ``` hologram_settings: time_left_thresholds: - threshold: "day >= 2" color: "&a" # Green - threshold: "day >= 1" color: "&e" # Yellow - threshold: "day < 1" color: "&c" # Red Tip: You'll find more detailed information about hologram_settings in the config.yml file itself. ``` > **GUI Material, CustomModelData, and Custom Head Support** > We've added full material support to GUIs! You can now use any material you want in GUIs. Additionally, CustomModelData and CustomHead support are now available. > Example usage: "**HEAD:base64**" and "**MATERIAL:10000**". > **Gradient Support!** > You can now use gradients in your guis.yml and language files (like en-us.yml, tr-tr.yml)! > Example: <#RRGGBB> </#RRGGBB> > **French Language Support Added** > Bonjour! French language support has now been implemented.

Added 1.21.8 support

Fixed mob attacking seting support Fixed /nclaim admin add balance - remove balance issue

Fixed mob spawning and animal spawning settings. Deleted "_block" check in claim block manager.

Fixed plugin.yml issue

Added **smart pending world protection** system. <br> . Fixed premature hologram deletion for unloaded worlds. <br> Enhanced **hologram synchronization** with event-driven loading. <br> . Fixed compatibility issues with Multiverse-Core and delayed world plugins.

Added proximity protection for claim creation and expansion (every chunk (8 chunks) around the area where a player claims is protected).

Fix: Spamming prevented in claim delete confirmation.

Fix: only notify and play sound for players in the same world on claim removal

> Added **[AxSellwands](https://www.spigotmc.org/resources/axsellwands-a-free-sellwand-plugin.115846/)** support. > . Fixed [Supporting plugin AxSellwands](https://discord.com/channels/1145033838574178354/1394975117809025054) issue. > Fixed few **null exception** issues. > . Might be similar to an issue mentioned in [NClaim | Not destroyed](https://discord.com/channels/1145033838574178354/1394979802162794537).

MemorySection fixed and some section added to guis.yml

# 🚀 What’s New in NClaim? Here are the latest features and improvements available in NClaim: --- ## 🟦 Claim Block Customization Players with the `nclaim.manage_claim_block` permission can now open a menu to change their claim block. To add new claim blocks, the server owner can edit the `claim_blocks.yml` file. > **Why is this cool?** > Claim blocks are now fully customizable, allowing for unique visuals and tailored protection areas. --- ## 🕒 Custom Time Formatting Several messages now support custom time formatting! For example, hour (`h`), minute (`m`), second (`s`), and day (`d`) labels can now be localized and changed as you like. > **Note:** > Previously, these labels were fixed. Now you can adjust them for your server language or style. --- ## 🔄 Claim Transfer Improvements Transferring claims to another player is now easier: Add the target player to your coop list, then click the **Golden Helmet** slot in the management menu to transfer the claim. A confirmation screen will appear before the transfer is completed. > **Tip:** > Secure and simple claim transfers help players manage their land more flexibly. --- ## 🎉 Claim Entry Messages (Actionbar, Title, Chat Support) When entering a claim, the welcome message (e.g. `"aysihuniks - PvP"`) can now be shown via actionbar, title, or chat. Choose the style that fits your server! > **How to use:** > Customize these messages in the lang file to display them exactly where you want. --- *Want more details? Check the documentation or [GitHub Wiki](https://github.com/aysihuniks/NClaim/wiki) for guides and setup instructions!*

## Small Bug Fixes (v2.0.1) 1. Fix NPE by replacing getMySQLManager() with getDatabaseManager() 2. Fix auto-save task not stopping on reload. 3. Fix the message sent by `/nclaim admin help` and `/nclaim help` commands. **`Patch Notes 2.0.1`**

## Updates (v2.0) - Added support for **MySQL** and **SQLite**. - Added support for **FancyHolograms**. - Player data is now saved every 5 minutes instead of only on server shutdown or player disconnect (configurable). - ActionBar messages are now disabled in blacklisted worlds. - Language files updated for improved hologram customization. - Claim-related classes are now more developer-friendly and readable. - To bypass claim restrictions in blacklisted worlds, use either: - nclaim.bypass.* or - nclaim.bypass.blacklisted_worlds - Added region-based blacklisting support using **WorldGuard**. - Claim expansion menu now includes one additional slot on both left and right sides. - Language files are now more structured and easier to edit. - New add options: - /nclaim admin add blacklisted_region <region> - /nclaim admin add blockvalue <material> <value> - New /nclaim admin set command: - /nclaim admin set balance <player> <amount> - /nclaim admin set blockvalue <material> <value> - New remove option: - /nclaim admin remove blockvalue <material> - New placeholders: - %nclaim_block_value_[material]% — Returns the block value from blocks.yml. - %nclaim_claim_main_value_[world]_[x]_[z]% — Returns the main chunk’s block value. - %nclaim_claim_total_value_[world]_[x]_[z]% — Returns the total block value of the claim (main chunk + lands). - %nclaim_coop_count_[world]_[x]_[z]% — Shows the number of co-op players in a claim. - %nclaim_total_size_[world]_[x]_[z]% — Returns the total number of land chunks in the claim. - New permissions: - nclaim.bypass.pvp — Allows PVP even if it's disabled in the claim. - nclaim.bypass.interact — Allows interaction with villagers even if disabled. - nclaim.bypass.break — Allows block breaking regardless of claim membership. - nclaim.bypass.place — Allows block placing regardless of claim membership. - New developer-friendly events: - ClaimBuyEvent *(cancellable)* - ClaimBuyLandEvent *(cancellable)* - ClaimCreateEvent *(cancellable)* - ClaimSettingChangeEvent *(cancellable)* - ClaimEnterEvent *(not cancellable)* - ClaimLeaveEvent *(not cancellable)* - ClaimRemoveEvent *(cancellable)* - ClaimCoopAddEvent *(cancellable)* - ClaimCoopRemoveEvent *(cancellable)* - ClaimCoopPermissionToggleEvent *(cancellable)* ## Changes in 2.0 **Permission name changes:** - nclaim.bypass.blacklisted-world → nclaim.bypass.blacklisted_worlds - nclaim.bypass.max-claim-count → nclaim.bypass.max_claim_count - nclaim.bypass.claim-buy-price → nclaim.bypass.claim_buy_price - nclaim.bypass.land-buy-price → nclaim.bypass.land_buy_price `Update Notes 2.0`