> For the complete documentation index, see [llms.txt](https://docs.mongenscave.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mongenscave.com/premium-products/quests/supported-plugins/nexo.md).

# Nexo

When [Nexo](https://polymart.org/resource/nexo.6901) is installed, two triggers for custom items become available. Detection is automatic.

| Trigger           | Counts when the player...          | Progress       |
| ----------------- | ---------------------------------- | -------------- |
| `nexo_craft_item` | crafts a Nexo item                 | 1 per craft    |
| `nexo_smelt_item` | takes a Nexo item out of a furnace | amount smelted |

The vanilla `craft_item` and `smelt_item` triggers only understand vanilla materials — these two match on the **Nexo item ID** instead, so you can build quests around your custom item tiers.

### `nexo_craft_item` <a href="#nexo_craft_item" id="nexo_craft_item"></a>

The `target` is the Nexo item ID and it's required — there's no `any` (for "craft anything" quests use the vanilla `craft_item` trigger with the item's base material):

```yaml
objectives:
  forge_blade:
    name: "&#FF6B6B&lForge the Ember Blade"
    description:
      - "&#C7D0D9Craft an ember blade at"
      - "&#C7D0D9the workbench."
    trigger: nexo_craft_item
    target: ember_blade
    required: 1
```

### `nexo_smelt_item` <a href="#nexo_smelt_item" id="nexo_smelt_item"></a>

Fires when the smelted result is taken out of the furnace. The `target` is a Nexo item ID or `any`, and progress counts the full amount extracted:

```yaml
objectives:
  smelt_ore:
    name: "&#FFD86E&lMythril Smelter"
    trigger: nexo_smelt_item
    target: mythril_ingot
    required: 16
```

{% hint style="info" %}
Item IDs are the keys from your Nexo item configs (`ember_blade`, not `&cEmber Blade`). A typo means the objective silently never progresses, so test new quests with `/quests force give` before putting them on the board.
{% endhint %}