mirror of
https://github.com/MirrorNetworking/Mirror.git
synced 2024-11-18 19:10:32 +00:00
41 lines
1.7 KiB
Markdown
41 lines
1.7 KiB
Markdown
# NetworkBehaviour Callbacks
|
|
|
|
[![Network behaviour callbacks start cycle video tutorial](../../images/video_tutorial.png)](https://www.youtube.com/watch?v=5Oj4lPPIfps&list=PLkx8oFug638oBYF5EOwsSS-gOVBXj1dkP&index=4)
|
|
|
|
**See also <xref:Mirror.NetworkBehaviour> in the API Reference.**
|
|
|
|
Like the Network Manager callbacks, there are a number of events relating to network behaviours that can occur over the course of a normal multiplayer game. These include events 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.
|
|
|
|
When you create a script which inherits from `NetworkBehaviour`, you can write your own implementation of what should happen when these events occur. To do this, you override the virtual methods on the `NetworkBehaviour` class with your own implementation of what should happen when the given event occurs.
|
|
|
|
This page lists all the virtual methods (callbacks) that you can implement on `NetworkBehaviour`, and when they occur.
|
|
|
|
## Server mode
|
|
|
|
**When a client connects:**
|
|
- `OnStartServer`
|
|
- `OnRebuildObservers`
|
|
- `Start()` function is called
|
|
|
|
## Client mode
|
|
|
|
**When a client connects:**
|
|
- `OnStartClient`
|
|
- `OnStartLocalPlayer`
|
|
- `OnStartAuthority`
|
|
- `Start()` function is called
|
|
|
|
## Host mode
|
|
|
|
These are only called on the **Player Game Objects** when a client connects:
|
|
- `OnStartServer`
|
|
- `OnStartClient`
|
|
- `OnRebuildObservers`
|
|
- `OnStartAuthority`
|
|
- `OnStartLocalPlayer`
|
|
- `Start()` function is called
|
|
- `OnSetLocalVisibility`
|
|
|
|
**On any remaining clients, when a client disconnects:**
|
|
- `OnNetworkDestroy`
|