---
sidebarDepth: 1
---
# 行为

## UseItemAttackEntity

<span style="display:inline;color:#ff5555">服务端</span>

method in mod.server.component.gameCompServer.GameComponentServer

- 描述

    使用指定物品攻击某个实体。

- 参数

    | 参数名 | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- | :--- |
    | itemDict | dict | 物品字典数据 |
    | entityId | str | 攻击实体id |
    | cause | str | 伤害类型，默认值是EntityAttack，详见Minecraft枚举值文档的[ActorDamageCause](../../枚举值/ActorDamageCause.md) |
    | attackerPos | tuple(float,float,float) | 伤害来源坐标，默认值为None，该参数会影响击退效果的计算 |
    | knocked | bool | 是否击退，默认值为False，如果设置为True，需同时设置attackerPos |
    | customTag | str | 标识自定义伤害来源，只在cause为Custom生效，可在ActorHurtServerEvent、ActuallyHurtServerEvent、DamageEvent、PlayerHurtEvent、PlayerDieEvent、MobDieEvent监听到标识 |

- 返回值

    | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- |
    | dict | 成功：返回使用过后的物品字典；失败：返回None |

- 备注
    - 无攻击力的物品，将会没有伤害。
    - 有耐久的物品在攻击后，将会扣除部分耐久。
    - 可通过DamageEvent等事件修改伤害值。
    - 如果itemDict写入了不可添加到该物品的附魔，该附魔效果将不会生效，返回的itemDict也不会带有该附魔信息。如果有需求，可考虑将附魔信息写入userData。

- 示例

```python
import mod.server.extraServerApi as serverApi
levelId = serverApi.GetLevelId()
comp = serverApi.GetEngineCompFactory().CreateGame(levelId)
itemDict = {
    "newItemName": "minecraft:iron_sword",
    "newAuxValue": 0,
    "count": 1,
    "durability": 256,
    "enchantData": [(9,1)]
}
print(comp.UseItemAttackEntity(itemDict, entityId))
```