NClaim

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.

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 OPs 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

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 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/13949751… issue.

Fixed few null exception issues.

. Might be similar to an issue mentioned in [NClaim | Not destroyed](https://discord.com/channels/1145033838574178354/13949798…

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