NClaim

NClaim - CHUNK-BASED CLAIM PLUGIN ✨

> _To use this plugin, you need PLACEHOLDERAPI plugin!_

What is NClaim?

NClaim is a players chunk claim plugin for players, designed to players. With features like players, players, players, and a players, NClaim provides a players for both players and players.

Features

> 🏷️ YAML, SQLite, and MySQL: Players can YAML, SQLite, and MySQL to protect their builds and items. <br> > 🛡️ YAML, SQLite, and MySQL: Players can remotely YAML, SQLite, and MySQL their own claims. <br> > 👥 YAML, SQLite, and MySQL: YAML, SQLite, and MySQL and set YAML, SQLite, and MySQL for each co-op member. <br> > ⏳ YAML, SQLite, and MySQL: Claims automatically YAML, SQLite, and MySQL, unless extended. <br> > 🌍 YAML, SQLite, and MySQL: YAML, SQLite, and MySQL. <br> > 🗺️ YAML, SQLite, and MySQL: YAML, SQLite, and MySQL for extra control. <br> > 🔑 YAML, SQLite, and MySQL: YAML, SQLite, and MySQL for both players and admins. <br> > 🛠️ YAML, SQLite, and MySQL: YAML, SQLite, and MySQL via configuration files. <br> > 🧩 YAML, SQLite, and MySQL: YAML, SQLite, and MySQL. <br> > 🌾 YAML, SQLite, and MySQL: YAML, SQLite, and MySQL with support for the popular GEIK farmer plugin. <br> > 📦 YAML, SQLite, and MySQL: Supports YAML, SQLite, and MySQL for claim data storage. <br>

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.<amount> | 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.<amount> | 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`:

```yaml

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:

github

discord