---
title: "UpdatePlayer3DTextLabelText | open.mp"
description: "更新玩家3D文本标签的文本内容及颜色。"
canonical: https://omp.itsneufox.com/zh-CN/docs/scripting/functions/UpdatePlayer3DTextLabelText
language: zh-CN
---

# UpdatePlayer3DTextLabelText

## 描述

更新指定玩家 3D 文本标签的文本内容及颜色。

| 参数 | 说明 |
| --- | --- |
| playerid | 创建该 3D 文本标签的玩家 ID |
| PlayerText3D:textid | 需要更新的 3D 文本标签 ID |
| colour | 3D 文本标签的新颜色值（十六进制格式） |
| const text\[\] | 3D 文本标签的新文本内容 |
| OPEN\_MP\_TAGS:... | 用于格式化文本的可变参数（类似 printf 语法） |

## 返回值

此函数不返回特定值。

## 注意事项

注意

若 text\[\]为空字符串，原版 SA-MP 中附近客户端/服务端可能崩溃！（该问题在 open.mp 中已修复）

## 相关函数

-   [CreatePlayer3DTextLabel](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/CreatePlayer3DTextLabel): 为指定玩家创建 3D 文本标签
-   [DeletePlayer3DTextLabel](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/DeletePlayer3DTextLabel): 删除玩家的 3D 文本标签
-   [GetPlayer3DTextLabelText](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/GetPlayer3DTextLabelText): 获取玩家 3D 文本标签的文本内容
-   [GetPlayer3DTextLabelColour](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/GetPlayer3DTextLabelColour): 获取玩家 3D 文本标签的颜色值
-   [Update3DTextLabelText](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/Update3DTextLabelText): 更新全局 3D 文本标签的显示内容