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: