# 附魔API

## 钩子函数（附魔脚本：contents/enchantments/...）

### void UpdateArmoredByPlayer(Player player, ItemSlot itemSlot, int level)

```lua
function UpdateArmoredByPlayer(player, itemSlot, level)
    
end
```

玩家正确装备盔甲且拥有当前附魔时每帧调用该函数。

* `player`表示装备当前盔甲的玩家。
* `itemSlot`表示当前盔甲所在的物品格子。
* `level`表示当前附魔等级。

### void UpdateHeldByPlayer(Player player, ItemSlot itemSlot, int level)

```lua
function UpdateHeldByPlayer(player, itemSlot, level)
    
end
```

玩家手持工具且拥有当前附魔时每帧调用该函数。

* `player`表示当前玩家。
* `itemSlot`表示手持工具所在的物品格子。
* `level`表示当前附魔等级。

### void OnHitArmoredPlayerFromNpc(Player player, Npc fromNpc, ItemSlot itemSlot, int level)

```lua
function OnHitArmoredPlayerFromNpc(player, npc, itemSlot, level)
    
end
```

玩家正确装备盔甲且拥有当前附魔并被指定NPC击中时调用该函数。

* `player`表示当前玩家。
* `npc`攻击玩家的NPC。
* `itemSlot`表示手持工具所在的物品格子。
* `level`表示当前附魔等级。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://blueyoshi.gitbook.io/terracraft/cn/mod/api/enchantment.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.