> For the complete documentation index, see [llms.txt](https://enchantedmobs.superiormc.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://enchantedmobs.superiormc.cn/ultimatequest-zhong-wen-wen-dang/pei-zhi/triggers/fishing-trading.md).

# 钓鱼与交易触发器

下列各节按当前事件上下文说明。PLAYER 为累计任务进度的玩家，TARGET 不自动等于 PLAYER，缺失数据保持缺失。这些触发器观察进度，不提供可修改的伤害/掉落结果。

## 配置示例

```yaml
source:
  trigger: fish
  amount: 10
```

## `fish`

钓鱼状态事件触发，携带鱼竿和存在时的钓获实体。

| 上下文                  | 值                     |
| -------------------- | --------------------- |
| 事件/载荷                | `PlayerFishEvent`     |
| 可用性                  | Paper 和 Spigot        |
| PLAYER               | 此事件关联的玩家              |
| SOURCE               | 任务玩家                  |
| TARGET               | 存在时的钓获实体              |
| LOCATION             | 鱼钩位置                  |
| TRIGGER\_ITEM / slot | 鱼竿 / 解析后的主或副手         |
| 附加数据                 | `original_experience` |

用 catch\_match\_item 要求钓获物品，未筛选 fish 包含抛竿等状态；count: items 仅对钓获物品使用堆叠数量。

## `piglin_barter`

猪灵交易能关联此前跟踪玩家时触发，无法归属则跳过。

| 上下文                  | 值                   |
| -------------------- | ------------------- |
| 事件/载荷                | `PiglinBarterEvent` |
| 可用性                  | Paper 和 Spigot      |
| PLAYER               | 此事件关联的玩家            |
| SOURCE               | 交易猪灵                |
| TARGET               | 交易猪灵                |
| LOCATION             | 目标/实体位置             |
| TRIGGER\_ITEM / slot | 交易输入物品 / HAND       |

## `trade`

观察实体商人交易，例如村民/流浪商人。

| 上下文                  | 值                  |
| -------------------- | ------------------ |
| 事件/载荷                | `PlayerTradeEvent` |
| 可用性                  | 需 Paper 模式及对应事件类   |
| PLAYER               | 此事件关联的玩家           |
| SOURCE               | 任务玩家               |
| TARGET               | 商人实体               |
| LOCATION             | 商人位置               |
| TRIGGER\_ITEM / slot | 交易结果 / HAND        |

## `purchase`

观察玩家商人购买，包括可用的虚拟商人路径。

| 上下文                  | 值                     |
| -------------------- | --------------------- |
| 事件/载荷                | `PlayerPurchaseEvent` |
| 可用性                  | 需 Paper 模式及对应事件类      |
| PLAYER               | 此事件关联的玩家              |
| SOURCE               | 任务玩家                  |
| TARGET               | 仅商人为实体时存在             |
| LOCATION             | 实体商人位置（存在时），否则玩家位置    |
| TRIGGER\_ITEM / slot | 交易结果 / HAND           |

[触发器概览](/ultimatequest-zhong-wen-wen-dang/pei-zhi/triggers.md) · [事件条件](/ultimatequest-zhong-wen-wen-dang/pei-zhi/conditions.md)