---
title: "OnVehicleMod | open.mp"
description: "当车辆被改装时触发此回调函数。"
canonical: https://omp.itsneufox.com/zh-CN/docs/scripting/callbacks/OnVehicleMod
language: zh-CN
---

# OnVehicleMod

## 描述

当车辆被改装（添加组件）时触发此回调函数。

| 参数 | 说明 |
| --- | --- |
| playerid | 进行改装的玩家ID（车辆驾驶员） |
| vehicleid | 被改装的车辆ID |
| componentid | 添加到车辆的改装组件ID |

## 返回值

此回调始终在游戏模式中优先触发，返回0将阻止其他滤镜脚本处理此事件。

## 示例

```c
public OnVehicleMod(playerid, vehicleid, componentid)
{
    printf("车辆 %d 被玩家 %d 改装，使用组件ID %d", vehicleid, playerid, componentid);

    if (GetPlayerInterior(playerid) == 0)
    {
        BanEx(playerid, "非法改装"); // 反非法改装脚本
        return 0; // 阻止非法改装同步给其他玩家
        // 经测试有效，即使服务器允许通过指令/菜单等方式改装
    }
    return 1;
}
```

## 注意事项

备注

此回调不会通过 [AddVehicleComponent](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/AddVehicleComponent) 函数触发

## 相关回调

以下回调可能与此回调存在关联：

-   [OnEnterExitModShop](https://omp.itsneufox.com/zh-CN/docs/scripting/callbacks/OnEnterExitModShop): 当车辆进入/离开改装店时触发
-   [OnVehiclePaintjob](https://omp.itsneufox.com/zh-CN/docs/scripting/callbacks/OnVehiclePaintjob): 当车辆涂装变更时触发
-   [OnVehicleRespray](https://omp.itsneufox.com/zh-CN/docs/scripting/callbacks/OnVehicleRespray): 当车辆重新涂装时触发

## 相关函数

以下函数可能与此回调存在关联：

-   [AddVehicleComponent](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/AddVehicleComponent): 为车辆添加改装组件
-   [RemoveVehicleComponent](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/RemoveVehicleComponent): 移除车辆的改装组件
-   [GetVehicleComponentType](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/GetVehicleComponentType): 获取组件类型信息

## 相关资源

-   [车辆改装组件列表](https://omp.itsneufox.com/zh-CN/docs/scripting/resources/carcomponentid)
