mirror of
https://github.com/MirrorNetworking/Mirror.git
synced 2024-11-18 19:10:32 +00:00
34 lines
2.7 KiB
Markdown
34 lines
2.7 KiB
Markdown
# Attributes Overview
|
|
|
|
Networking attributes are added to member functions of NetworkBehaviour scripts, to make them run on either the client or server.
|
|
|
|
These attributes can be used for Unity game loop methods like Start or Update, as well as other implemented methods.
|
|
|
|
- **NetworkSettings**
|
|
This attribute has been deprecated because `channels` were moved to transports (where applicable) and `interval` was moved to an inspector property
|
|
- **Server**
|
|
means don't allow a client to call that method (throws a warning or an error when called on a client).
|
|
- **ServerCallback**
|
|
A Custom Attribute that can be added to member functions of NetworkBehaviour scripts, to make them only run on servers.
|
|
- **Client**
|
|
means don't allow a server to call that method (throws a warning or an error when called on the server).
|
|
- **ClientCallback**
|
|
A Custom Attribute that can be added to member functions of NetworkBehaviour scripts, to make them only run on clients, but not generate warnings.
|
|
- **ClientRpc**
|
|
The server uses an Rpc to run that function on clients. See also: [Remote Actions](../Concepts/Communications/RemoteActions)
|
|
- **TargetRpc**
|
|
This is an attribute that can be put on methods of NetworkBehaviour classes to allow them to be invoked on clients from a server. Unlike the ClientRpc attribute, these functions are invoked on one individual target client, not all of the ready clients. See also: [Remote Actions](../Concepts/Communications/RemoteActions)
|
|
- **Command**
|
|
Call this from a client to run this function on the server. Make sure to validate input etc. It's not possible to call this from a server. Use this as a wrapper around another function, if you want to call it from the server too. See also: [Remote Actions](../Concepts/Communications/RemoteActions)
|
|
The allowed argument types are;
|
|
- Basic type (byte, int, float, string, UInt64, etc)
|
|
- Built-in Unity math type (Vector3, Quaternion, etc),
|
|
- Arrays of basic types
|
|
- Structs containing allowable types
|
|
- NetworkIdentity
|
|
- GameObject with a NetworkIdentity component attached.
|
|
- **SyncVar**
|
|
[SyncVars](SyncVars) are used to synchronize a variable from the server to all clients automatically. Don't assign them from a client, it's pointless. Don't let them be null, you will get errors. You can use int, long, float, string, Vector3 etc. (all simple types) and NetworkIdentity and GameObject if the GameObject has a NetworkIdentity attached to it. You can use [hooks](SyncVarHook).
|
|
- **SyncEvent**
|
|
[SyncEvents](SyncEvents) are networked events like ClientRpc's, but instead of calling a function on the GameObject, they trigger Events instead.
|