🧩 Deconstruct

⚙️ How Deconstruct Works

The Deconstruct Station allows you to deconstruct multiple items at once. Its behavior is configured under settings.deconstruct.

🔐 Permission

Each station has its own permission requirement in order to be used. Of course, you can customize or change the permission to suit your needs.

settings:
  permission: nwmmoupgrade.deconstruct.test

⭐ Features

1. Material Item

If enabled, this means the operation of the station will require the specified materials in order to function as intended. You can define one or more material items, and the station will only execute if the player provides the required materials.

materials:
  enabled: false
  items:
    - type: MATERIAL
      id: STEEL_INGOT
      amount: 5
      slot: 30
      #match-item-type: SWORD #filter option
      #match-tier-type: RARE #filter option
      #match-item:
      # - SWORD:KATANA

Note:

type is the type of the MMOItem.
id is the ID of the MMOItem.
amount is the quantity of the material required.
slot is the GUI slot where the material must be placed.

Options

These are additional conditions that enhance material requirements:

match-item-type: The material will only be accepted if the item placed in the item slot has the matching type specified here.
match-item-tier: The material will only be accepted if the item placed in the item slot has the matching tier specified here.
match-item: The material will only be accepted if the item placed in the item slot has the matching According to the item defined in match-item specified here.

2. Chance Item

If enabled and used in conjunction with chance-based mechanics, the Chance Item provides an additional success rate boost on top of the existing base chance.

This item acts as a support to increase the overall likelihood of success during actions such as upgrading.

chance-item:
  enabled: false
  items:
    - type: MATERIAL
      id: RARE_DIAMOND
      amount: 5
      slot: 32
      chance: 50
      #match-item-type: SWORD #filter option
      #match-tier-type: RARE #filter option
      #match-item:
      # - SWORD:KATANA
    - type: MATERIAL
      id: SILVER_INGOT
      amount: 1
      slot: 32
      chance: 50
      #match-item-type: ARMOR #filter option
      #match-tier-type: RARE #filter option
      #match-item:
      # - SWORD:KATANA

Note:

type is the type of the MMOItem.
id is the ID of the MMOItem.
amount is the quantity of the material required.
slot is the GUI slot where the material must be placed.
chance This sets the success chance for the Chance Item

Options

These are additional conditions that enhance material requirements:

match-item-type: The material will only be accepted if the item placed in the item slot has the matching type specified here.
match-item-tier: The material will only be accepted if the item placed in the item slot has the matching tier specified here.
match-item-tier: The material will only be accepted if the item placed in the item slot has the matching According to the item defined in match-item specified here.

3. Material Formula

The Material Formula feature provides a highly flexible way to dynamically calculate the cost and material requirements for item.

Material Increase

When this feature is enabled (enabled: true), the quantity of material items required for an gem add socket will increase as the item's level rises. This ensures that higher-level upgrades demand a greater investment from players, providing a more balanced progression.

The increase is determined by a custom formula you define, giving you precise control over the scaling.

In Short:

Level Up = Material Requirements.

Formula Configuration

The core of this feature lies in the formula field, where you can define a mathematical expression.

Basic: you can use the basic default chance calculation or create your own custom formula to control how the chance is calculated.
Custom Placeholders: The formula supports specific placeholders that will be replaced with dynamic values during calculation.

material-formula:
  enabled: true
  formula: "1"

4. Cost Upgrade

This feature allows you to use currencies such as PlayerPoints, CoinsEngine, or Vault.

cost:
    enabled: true
    currency: pp
    amount: 5000

cost:
    enabled: true # Enable/disable cost system
    currency: ce;nwcoin
    amount: "{ability_custom_advance_cost_item}" # cost amount

cost:
    enabled: true # Enable/disable cost system
    amount: 100 # cost amount

5. Default Chance

This feature allows you to set the success chance of this station yourself, in cases where Tier is not enabled.

options:
    ....
    default-chance: 0

6. Deconstruct

The Deconstruct Station uses a group-based system to determine which items are returned when an item is deconstructed. This behavior is divided into check-group and groups logic.

🔍 3.1 `check-group` Behavior

The check-group system determines which group should be used to generate the deconstruction results.

🧠 How It Works

The system checks the category, item type, and item details of items placed in the Deconstruct Station GUI
If an item matches any condition defined in items, the system will use use-deconstruct-group
The selected group controls which result items will be generated

⚙ Supported Format

Each entry follows this structure:

MMOITEM;<type>;<id>;<tier>,<tier1>;<amount>

Parameters

MMOITEM Item source type
type MMOItem category (e.g. SWORD, ARMOR)
id MMOItem ID
tier (optional) Item tier(s). Multiple tiers can be separated by commas
amount Required amount of items to trigger this rule

Note: Tiers are optional. If omitted, the rule applies to all tiers.

📦 3.2 `groups` Behavior

The groups section defines the result items returned after a successful deconstruction.

Each group can have its own validation rules and result logic.

✅ 3.2.1 `check-item: true`

When enabled:

The group will strictly validate the items placed in the Deconstruct Station GUI
All defined conditions must be met for the group to be applied
Provides full control over both conditions and output items

This mode is ideal for precise, controlled deconstruction behavior.

🎚 3.2.2 `check-tier: true`

When enabled:

Result items are determined based on the item tier
Each tier can have its own result configuration

Fallback Behavior

If the item’s tier does not match any defined tier:
- The system will automatically fall back to DEFAULT results

This ensures safe behavior even when tiers are missing or undefined.

🔄 Deconstruction Flow

Item is placed into the Deconstruct Station GUI
check-group determines the appropriate group
The selected group validates the item (check-item)
Tier-based results are applied (check-tier)
Result items are generated and returned

Conditions

Required Item are the results that players receive when the process is successfully completed.

Here is a table of condition types and their formats:

Type

Format

Example

Description

MMOItems

MMOITEM;<type>;<id>;<amount>

MMOITEM;MATERIAL;RARE_DIAMOND;10

Requires a specific MMOItem and amount

Vanilla

VANILLA;<material>;<amount>

VANILLA;STONE;15

Requires a specific vanilla item and amount

Placeholder

PLACEHOLDER;<placeholder>;<syntax>;<result>

PLACEHOLDER;%luckperms_groups%;==;default

Checks placeholder value matches result

Vault

vault;<amount>

vault;123

Requires the player to have a certain amount of money

Level

LEVEL;<amount>

LEVEL;123

Requires the player to have a certain level

CoinsEngine

COINSENGINE;<currency>;<amount>

COINSENGINE;nwcoin;100

Requires the player to have a certain amount of money

PlayerPoint

playerpoint;<amount>

playerpoint;100

Requires the player to have a certain amount of money

Nexo

nexo;<material>;<amount>

Nexo;Custom_block;15

Requires a specific nexo item and amount

ItemsAdder

ia;<namespace>;<amount>

ia;<test:test>;1

Requires a specific ItemsAdder item and amount

These conditions give you a flexible way to control when a player is allowed to process items.

Condition Syntax

PLACEHOLDER;<placeholder>;<syntax>;<result>

Available syntax options include:

Examples:

"PLACEHOLDER;%player_level%;>=;30"
"PLACEHOLDER;%luckperms_group%;==;vip"
"PLACEHOLDER;%player_health%;<;10"
"PLACEHOLDER;%some_placeholder%;has_value"

These conditions give you a flexible way to control when a player is allowed to process items.

Here's an explanation in simple English of how to use <syntax> in:

PLACEHOLDER;<placeholder>;<syntax>;<result>

This condition checks the value of a placeholder using a comparison operator (<syntax>) and compares it with a result.

Available `<syntax>` Options:

<syntax>

Meaning

Example

Description

== (EQUALS)

Equals

%player_level% == 10

True if the placeholder equals 10

!= (NOT_EQUALS)

Not equals

%player_level% != 5

True if not equal to 5

> (GREATER_THAN)

Greater than

%player_level% > 20

True if greater than 20

< (LESS_THAN)

Less than

%player_level% < 15

True if less than 15

>= (GREATER_OR_EQUAL)

Greater than or equal

%player_level% >= 30

True if 30 or more

<= (LESS_OR_EQUAL)

Less than or equal

%player_level% <= 50

True if 50 or less

has_value (HAS_VALUE)

Check if has any value

%some_placeholder% has_value

True if the placeholder is not empty or null

Example Usages:

- "PLACEHOLDER;%player_level%;>=;30"
- "PLACEHOLDER;%luckperms_group%;==;vip"
- "PLACEHOLDER;%player_health%;<;10"
- "PLACEHOLDER;%some_placeholder%;has_value"

Previous♻️ Combine Next📚 Logs System

Last updated 3 months ago

hashtag⚙️ How Deconstruct Works

hashtag🔐 Permission

hashtag⭐ Features

hashtag1. Material Item

hashtagOptions

hashtag2. Chance Item

hashtagOptions

hashtag3. Material Formula

hashtagMaterial Increase

hashtagFormula Configuration

hashtag4. Cost Upgrade

hashtag5. Default Chance

hashtag6. Deconstruct

hashtag🔍 3.1 check-group Behavior

hashtag🧠 How It Works

hashtag⚙ Supported Format

hashtag📦 3.2 groups Behavior

hashtag✅ 3.2.1 check-item: true

hashtag🎚 3.2.2 check-tier: true

hashtag🔄 Deconstruction Flow

hashtagConditions

hashtagCondition Syntax

hashtagAvailable <syntax> Options:

hashtagExample Usages:

⚙️ How Deconstruct Works

🔐 Permission

⭐ Features

1. Material Item

Options

2. Chance Item

Options

3. Material Formula

Material Increase

Formula Configuration

4. Cost Upgrade

5. Default Chance

6. Deconstruct

🔍 3.1 `check-group` Behavior

🧠 How It Works

⚙ Supported Format

📦 3.2 `groups` Behavior

✅ 3.2.1 `check-item: true`

🎚 3.2.2 `check-tier: true`

🔄 Deconstruction Flow

Conditions

Condition Syntax

Available `<syntax>` Options:

Example Usages: