---
title: "IsPlayerInCheckpoint | open.mp"
description: "检测玩家是否处于检查点内，可用于房产或传送点等场景"
canonical: https://omp.itsneufox.com/zh-CN/docs/scripting/functions/IsPlayerInCheckpoint
language: zh-CN
---

# IsPlayerInCheckpoint

## 描述

检测玩家当前是否处于检查点范围内，此函数常用于房产系统或传送点等交互场景

| 参数名 | 说明 |
| --- | --- |
| playerid | 需要检测的玩家 ID |

## 返回值

**false** - 玩家未处于检查点内

**true** - 玩家正处于检查点内

## 示例代码

```c
if (IsPlayerInCheckpoint(playerid))
{
    SetPlayerHealth(playerid, 100.0);
}
```

## 相关函数

-   [SetPlayerCheckpoint](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/SetPlayerCheckpoint): 为玩家创建检查点
-   [IsPlayerCheckpointActive](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/IsPlayerCheckpointActive): 检测玩家当前是否显示检查点
-   [DisablePlayerCheckpoint](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/DisablePlayerCheckpoint): 禁用玩家当前检查点
-   [SetPlayerRaceCheckpoint](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/SetPlayerRaceCheckpoint): 为玩家创建竞速检查点
-   [DisablePlayerRaceCheckpoint](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/DisablePlayerRaceCheckpoint): 禁用玩家当前竞速检查点
-   [IsPlayerInRaceCheckpoint](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/IsPlayerInRaceCheckpoint): 检测玩家是否处于竞速检查点

## 相关回调

-   [OnPlayerEnterCheckpoint](https://omp.itsneufox.com/zh-CN/docs/scripting/callbacks/OnPlayerEnterCheckpoint): 当玩家进入检查点时触发
-   [OnPlayerLeaveCheckpoint](https://omp.itsneufox.com/zh-CN/docs/scripting/callbacks/OnPlayerLeaveCheckpoint): 当玩家离开检查点时触发
-   [OnPlayerEnterRaceCheckpoint](https://omp.itsneufox.com/zh-CN/docs/scripting/callbacks/OnPlayerEnterRaceCheckpoint): 当玩家进入竞速检查点时触发
-   [OnPlayerLeaveRaceCheckpoint](https://omp.itsneufox.com/zh-CN/docs/scripting/callbacks/OnPlayerLeaveRaceCheckpoint): 当玩家离开竞速检查点时触发