Перейти к содержимому
Mineforgian

NClaim

Advanced Chunk Claim Plugin for Minecraft

Загрузки
2K
Подписчики
12
Обновлён
13 января 2026 г.
Лицензия
NESOI

Опубликован 17 июня 2025 г.

NClaim - CHUNK-BASED CLAIM PLUGIN ✨

To use this plugin, you need PLACEHOLDERAPI plugin!

What is NClaim?

NClaim is a fully customizable chunk claim plugin for Minecraft servers, designed to protect players’ builds and items. With features like co-op claims, claim expiration, world blacklisting, and a flexible configuration system, NClaim provides a robust solution for both server owners and players.

Features

🏷️ Claiming Chunks: Players can claim chunks to protect their builds and items.
🛡️ Claim Management: Players can remotely view, expand, extend or delete their own claims.
👥 Co-op System: Add friends to your claim and set individual permissions for each co-op member.
Claim Expiration: Claims automatically expire after a configurable period, unless extended.
🌍 World Blacklisting: Prevent claims in specified worlds.
🗺️ Region Blacklisting (WorldGuard): Block claiming in specific WorldGuard regions for extra control.
🔑 Advanced Permissions: Detailed permission system for both players and admins.
🛠️ Highly Configurable: Customize messages, gui texts, claim settings, and plugin behavior via configuration files.
🧩 PlaceholderAPI Support: Use various placeholders for in-game information and external integrations.
🌾 Farmer Support: Automatically collects farms in your claim with support for the popular GEIK farmer plugin.
📦 Flexible Storage: Supports YAML, SQLite, and MySQL for claim data storage.

Commands

Command Description
/nclaim help Shows a list of all available NClaim commands.
/nclaim balance Displays your current claim block balance.
/nclaim level Calculates your claim block value and shows your current claim level.
/nclaim about Provides information about the plugin and its version.
/nclaim admin Shows a list of all admin-specific commands.
/nclaim admin menu Opens the admin control panel for advanced settings and management.
/nclaim admin add balance <amount> <player> Adds a specified amount of claim blocks to a player's balance.
/nclaim admin add blacklisted_region <regionId> Adds a WorldGuard region to the blacklist (requires WorldGuard to be installed).
/nclaim admin add blacklisted_world <world> Blacklists a world, preventing claims in that world.
/nclaim admin add blockvalue <material> <value> Adds a new block type to the block value list with a specified value.
/nclaim admin remove balance <amount> <player> Removes a specified amount of claim blocks from a player's balance.
/nclaim admin remove blacklisted_region <regionId> Removes a WorldGuard region from the blacklist.
/nclaim admin remove blacklisted_world <world> Removes a world from the blacklist, allowing claims.
/nclaim admin remove blockvalue <material> Removes a block type from the block value list.
/nclaim admin change blockvalue <material> <value> Changes the value of an existing block type in the block value list.
/nclaim admin change lang <lang> Changes the plugin language. (Requires /nclaim admin reload for changes to take effect.)
/nclaim admin set blockvalue <material> <value> Sets the value for a specific block type in the block value list.
/nclaim admin set balance <amount> <player> Sets a player's claim block balance to a specific amount.
/nclaim admin reload Reloads all NClaim configuration files and applies changes.

Permissions

Version column shows the version in which the placeholder was added (e.g. 1.3.1 means added in 1.3.1 and above)

Permission Description Default Version
nclaim.help Access help commands false 1.0
nclaim.balance View claim balance false 1.0
nclaim.buy Buy new claims false 1.0
nclaim.admin Access all admin commands false 1.0
nclaim.reload Reload plugin configuration false 1.0
nclaim.add Access /nclaim admin add command false 1.0
nclaim.remove Access /nclaim admin remove command false 1.0
nclaim.set Access /nclaim admin set command false 1.0
nclaim.change Change plugin settings (language, blockvalue etc.) false 1.0
nclaim.bypass.* Access all bypass permissions false 1.0
nclaim.bypass.claim_buy_price Bypass claim purchase price false 1.0
nclaim.bypass.land_buy_price Bypass land expansion price false 1.0
nclaim.bypass.max_claim_count Bypass maximum number of claims limit false 1.3
nclaim.adminmenu Access admin menu false 1.3.1
nclaim.bypass.blacklisted_worlds Bypass world blacklist restriction false 2.0
nclaim.bypass.blacklisted_regions Bypass region blacklist restriction false 2.0
nclaim.bypass.pvp Bypass PvP restrictions in claims false 2.0
nclaim.bypass.interact Bypass interaction restrictions in claims false 2.0
nclaim.bypass.break Bypass block break restrictions in claims false 2.0
nclaim.bypass.place Bypass block place restrictions in claims false 2.0
nclaim.maxclaim. Set the maximum claim count for a player (permission node) false 2.0
nclaim.use Access basic plugin features (buy a claim, manage claim etc.) true 2.0
nclaim.level View claim levels and info false 2.0
nclaim.* All plugin permissions op 2.0
nclaim.bypass.max_coop_count Bypass maximum number of claim coop player limit false 2.1
nclaim.manage_claim_block Access open the claim block manager menu false 2.1
nclaim.maxcoop. Set the maximum claim coop count for a claim owner (permission node) false 2.1
nclaim.bypass.axsellwand Bypass AxSellWand usage restrictions in claims false 2.1.4

Placeholders

Version column shows the version in which the placeholder was added (e.g. 2.0 means added in 2.0 and above)

Placeholder Description Version
%nclaim_player_balance% Shows the player's balance (Vault or the plugin's own system) 1.0
%nclaim_get_string_path% Gets a string value from config.yml (path = config key) 1.0
%nclaim_get_int_path% Gets an integer value from config.yml (path = config key) 1.0
%nclaim_get_boolean_path% Gets a boolean value from config.yml (path = config key) 1.0
%nclaim_get_list_path_index% Gets a list value (by index) from config.yml (path = key, index = position) 1.0
%nclaim_expiration_world_chunkX_chunkZ% Shows the expiration time for the claim at X, Z chunk in given world 1.0
%nclaim_owner_world_chunkX_chunkZ% Shows the owner of the claim at X, Z chunk in given world 1.0
%nclaim_coop_count_world_chunkX_chunkZ% Shows the co-op member count for the claim at X, Z chunk in given world 1.0
%nclaim_total_size_world_chunkX_chunkZ% Shows the total chunk count for the claim at X, Z chunk in given world 1.0
%nclaim_claim_main_value_world_chunkX_chunkZ% Gets the block value of the main claim chunk at given world, X, Z coordinates 2.0
%nclaim_claim_total_value_world_chunkX_chunkZ% Gets the total value of all chunks in the claim at given world, X, Z coordinates 2.0
%nclaim_block_value_material% Gets the configured value for the specified block material (e.g. diamond_block) 2.0
%nclaim_owner% Shows the claim owner of the chunk where the player is 2.1

Replace variables (like path, index, world, chunkX, chunkZ, material) with actual values.
Example: %nclaim_block_value_diamond_block% or %nclaim_get_list_blacklisted_worlds_0% or %nclaim_total_size_world_0_0%

Configuration Example

Here’s a sample from config.yml:

# World Restrictions
# Configure which worlds and WorldGuard regions are restricted from claiming
blacklisted_worlds:
  - world   # Example: Main world
  - spawn   # Example: Spawn world
  - pvp     # Example: PvP arena world

blacklisted_regions:
  - spawnarea  # Example: spawn protection area

# Claim Settings
claim_settings:
  max_count: 3        # Maximum number of claims per player
  buy_price: 1500     # Cost to create a new claim
  expand_price: 2000  # Cost to expand an existing claim by one chunk
  max_coop_count:     # Maximum number of co-op players per claim
    default: 3
    vip: 5
  # Permissions will be need like this "nclaim.max_coop_count.default"
  expiry_days: 7      # Days until an inactive claim expires

# Auto-Save Configuration
auto_save: 30  # How often to save data (in minutes)

# Time Extension Settings
time_extension:
  price_per_minute: 25.0
  price_per_hour: 1500.0
  price_per_day: 5000.0
  tax_rate: 0.1

# Database Configuration
# Chooses between MySQL and SQLite for data storage
database:
  enable: false  # Set to true to use database storage instead of YAML
  type: "mysql"  # Options: "mysql" or "sqlite"

  # SQLite Configuration
  sqlite:
    file: database.db  # Database file name

  # MySQL Configuration
  mysql:
    host: localhost
    port: 3306
    database: nclaim
    user: root
    password: ""       # Replace with your database password
    maximum_pool_size: 10  # Maximum number of connections in the pool
    minimum_idle: 5        # Minimum number of idle connections
    idle_timeout: 300000   # Time (ms) before an idle connection is closed (default: 5 minutes)
    max_lifetime: 1800000  # Maximum lifetime (ms) of a connection (default: 30 minutes)
    connection_timeout: 30000  # Time (ms) to wait for a connection (default: 30 seconds)

Screenshots

Here are some screenshots from the plugin: About NClaim 2025-06-17_15 36 48 2025-06-17_15 37 52 1 2 3 4 5 6 7 8

github discord

Ченджлог

3.4.1Релиз1.21.9, 1.21.10, 1.21.11 · 13 января 2026 г.

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.

3.4Релиз1.21.9, 1.21.10, 1.21.11 · 9 января 2026 г.

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

3.3.1Релиз1.21.9, 1.21.10, 1.21.11 · 19 декабря 2025 г.

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.

3.3Релиз1.21.8, 1.21.9, 1.21.10 · 25 октября 2025 г.

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

Fixed directional issues in the expand menu.

3.2Релиз1.21.6, 1.21.7, 1.21.8 · 2 сентября 2025 г.

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.

3.1.1Релиз1.21.6, 1.21.7, 1.21.8 · 25 августа 2025 г.

Deleted debug codes

3.1.1Релиз1.21.6, 1.21.7, 1.21.8 · 25 августа 2025 г.

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.

3.1Релиз1.21.6, 1.21.7, 1.21.8 · 17 августа 2025 г.

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.

Комментарии

Загружаем…