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:
