---
title: "IsValidObject | open.mp"
description: "检测指定ID的物体是否存在。"
canonical: https://omp.itsneufox.com/zh-CN/docs/scripting/functions/IsValidObject
language: zh-CN
---

# IsValidObject

## 描述

检测指定 ID 的游戏物体是否存在于服务器中。

| 参数名 | 说明 |
| --- | --- |
| objectid | 要检测的物体 ID |

## 返回值

**true** - 物体存在

**false** - 物体不存在

## 示例代码

```c
new objectid; // 全局物体存储变量

public OnGameModeInit()
{
    objectid = CreateObject(2587, 2001.195679, 1547.113892, 14.283400, 0.0, 0.0, 96.0);
    return 1;
}

public OnGameModeExit()
{
	if (IsValidObject(objectid))
	{
		DestroyObject(objectid); // 安全销毁物体
	}
    return 1;
}
```

## 注意事项

注意

此函数仅检测物体实例是否存在，不验证模型 ID 是否有效

## 相关函数

-   [CreateObject](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/CreateObject): 创建全局可见物体
-   [DestroyObject](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/DestroyObject): 销毁全局物体
-   [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): 将物体附加到玩家身上
-   [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): 将玩家物体附加到另一玩家