NClaim Advanced Claim System v3.4.1

Configurable Sounds: All plugin sounds (confirm, fail, warn, menu clicks, etc.) are now fully configurable via config.yml.

Click to expand...

Code:

# 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.

Click to expand...

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.

Click to expand...

Added a new "claim distance" option to config.yml for server owners to configure how close players can purchase claims to each other.

Click to expand...

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 and has been merged.)

Click to expand...

Fixed directional issues in the expand menu.

Click to expand...

Claim Expand Menu: Increased from 35 chunks to 117 chunks.

Click to expand...

Duplicate Message Fix: Resolved the issue where the "too close to another claim" message was duplicated.

Click to expand...

Placeholders: You can now change the color of the unclaimed chunk message in %nclaim_owner%, as well as the claim owner’s name.

Click to expand...

Admin Menu Search: Searching no longer requires the full player name. For example, typing adm will now return results like admin or administrator.

Click to expand...

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.

Click to expand...

Claim Management: Admins can now fully manage any claim from the admin menu. Known issues have been resolved.

Click to expand...

New Placeholders:

Click to expand...

%nclaim_claim_count% and %nclaim_claim_count_<player>%: Show how many claims a player has.

Click to expand...

%nclaim_coop_count% and %nclaim_coop_count_<player>%: Show how many coops a player is part of.

Click to expand...

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.

Click to expand...

Config.yml: Added support for setting up a webhook message that will be sent when a claim expires.

Click to expand...

Debug messages are deleted.

Configurable Claim Block Type:

Click to expand...

Added default_claim_block_type to config.yml for setting the default marker block for new claims.

Click to expand...

Projectile & Explosion Permissions:

Click to expand...

Wind Charge and Breeze Wind Charge shooters are now properly detected; claims check shooter permissions before allowing explosions or interactions.

Click to expand...

Block and Entity Interaction Protection:

Click to expand...

Claim protection now prevents Wind Charge from activating doors, buttons, trapdoors, and damaging protected entities such as Item Frames and Paintings inside protected regions.

Click to expand...

A confirmation menu has been added when deleting selected claims in the Admin Menu.

Click to expand...

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.

Click to expand...

Fixed the issue where the plugin would not work if FancyHolograms or DecentHolograms was not installed.

Click to expand...