---
title: "OnPlayerConnect | open.mp"
description: "当玩家连接到服务器时触发此回调"
canonical: https://omp.itsneufox.com/zh-CN/docs/scripting/callbacks/OnPlayerConnect
language: zh-CN
---

# OnPlayerConnect

## 描述

当玩家成功连接到服务器时触发此回调。

| 参数 | 说明 |
| --- | --- |
| playerid | 连接的玩家ID |

## 返回值

0 - 阻止其他滤镜脚本接收此回调  
1 - 允许传递给后续滤镜脚本

此回调在滤镜脚本中总是优先触发。

## 示例

```c
public OnPlayerConnect(playerid)
{
    new
        string[64],
        playerName[MAX_PLAYER_NAME];

    GetPlayerName(playerid, playerName, MAX_PLAYER_NAME);
    format(string, sizeof string, "%s 加入了服务器，欢迎！", playerName);
    SendClientMessageToAll(0xFFFFFFAA, string);
    return 1;
}
```

## 注意

备注

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

## 相关回调

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

-   [OnPlayerDisconnect](https://omp.itsneufox.com/zh-CN/docs/scripting/callbacks/OnPlayerDisconnect)：当玩家离开服务器时触发
-   [OnIncomingConnection](https://omp.itsneufox.com/zh-CN/docs/scripting/callbacks/OnIncomingConnection)：当玩家尝试连接服务器时触发
-   [OnPlayerFinishedDownloading](https://omp.itsneufox.com/zh-CN/docs/scripting/callbacks/OnPlayerFinishedDownloading)：当玩家完成自定义模型下载时触发