---
title: "CreatePlayer3DTextLabel | open.mp"
description: "为指定玩家创建专属的3D文本标签。"
canonical: https://omp.itsneufox.com/zh-CN/docs/scripting/functions/CreatePlayer3DTextLabel
language: zh-CN
---

# CreatePlayer3DTextLabel

## 描述

创建仅对特定玩家可见的 3D 文本标签，支持实体绑定和视线检测功能。

| 参数 | 说明 |
| --- | --- |
| playerid | 可见该标签的目标玩家 ID |
| const text\[\] | 显示文本内容（支持格式符） |
| colour | 颜色值（使用整数或 RGBA 十六进制格式） |
| Float:x | X 轴坐标（若绑定实体则为偏移量） |
| Float:y | Y 轴坐标（若绑定实体则为偏移量） |
| Float:z | Z 轴坐标（若绑定实体则为偏移量） |
| Float:drawDistance | 可视距离（单位：游戏单位） |
| attachedplayer | 绑定玩家实体 ID（不绑定填 INVALID\_PLAYER\_ID） |
| attachedvehicle | 绑定车辆实体 ID（不绑定填 INVALID\_VEHICLE\_ID） |
| bool:testLOS | 视线检测开关（true=穿透物体不可见，false=可穿透显示） |
| OPEN\_MP\_TAGS:... | 扩展参数（支持任意类型参数） |

## 返回值

成功返回私有 3D 文本标签 ID，达到玩家标签上限（MAX\_3DTEXT\_PLAYER）时返回 INVALID\_3DTEXT\_ID。

## 应用示例

```c
public OnPlayerCommandText(playerid, cmdtext[])
{
    if (!strcmp(cmdtext, "/playerlabel", true))
    {
        new
            PlayerText3D:playerTextId,
            name[MAX_PLAYER_NAME],
            Float:x, Float:y, Float:z,
            string[64];

        GetPlayerName(playerid, name, sizeof(name));
        GetPlayerPos(playerid, x, y, z);

        // 创建带玩家名的动态标签
        format(string, sizeof(string), "你好 %s!\n我在你的当前位置", name);
        playerTextId = CreatePlayer3DTextLabel(playerid, string, 0x008080FF, x, y, z, 40.0);
        return 1;
    }
    return 0;
}
```

## 注意事项

备注

观察模式下有效显示距离会显著缩短

注意

空文本可能导致客户端崩溃（open.mp 版本已修复此问题）

## 关联函数

-   [DeletePlayer3DTextLabel](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/DeletePlayer3DTextLabel): 删除私有标签
-   [IsValidPlayer3DTextLabel](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/IsValidPlayer3DTextLabel): 验证有效性
-   [UpdatePlayer3DTextLabelText](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/UpdatePlayer3DTextLabelText): 更新标签文本
-   [GetPlayer3DTextLabelText](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/GetPlayer3DTextLabelText): 获取当前文本
-   [GetPlayer3DTextLabelColour](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/GetPlayer3DTextLabelColour): 获取颜色值
-   [GetPlayer3DTextLabelPos](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/GetPlayer3DTextLabelPos): 获取坐标位置
-   [GetPlayer3DTextLabelDrawDistance](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/GetPlayer3DTextLabelDrawDistance): 获取可视距离
-   [SetPlayer3DTextLabelDrawDistance](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/SetPlayer3DTextLabelDrawDistance): 设置可视距离
-   [GetPlayer3DTextLabelVirtualWorld](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/GetPlayer3DTextLabelVirtualWorld): 获取虚拟世界
-   [SetPlayer3DTextLabelVirtualWorld](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/SetPlayer3DTextLabelVirtualWorld): 设置虚拟世界
-   [GetPlayer3DTextLabelLOS](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/GetPlayer3DTextLabelLOS): 获取视线检测状态
-   [SetPlayer3DTextLabelLOS](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/SetPlayer3DTextLabelLOS): 设置视线检测状态
-   [Create3DTextLabel](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/Create3DTextLabel): 创建全局可见标签