Passer au contenu principal
Version: bleeding-edge 🩸

Authority Concepts

Tout ce que vous avez besoin de savoir sur les concepts d'autorité et d'autorité de réseau.

Autorité

Certaines classes ne peuvent être créées que par le serveur, d'autres ne peuvent être créées que par le client, et il y en a quelques-unes qui peuvent être créées à la fois par le serveur ou par le client. Le côté où la Classe est créée est appelé Autorité.

Disponibilité des méthodes et des événements

Certaines méthodes et événements dans l'API ne sont disponibles que sur un côté spécifique \(Client ou Serveur\), les autres ne sont disponibles que dans le côté qui a l'autorité):

Côté Serveur

Méthode ou Événements qui ne peuvent être appelés que par le côté Serveur.

Côté Client

Méthode ou Événements qui ne peuvent être appelés que par le côté Client.

Côté Autorité

Méthodes ou Événements qui ne peuvent être appelés que par le côté qui l'a créé.

Network Authority Side

Methods or Events which can be called in the Server and also in the Client if the Local Player is the Network Authority of that entity.

Both Sides

Methods or Events which can only be called in any side.

tip

All entities spawned in the Server will be automatically synced in the Client. I.e. you can access it's methods and get all data from it without needing to manually sync it.

In the same way, entities spawned in the Client will only exist for that Client, trying to send those entities to the server will cause errors.

Autorité Réseau

Another important concept in nanos world is the Network Authority. We have a "distributed network authority" concept, which means the work of calculating physics and AI (for example) are automatically assigned and distributed to the clients. In general, if a Base Actor is near an in-game Character, it's physics will be calculated by that player's device. The Player that is responsible for calculating and sharing the results is called Network Authority.

The Player assigned is automatically calculated by the server and takes some things into consideration, this calculation is only made if the Player is possessing a Character:

  • La distance entre le Personnage et l'objet
  • Si le Personnage saisit un objet Prop
  • If the Character is handling a Base Pickable
  • Si le Personnage conduit un Véhicule
  • Si le personnage vient juste de tirer sur quelque chose

In all this cases, the Player will be automatically assigned to be the Network Authority of that Object.

Outrepasser l'Autorité Réseau actuelle

It is possible to override the current Network Authority of a specific entity by using the method :SetNetworkAuthority().

tip

Under certain circumstances, actors may not be in Distributed Network Authority mode. This means they cannot have their current network authority changed. Example: if a player is driving a Vehicle or using a Weapon, mandatorily he is the the Vehicle and Weapons's Network Authority, and this cannot be overwritten through scripting. To validate if an Actor can have it overridden, you can use the method :IsNetworkDistributed().

You can also prevent it from being automatically distributed to other Players by calling :SetNetworkAuthorityAutoDistributed(false).

attention

Always remember to restore the automatic Network Authority Distribution by calling :SetNetworkAuthorityAutoDistributed(true). Otherwise that entity may behave completely weird.

Examples of actions that are only executed by the Network Authority of that Actor

  • Synchronisation de la physique des objets (y compris lors de l'appel de :SetForce()).
  • Les PNJ se déplaçant avec :MoveTo() ou :Follow().

Débogage du Réseau & de l'Autorité Réseau

We've added a new option in the settings to Draw Network Debug information in the World, you can toggle it in the settings (Settings -> Debug -> Draw Network Debug), it will draw squares on each entity and traces representing their networked movement.

Entity Square Colors Meaning

The Square in the entities represent the state in the Network Authority and it's health.

CouleurSignification
BLEUVous êtes l'Autorité Réseau actuelle de cette entité.
Vous partagez des données de synchronisation avec les autres joueurs.
BLANCVous n'êtes pas l'Autorité Réseau et l'entité est en veille.
L'autorité réseau actuelle n'envoie pas de données synchronisées car l'entité est en veille.
VERTVous n'êtes pas l'Autorité Réseau et l'entité est en cours de synchronisation dans une cadence excellente (pas de retard).
ORANGEVous n'êtes pas l'Autorité Réseau et l'entité est en cours de synchronisation dans une cadence correcte (petit décalage - < 100ms).
ROUGEVous n'êtes pas l'Autorité de Réseau et l'entité est en cours de synchronisation dans une cadence ralentie (grand décalage - > 100ms, peut-être même avec la perte de paquets).

Entity Trace Colors Meaning

The Traces in the entities represent the network data received from the server. If you are the network authority you won't see the traces. The arrow points from where the entity is currently in your machine and where it should be accordingly to the network authority.

CouleurSignification
VERTL'entité est en cours de synchronisation dans une cadence de excellente (pas de décalage).
ORANGEL'entité est en cours de synchronisation dans une cadence correcte (petit décalage - < 100ms).
ROUGEL'entité est en cours de synchronisation dans une cadence ralentie (grand décalage - > 100ms, peut-être même avec perte de paquets).