7. Bilanciare i giocatori durante una partita in corso

Quando un nuovo giocatore si unisce a una partita in corso, deve essere assegnato al team giusto in modo che i team siano bilanciati in modo equilibrato. Se questo team risulta essere quello degli Infiltrati, deve anche avere un'istanza di OnInfiltratorDamaged() associata.

Segui i passaggi seguenti per imparare come assegnare i giocatori al team corretto in modo bilanciato quando si uniscono a una partita in corso.

Configurare le funzioni di partecipazione dei giocatori

1. Aggiungi una nuova funzione OnInfiltratorJoined() alla definizione della classe invisibility_manager. Questa funzione prende un agente e genera un'istanza di OnInfiltratorDamaged() con l'agente indicato. Aggiungi lo specificatore ` ` a questa funzione per poterla chiamare da triad_infiltration_game.

    # Genera una funzione OnInfiltratorDamaged quando un nuovo infiltrato si unisce al gioco
    OnInfiltratorJoined<public>(InAgent:agent):void=
        spawn{OnInfiltratorDamaged(InAgent)}
   Copy full snippet

   # Genera una funzione OnInfiltratorDamaged quando un nuovo infiltrato si unisce al gioco OnInfiltratorJoined<public>(InAgent:agent):void= spawn{OnInfiltratorDamaged(InAgent)}
2. Aggiungi una nuova funzione OnPlayerAdded() alla definizione della classe triad_infiltration_game. Questa funzione prende un giocatore, lo assegna alla squadra appropriata e chiama OnInfiltratorJoined() se il nuovo giocatore è un Infiltrato.

    # Gestisce un nuovo giocatore che si unisce al gioco.
    OnPlayerAdded(InPlayer:player):void=
   Copy full snippet

   # Gestisce un nuovo giocatore che si unisce al gioco. OnPlayerAdded(InPlayer:player):void=
3. Ottieni fort_team_collection per lo spazio di gioco attuale e memorizzala in una variabile FortTeamCollection.

    # Gestisce un nuovo giocatore che si unisce al gioco.
    OnPlayerAdded(InPlayer:player):void=
        Logger.Print("Si è unito un nuovo giocatore, assegnazione a un team in corso")
        FortTeamCollection := GetPlayspace().GetTeamCollection()
   Copy full snippet

   # Gestisce un nuovo giocatore che si unisce al gioco. OnPlayerAdded(InPlayer:player):void= Logger.Print("Si è unito un nuovo giocatore, assegnazione a un team in corso") FortTeamCollection := GetPlayspace().GetTeamCollection()

   Bilanciamento dei team tramite refactoring

4. Devi assegnare il nuovo giocatore al team corretto: tuttavia se chiami BalanceTeams() finirai per redistribuire tutti i giocatori in un nuovo team. Invece di riscrivere il codice per trovare il team meno numeroso per il nuovo giocatore, ti consigliamo di optare per una strategia di refactoring.
   1. Aggiungi un nuovo Metodo BalancePlayer() alla definizione della classe triad_infiltration_game. Questo metodo prende un giocatore e lo bilancia in modo asimmetrico all'interno del team corretto.

       # Per ogni giocatore, scorri l'elenco dei team e assegnalo al 
       # team con il minor numero di giocatori o il team iniziale in caso di parità.
       BalancePlayer(InPlayer:player):void=
           Logger.Print("Avvio del bilanciamento dei giocatori")
      Copy full snippet

      # Per ogni giocatore, scorri l'elenco dei team e assegnalo al # team con il minor numero di giocatori o il team iniziale in caso di parità. BalancePlayer(InPlayer:player):void= Logger.Print("Avvio del bilanciamento dei giocatori")
   2. Estrai il codice all'interno del loop for di BalanceTeams() e inseriscilo all'interno di BalancePlayer(), rinominando TeamPlayer in InPlayer. Il codice BalancePlayer() dovrebbe essere simile al seguente:

       # Per ogni giocatore, scorri l'elenco dei team e assegnalo al 
       # team con il minor numero di giocatori o il team iniziale in caso di parità.
       BalancePlayer(InPlayer:player):void=
           Logger.Print("Avvio del bilanciamento dei giocatori")
           var TeamToAssign:?team = false
           set TeamToAssign = FindTeamWithLargestDifference()
           if (AssignedTeam := TeamToAssign?, GetPlayspace().GetTeamCollection().AddToTeam[InPlayer, AssignedTeam]):
               Logger.Print("Tentativo di assegnare il nuovo giocatore a un nuovo team")
           else:
               Logger.Print("Il giocatore era già membro del team meno numeroso")
      Copy full snippet

      # Per ogni giocatore, scorri l'elenco dei team e assegnalo al # team con il minor numero di giocatori o il team iniziale in caso di parità. BalancePlayer(InPlayer:player):void= Logger.Print("Avvio del bilanciamento dei giocatori") var TeamToAssign:?team = false set TeamToAssign = FindTeamWithLargestDifference() if (AssignedTeam := TeamToAssign?, GetPlayspace().GetTeamCollection().AddToTeam[InPlayer, AssignedTeam]): Logger.Print("Tentativo di assegnare il nuovo giocatore a un nuovo team") else: Logger.Print("Il giocatore era già membro del team meno numeroso")
   3. Ora in BalanceTeams(), aggiungi una chiamata a BalancePlayer() all'interno del loop for. Ciò conserva la funzionalità di BalanceTeams() e permette di bilanciare un giocatore individualmente. Il codice BalanceTeams() dovrebbe essere simile al seguente:

       # Bilancia equamente i giocatori di tutti i team presenti nel gioco
       BalanceTeams():void=
           Logger.Print("Avvio del bilanciamento dei team")
           var AllPlayers:[]player := GetPlayspace().GetPlayers()
           set AllPlayers = Shuffle(AllPlayers)
           Logger.Print("La lunghezza di AllPlayers è {AllPlayers.Length}")
           for(TeamPlayer:AllPlayers):
               BalancePlayer(TeamPlayer)
      Copy full snippet

      # Bilancia equamente i giocatori di tutti i team presenti nel gioco BalanceTeams():void= Logger.Print("Avvio del bilanciamento dei team") var AllPlayers:[]player := GetPlayspace().GetPlayers() set AllPlayers = Shuffle(AllPlayers) Logger.Print("La lunghezza di AllPlayers è {AllPlayers.Length}") for(TeamPlayer:AllPlayers): BalancePlayer(TeamPlayer)
5. Torna in OnPlayerAdded(), aggiungi una chiamata a BalancePlayer() passando il giocatore che si è appena unito.

    # Gestisce un nuovo giocatore che si unisce al gioco.
    OnPlayerAdded(InPlayer:player):void=
        Logger.Print("Si è unito un nuovo giocatore, assegnazione a un team in corso")
        FortTeamCollection := GetPlayspace().GetTeamCollection()
        set AllPlayers = GetPlayspace().GetPlayers()
        # Assegna il nuovo giocatore al team meno numeroso
        BalancePlayer(InPlayer)
   Copy full snippet

   # Gestisce un nuovo giocatore che si unisce al gioco. OnPlayerAdded(InPlayer:player):void= Logger.Print("Si è unito un nuovo giocatore, assegnazione a un team in corso") FortTeamCollection := GetPlayspace().GetTeamCollection() set AllPlayers = GetPlayspace().GetPlayers() # Assegna il nuovo giocatore al team meno numeroso BalancePlayer(InPlayer)
6. Trova l'indice del team del giocatore dopo il bilanciamento scorrendo ogni team nell'array Teams, utilizzando GetTeam[] come un filtro per controllare che corrisponda a PlayerTeam.

     # Gestisce un nuovo giocatore che si unisce al gioco.
    OnPlayerAdded(InPlayer:player):void=
        Logger.Print("Si è unito un nuovo giocatore, assegnazione a un team in corso")
        FortTeamCollection := GetPlayspace().GetTeamCollection()
           
        # Assegna il nuovo giocatore al team meno numeroso in modo asimmetrico.
        BalancePlayer(InPlayer)
   
        for:
            TeamIndex -> PlayerTeam:Teams
            PlayerTeam = FortTeamCollection.GetTeam[InPlayer]
   Copy full snippet

   # Gestisce un nuovo giocatore che si unisce al gioco. OnPlayerAdded(InPlayer:player):void= Logger.Print("Si è unito un nuovo giocatore, assegnazione a un team in corso") FortTeamCollection := GetPlayspace().GetTeamCollection() # Assegna il nuovo giocatore al team meno numeroso in modo asimmetrico. BalancePlayer(InPlayer) for: TeamIndex -> PlayerTeam:Teams PlayerTeam = FortTeamCollection.GetTeam[InPlayer]
