---
title: "GetPlayerRaceCheckpoint | open.mp"
description: "دریافت موقعیت race checkpoint فعلی."
canonical: https://omp.itsneufox.com/fa/docs/scripting/functions/GetPlayerRaceCheckpoint
language: fa
---

# GetPlayerRaceCheckpoint

هشدار

This function was added in omp v1.1.0.2612 and will not work in earlier versions!

## توضیحات

دریافت موقعیت race checkpoint فعلی.

| نام | توضیحات |
| --- | --- |
| playerid | ID بازیکن برای دریافت موقعیت checkpoint. |
| &Float:centreX | متغیر float برای ذخیره مختصات centreX، به صورت reference پاس داده می‌شود. |
| &Float:centreY | متغیر float برای ذخیره مختصات centreY، به صورت reference پاس داده می‌شود. |
| &Float:centreZ | متغیر float برای ذخیره مختصات centreZ، به صورت reference پاس داده می‌شود. |
| &Float:nextX | متغیر float برای ذخیره مختصات nextX، به صورت reference پاس داده می‌شود. |
| &Float:nextY | متغیر float برای ذخیره مختصات nextY، به صورت reference پاس داده می‌شود. |
| &Float:nextZ | متغیر float برای ذخیره مختصات nextZ، به صورت reference پاس داده می‌شود. |
| &Float:radius | متغیر float برای ذخیره شعاع، به صورت reference پاس داده می‌شود. |

## مقادیر برگشتی

این تابع هیچ مقدار خاصی برنمی‌گرداند.

## مثال‌ها

```c
SetPlayerRaceCheckpoint(playerid, CP_TYPE_GROUND_NORMAL, 373.1631, 2502.4644, 16.4774, 269.8644, 2503.4963, 16.4774, 2.0);

new Float:centreX,
    Float:centreY,
    Float:centreZ,
    Float:nextX,
    Float:nextY,
    Float:nextZ,
    Float:radius;

GetPlayerRaceCheckpoint(playerid, centreX, centreY, centreZ, nextX, nextY, nextZ, radius);
```

## توابع مرتبط

-   [SetPlayerCheckpoint](https://omp.itsneufox.com/fa/docs/scripting/functions/SetPlayerCheckpoint): ایجاد checkpoint برای بازیکن.
-   [DisablePlayerCheckpoint](https://omp.itsneufox.com/fa/docs/scripting/functions/DisablePlayerCheckpoint): غیرفعال کردن checkpoint فعلی بازیکن.
-   [IsPlayerInCheckpoint](https://omp.itsneufox.com/fa/docs/scripting/functions/IsPlayerInCheckpoint): بررسی اینکه آیا بازیکن در checkpoint است.
-   [SetPlayerRaceCheckpoint](https://omp.itsneufox.com/fa/docs/scripting/functions/SetPlayerRaceCheckpoint): ایجاد race checkpoint برای بازیکن.
-   [DisablePlayerRaceCheckpoint](https://omp.itsneufox.com/fa/docs/scripting/functions/DisablePlayerRaceCheckpoint): غیرفعال کردن race checkpoint فعلی بازیکن.
-   [IsPlayerInRaceCheckpoint](https://omp.itsneufox.com/fa/docs/scripting/functions/IsPlayerInRaceCheckpoint): بررسی اینکه آیا بازیکن در race checkpoint است.
-   [IsPlayerRaceCheckpointActive](https://omp.itsneufox.com/fa/docs/scripting/functions/IsPlayerRaceCheckpointActive): بررسی اینکه آیا بازیکن در حال حاضر race checkpoint قابل مشاهده دارد.

## کالبک‌های مرتبط

-   [OnPlayerEnterCheckpoint](https://omp.itsneufox.com/fa/docs/scripting/callbacks/OnPlayerEnterCheckpoint): زمانی که بازیکن وارد checkpoint می‌شود فراخوانی می‌شود.
-   [OnPlayerLeaveCheckpoint](https://omp.itsneufox.com/fa/docs/scripting/callbacks/OnPlayerLeaveCheckpoint): زمانی که بازیکن checkpoint را ترک می‌کند فراخوانی می‌شود.
-   [OnPlayerEnterRaceCheckpoint](https://omp.itsneufox.com/fa/docs/scripting/callbacks/OnPlayerEnterRaceCheckpoint): زمانی که بازیکن وارد race checkpoint می‌شود فراخوانی می‌شود.
-   [OnPlayerLeaveRaceCheckpoint](https://omp.itsneufox.com/fa/docs/scripting/callbacks/OnPlayerLeaveRaceCheckpoint): زمانی که بازیکن race checkpoint را ترک می‌کند فراخوانی می‌شود.