---
title: "CreateVehicle | open.mp"
description: "在游戏世界中创建车辆。"
canonical: https://omp.itsneufox.com/zh-CN/docs/scripting/functions/CreateVehicle
language: zh-CN
---

# CreateVehicle

## 描述

在游戏世界中动态创建车辆，可在脚本任意时刻替代 AddStaticVehicleEx 使用。

| 参数 | 说明 |
| --- | --- |
| [modelid](https://omp.itsneufox.com/zh-CN/docs/scripting/resources/vehicleid) | 车辆模型 ID |
| Float:spawnX | 车辆生成的 X 轴坐标 |
| Float:spawnY | 车辆生成的 Y 轴坐标 |
| Float:spawnZ | 车辆生成的 Z 轴坐标 |
| Float:angle | 车辆初始朝向角度 |
| [colour1](https://omp.itsneufox.com/zh-CN/docs/scripting/resources/vehiclecolorid) | 主颜色 ID |
| [colour2](https://omp.itsneufox.com/zh-CN/docs/scripting/resources/vehiclecolorid) | 副颜色 ID |
| respawnDelay | 无驾驶员时车辆重生延迟（秒）。使用-1 将禁用自动重生 |
| bool:addSiren | 默认值'false'。为车辆启用警报器功能（需车辆自带喇叭） |

## 返回值

返回创建的车辆 ID（范围 1 至 MAX\_VEHICLES）。

若达到车辆数量上限或模型 ID 无效，返回 INVALID\_VEHICLE\_ID (65535)。

若使用火车模型 ID（538 或 537），返回 0（不可用）。

## 示例

```c
public OnGameModeInit()
{
    // 在游戏中添加一架九头蛇直升机（520），重生时间为60秒
    CreateVehicle(520, 2109.1763, 1503.0453, 32.2887, 82.2873, -1, -1, 60);
    return 1;
}
```

## 注意事项

注意

火车车辆仅能通过[AddStaticVehicle](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/AddStaticVehicle)和[AddStaticVehicleEx](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/AddStaticVehicleEx)添加

## 相关函数

-   [DestroyVehicle](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/DestroyVehicle): 销毁车辆
-   [AddStaticVehicle](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/AddStaticVehicle): 添加静态车辆
-   [AddStaticVehicleEx](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/AddStaticVehicleEx): 添加带自定义重生时间的静态车辆
-   [GetVehicleParamsSirenState](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/GetVehicleParamsSirenState): 检测车辆警报器状态
-   [SetVehicleSpawnInfo](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/SetVehicleSpawnInfo): 配置车辆生成参数
-   [GetVehicleSpawnInfo](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/GetVehicleSpawnInfo): 获取车辆生成信息
-   [ChangeVehicleColours](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/ChangeVehicleColours): 修改车辆颜色配置
-   [GetVehicleColours](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/GetVehicleColours): 获取车辆颜色配置
-   [SetVehicleRespawnDelay](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/SetVehicleRespawnDelay): 设置车辆重生延迟
-   [GetVehicleRespawnDelay](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/GetVehicleRespawnDelay): 获取车辆重生延迟

## 相关回调

-   [OnVehicleSpawn](https://omp.itsneufox.com/zh-CN/docs/scripting/callbacks/OnVehicleSpawn): 车辆重生时触发
-   [OnVehicleSirenStateChange](https://omp.itsneufox.com/zh-CN/docs/scripting/callbacks/OnVehicleSirenStateChange): 警报器状态变化时触发

## 相关资源

-   [车辆模型列表](https://omp.itsneufox.com/zh-CN/docs/scripting/resources/vehicleid): 游戏中所有可用车辆模型的完整清单
-   [车辆颜色 ID 列表](https://omp.itsneufox.com/zh-CN/docs/scripting/resources/vehiclecolorid): 所有车辆颜色 ID 对照表