Mirror/doc/Articles/Guides/Communications/NetworkManager.md
James Frowen b86a611674
Restructure docs (#2249)
* moving all guides to Articles folder

* updating toc for root and articles

* fixing toc

* css on side toc

* fixing links on index
2020-09-16 22:27:05 +01:00

69 lines
2.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Network Manager Callbacks
**See also <xref:Mirror.NetworkManager> in the API Reference.**
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 modes 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:
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
When the client starts:
- `OnStartClient`
- `OnClientConnect`
- `OnClientChangeScene`
- `OnClientSceneChanged`
When the client stops:
- `OnStopClient`
- `OnClientDisconnect`
## Server Mode
When the server starts:
- `OnStartServer`
- `OnServerSceneChanged`
When a client connects:
- `OnServerConnect`
- `OnServerReady`
- `OnServerAddPlayer`
When a client disconnects:
- `OnServerDisconnect`
When the server stops:
- `OnStopServer`