---
title: "CreateObject | open.mp"
description: "在游戏世界指定坐标处创建物体。"
canonical: https://omp.itsneufox.com/zh-CN/docs/scripting/functions/CreateObject
language: zh-CN
---

# CreateObject

## 描述

在三维空间指定位置生成静态/动态物体模型。

| 参数 | 说明 |
| --- | --- |
| modelid | 模型 ID |
| Float:x | X 轴坐标 |
| Float:y | Y 轴坐标 |
| Float:z | Z 轴坐标 |
| Float:rotationX | X 轴旋转角度 |
| Float:rotationY | Y 轴旋转角度 |
| Float:rotationZ | Z 轴旋转角度 |
| Float:drawDistance | （可选参数）自定义渲染距离（0.0=使用默认值） |

## 返回值

返回创建物体的 ID，若达到物体数量上限（MAX\_OBJECTS）则返回 INVALID\_OBJECT\_ID。

## 应用示例

```c
public OnGameModeInit()
{
    // 默认渲染距离的物体
    CreateObject(2587, 2001.195679, 1547.113892, 14.283400, 0.0, 0.0, 96.0);
    // 自定义300单位渲染距离的物体
    CreateObject(2587, 2001.195679, 1547.113892, 14.283400, 0.0, 0.0, 96.0, 300.0);
    return 1;
}
```

## 注意事项

备注

全局物体数量上限为 1000（MAX\_OBJECTS），建议使用[流加载插件](https://github.com/samp-incognito/samp-streamer-plugin)突破限制

## 关联函数

-   [DestroyObject](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/DestroyObject): 销毁物体
-   [IsValidObject](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/IsValidObject): 验证物体有效性
-   [MoveObject](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/MoveObject): 移动物体
-   [StopObject](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/StopObject): 停止物体移动
-   [SetObjectPos](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/SetObjectPos): 设置物体坐标
-   [SetObjectRot](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/SetObjectRot): 设置物体旋转
-   [GetObjectPos](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/GetObjectPos): 获取物体坐标
-   [GetObjectRot](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/GetObjectRot): 获取物体旋转角度
-   [AttachObjectToPlayer](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/AttachObjectToPlayer): 绑定物体到玩家
-   [SetObjectMaterialText](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/SetObjectMaterialText): 设置物体材质文字
-   [SetObjectMaterial](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/SetObjectMaterial): 替换物体材质
-   [CreatePlayerObject](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/CreatePlayerObject): 创建玩家私有物体
-   [DestroyPlayerObject](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/DestroyPlayerObject): 销毁私有物体
-   [IsValidPlayerObject](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/IsValidPlayerObject): 验证私有物体有效性
-   [MovePlayerObject](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/MovePlayerObject): 移动私有物体
-   [StopPlayerObject](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/StopPlayerObject): 停止私有物体移动
-   [SetPlayerObjectPos](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/SetPlayerObjectPos): 设置私有物体坐标
-   [SetPlayerObjectRot](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/SetPlayerObjectRot): 设置私有物体旋转
-   [GetPlayerObjectPos](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/GetPlayerObjectPos): 获取私有物体坐标
-   [GetPlayerObjectRot](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/GetPlayerObjectRot): 获取私有物体旋转
-   [AttachPlayerObjectToPlayer](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/AttachPlayerObjectToPlayer): 绑定私有物体到玩家
-   [SetPlayerObjectMaterialText](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/SetPlayerObjectMaterialText): 设置私有物体材质文字
-   [SetPlayerObjectMaterial](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/SetPlayerObjectMaterial): 替换私有物体材质