> For the complete documentation index, see [llms.txt](https://mirror-networking.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mirror-networking.gitbook.io/docs/manual/guides/communications/networkmanager-callbacks.md).

# NetworkManager Callbacks

{% hint style="info" %}
See also [NetworkManager](https://storage.googleapis.com/mirror-api-docs/html/d7/d5a/class_mirror_1_1_network_manager.html) in the API Reference.
{% endhint %}

There are a number of events that can occur over the course of the normal operation of a multiplayer game, such as the host starting up, a player joining, or a player leaving. Each of these possible events has an associated callback that you can implement in your own code to take action when the event occurs.

To do this for the `NetworkManager`, you need to create your own script which inherits from `NetworkManager`. You can then override the virtual methods on `NetworkManager` with your own implementation of what should happen when the given event occurs.

This page lists all the virtual methods (the callbacks) that you can implement on the `NetworkManager`, and when they occur. The callbacks that occur, and the order they occur, vary slightly depending on which mode your game is running in, so each mode’s callbacks are listed separately below.

A game can be running in one of three modes, host, client, or server-only. The callbacks for each mode are listed below:

## Host Mode: <a href="#host-mode" id="host-mode"></a>

When the host is started:

* `OnStartServer`
* `OnStartHost`
* `OnServerConnect`
* `OnStartClient`
* `OnClientConnect`
* `OnServerSceneChanged`
* `OnServerReady`
* `OnServerAddPlayer`
* `OnClientChangeScene`
* `OnClientSceneChanged`

When a client connects:

* `OnServerConnect`
* `OnServerReady`
* `OnServerAddPlayer`

When a client disconnects:

* `OnServerDisconnect`

When the host is stopped:

* `OnStopHost`
* `OnServerDisconnect`
* `OnStopClient`
* `OnStopServer`

## Client Mode <a href="#client-mode" id="client-mode"></a>

When the client starts:

* `OnStartClient`
* `OnClientConnect`
* `OnClientChangeScene`
* `OnClientSceneChanged`

When the client stops:

* `OnStopClient`
* `OnClientDisconnect`

## Server Mode <a href="#server-mode" id="server-mode"></a>

When the server starts:

* `OnStartServer`
* `OnServerSceneChanged`

When a client connects:

* `OnServerConnect`
* `OnServerReady`
* `OnServerAddPlayer`

When a client disconnects:

* `OnServerDisconnect`

When the server stops:

* `OnStopServer`


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://mirror-networking.gitbook.io/docs/manual/guides/communications/networkmanager-callbacks.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
