---
title: "OnPlayerText | open.mp"
description: "当玩家发送聊天消息时触发此回调函数。"
canonical: https://omp.itsneufox.com/zh-CN/docs/scripting/callbacks/OnPlayerText
language: zh-CN
---

# OnPlayerText

## 描述

当玩家在聊天框发送消息时触发此回调函数。

| 参数 | 说明 |
| --- | --- |
| playerid | 发送消息的玩家ID |
| text\[\] | 玩家发送的消息内容 |

## 返回值

此回调始终在滤镜脚本中优先触发，返回0将阻止其他脚本处理此消息。

## 示例

```c
public OnPlayerText(playerid, text[])
{
    new string[144];
    format(string, sizeof (string), "(%d) %s", playerid, text);
    SendPlayerMessageToAll(playerid, string);

    // 返回0将忽略默认消息格式，发送自定义消息
    // 返回1会导致消息重复显示（默认消息也会发送）
    return 0;
}
```

## 注意事项

备注

这个回调也可以由NPC调用。

技巧

默认情况下，此回调会发送包含玩家昵称、ID和消息内容的系统格式消息。返回0可禁用此默认行为（如示例代码所示）。

## 相关回调

以下回调可能与此回调存在关联：

-   [OnPlayerCommandText](https://omp.itsneufox.com/zh-CN/docs/scripting/callbacks/OnPlayerCommandText): 当玩家输入指令时触发

## 相关函数

以下函数可能与此回调存在关联：

-   [SendPlayerMessageToPlayer](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/SendPlayerMessageToPlayer): 向指定玩家发送玩家消息
-   [SendPlayerMessageToAll](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/SendPlayerMessageToAll): 向全体玩家发送玩家消息
-   [ToggleChatTextReplacement](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/ToggleChatTextReplacement): 切换聊天过滤器状态