7. Ottieni il teletrasporto associato al team del giocatore indicizzando l'array Teleporters con TeamIndex e memorizzandolo in una variabile TeamTeleporter. Memorizza la trasformazione di quel teletrasporto in una variabile Transform. Quindi, rigenera il nuovo giocatore nel teletrasporto iniziale del suo team.

    for:
        TeamIndex -> PlayerTeam:Teams
        PlayerTeam = FortTeamCollection.GetTeam[InPlayer]
        TeamTeleporter := Teleporters[TeamIndex]
        Transform := TeamTeleporter.GetTransform()
    do:
        InPlayer.Respawn(Transform.Translation, Transform.Rotation)
        Logger.Print("Il giocatore generato è stato teletrasportato nella sua posizione iniziale")
   Copy full snippet

   for: TeamIndex -> PlayerTeam:Teams PlayerTeam = FortTeamCollection.GetTeam[InPlayer] TeamTeleporter := Teleporters[TeamIndex] Transform := TeamTeleporter.GetTransform() do: InPlayer.Respawn(Transform.Translation, Transform.Rotation) Logger.Print("Il giocatore generato è stato teletrasportato nella sua posizione iniziale")
8. Infine, verifica se il giocatore appena che si è appena unito è un Infiltrato confrontando il suo team con l'opzione Infiltrators impostata in precedenza. Se risulta essere un Infiltrato, chiama OnInfiltratorJoined() dalla classe invisibility_manager sul nuovo giocatore per applicargli un effetto di sfarfallio. Il codice OnPlayerAdded() dovrebbe essere simile a seguente:

    # Gestisce un nuovo giocatore che si unisce al gioco.
    OnPlayerAdded(InPlayer:player):void=
        Logger.Print("Si è unito un nuovo giocatore, assegnazione a un team in corso")
        FortTeamCollection := GetPlayspace().GetTeamCollection()
           
        # Assegna il nuovo giocatore al team meno numeroso in modo asimmetrico.
        BalancePlayer(InPlayer)
   
        for:
            TeamIndex -> PlayerTeam:Teams
            PlayerTeam = FortTeamCollection.GetTeam[InPlayer]
            TeamTeleporter := Teleporters[TeamIndex]
            Transform := TeamTeleporter.GetTransform()
        do:
            InPlayer.Respawn(Transform.Translation, Transform.Rotation)
            Logger.Print("Il giocatore generato è stato teletrasportato nella sua posizione iniziale")
            # Se il giocatore era un infiltrato, chiama OnInfiltratorJoined in
            # InvisibilityManager.
            if(PlayerTeam = MaybeInfiltrators?):
                InvisibilityManager.OnInfiltratorJoined(InPlayer)
   Copy full snippet

   # Gestisce un nuovo giocatore che si unisce al gioco. OnPlayerAdded(InPlayer:player):void= Logger.Print("Si è unito un nuovo giocatore, assegnazione a un team in corso") FortTeamCollection := GetPlayspace().GetTeamCollection() # Assegna il nuovo giocatore al team meno numeroso in modo asimmetrico. BalancePlayer(InPlayer) for: TeamIndex -> PlayerTeam:Teams PlayerTeam = FortTeamCollection.GetTeam[InPlayer] TeamTeleporter := Teleporters[TeamIndex] Transform := TeamTeleporter.GetTransform() do: InPlayer.Respawn(Transform.Translation, Transform.Rotation) Logger.Print("Il giocatore generato è stato teletrasportato nella sua posizione iniziale") # Se il giocatore era un infiltrato, chiama OnInfiltratorJoined in # InvisibilityManager. if(PlayerTeam = MaybeInfiltrators?): InvisibilityManager.OnInfiltratorJoined(InPlayer)
9. Salva lo script, compilalo e fai clic su Avvia sessione nella barra degli strumenti UEFN per eseguire il playtest del livello. Quando esegui il playtest del tuo livello, i giocatori che si uniscono a una partita in corso dovrebbero ora unirsi al team corretto. Se il nuovo giocatore è un Infiltrato, dovrebbe generarsi invisibile ed essere soggetto a un effetto di sfarfallio quando subisce danni.

Passaggio successivo

Nel passaggio successivo di questo tutorial, imparerai come creare un indicatore visivo per un giocatore quando cattura un obiettivo.