Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

MultiplayerSpawner

Eredita: Node < Object

Replica automaticamente i nodi generabili dall'autorità ad altri peer multigiocatore.

Descrizione

Le scene generabili possono essere configurate nell'editor o tramite codice (vedi add_spawnable_scene()).

Supporta anche la generazione personalizzata di nodi tramite spawn(), chiamando spawn_function su tutti i peer.

Internamente, MultiplayerSpawner utilizza MultiplayerAPI.object_configuration_add() per notificare le generazioni, passando il nodo generato come object e se stesso come configuration, e MultiplayerAPI.object_configuration_remove() per notificare le eliminazioni in modo simile.

Proprietà

Callable

spawn_function

int

spawn_limit

0

NodePath

spawn_path

NodePath("")

Metodi

void

add_spawnable_scene(path: String)

void

clear_spawnable_scenes()

String

get_spawnable_scene(index: int) const

int

get_spawnable_scene_count() const

Node

spawn(data: Variant = null)


Segnali

despawned(node: Node) 🔗

Emesso quando una scena generabile o una generazione personalizzata è stata rimossa dall'autorità multigiocatore. Chiamato solo sui peer remoti.


spawned(node: Node) 🔗

Emesso quando una scena generabile o una generazione personalizzata è stata generata dall'autorità multigiocatore. Chiamato solo sui peer remoti.


Descrizioni delle proprietà

Callable spawn_function 🔗

Metodo chiamato su tutti i peer quando un spawn() personalizzato viene richiesto dall'autorità. Riceverà il parametro data e dovrebbe restituire un Node che non è nell'albero di scene.

Nota: Il nodo restituito non dovrebbe essere aggiunto alla scena con Node.add_child(). Ciò avviene automaticamente.


int spawn_limit = 0 🔗

  • void set_spawn_limit(value: int)

  • int get_spawn_limit()

Numero massimo di nodi che questo generatore può generare. Include sia scene generabili sia generazioni personalizzate.

Se impostato su 0 (predefinito), non ci sono limiti.


NodePath spawn_path = NodePath("") 🔗

Percorso verso la radice di generazione. Le scene generabili aggiunte come figlie dirette sono replicate sugli altri peer.


Descrizioni dei metodi

void add_spawnable_scene(path: String) 🔗

Aggiunge un percorso di scena alle scene generabili, facendolo replicare automaticamente dall'autorità multigiocatore ad altri peer quando vengono aggiunti come figli del nodo puntato da spawn_path.


void clear_spawnable_scenes() 🔗

Cancella tutte le scene generabili. Non elimina le istanze esistenti sui peer remoti.


String get_spawnable_scene(index: int) const 🔗

Restituisce il percorso della scena generabile per indice.


int get_spawnable_scene_count() const 🔗

Restituisce il numero di percorsi di scene generabili.


Node spawn(data: Variant = null) 🔗

Richiede una generazione personalizzata, con data passato a spawn_function su tutti i peer. Restituisce l'istanza del nodo generato localmente già all'interno dell'albero di scene e aggiunto come figlio del nodo puntato da spawn_path.

Nota: Le scene generabili sono generate automaticamente. spawn() è necessario solo per le generazioni personalizzate.