7. Cómo equilibrar a los jugadores durante el juego

Cuando un nuevo jugador se une al juego, hay que equilibrarlo asimétricamente en el equipo adecuado. Si ese equipo son los infiltrados, también deben tener asociada una instancia de OnInfiltratorDamaged().

Sigue los pasos que se indican a continuación para aprender a equilibrar a los jugadores en el equipo correcto cuando se unen a la partida en curso.

Cómo configurar las funciones de incorporación de jugadores

1. Añade una nueva función, OnInfiltratorJoined() a la definición de la clase invisibility_manager. Esta función toma un agente y crea una instancia de OnInfiltratorDamaged() con el agente dado. Añade el especificador <public> a esta función, ya que la llamarás desde triad_infiltration_game.

    # Genera una función OnInfiltratorDamaged cuando un nuevo infiltrado se une al juego.
    OnInfiltratorJoined<public>(InAgent:agent):void=
        spawn{OnInfiltratorDamaged(InAgent)}
   Copy full snippet

   # Genera una función OnInfiltratorDamaged cuando un nuevo infiltrado se une al juego. OnInfiltratorJoined<public>(InAgent:agent):void= spawn{OnInfiltratorDamaged(InAgent)}
2. Añade una nueva función OnPlayerAdded() a la definición de la clase triad_infiltration_game. Esta función toma un jugador, lo equilibra en el equipo correcto y llama a OnInfiltratorJoined() si el nuevo jugador es un infiltrado.

    # Gestiona a un nuevo jugador que se une al juego.
    OnPlayerAdded(InPlayer:player):void=
   Copy full snippet

   # Gestiona a un nuevo jugador que se une al juego. OnPlayerAdded(InPlayer:player):void=
3. Obtén la fort_team_collection del espacio de juego actual y guárdala en una variable FortTeamCollection.

    # Gestiona a un nuevo jugador que se une al juego.
    OnPlayerAdded(InPlayer:player):void=
        Logger.Print("Se ha unido un nuevo jugador; asignándolo a un equipo")
        FortTeamCollection := GetPlayspace().GetTeamCollection()
   Copy full snippet

   # Gestiona a un nuevo jugador que se une al juego. OnPlayerAdded(InPlayer:player):void= Logger.Print("Se ha unido un nuevo jugador; asignándolo a un equipo") FortTeamCollection := GetPlayspace().GetTeamCollection()

   Cómo refactorizar el equilibrio de equipos

4. Necesitas equilibrar al nuevo jugador en el equipo correcto, pero si llamas a BalanceTeams() acabarás reorganizando a cada jugador en un nuevo equipo. En lugar de reescribir el código para encontrar el equipo más pequeño para el nuevo jugador y equilibrarlo en él, esta es una buena oportunidad para refactorizar.
   1. Añade un nuevo método BalancePlayer() a la definición de la clase triad_infiltration_game. Este método toma a un jugador y lo ubica asimétricamente de forma equilibrada en el equipo correcto.

       # Para cada jugador, se itera por la lista de equipos y se asignan al 
       # equipo con menos jugadores o al equipo inicial en caso de empate.
       BalancePlayer(InPlayer:player):void=
           Logger.Print("Empezando a equilibrar los jugadores.")
      Copy full snippet

      # Para cada jugador, se itera por la lista de equipos y se asignan al # equipo con menos jugadores o al equipo inicial en caso de empate. BalancePlayer(InPlayer:player):void= Logger.Print("Empezando a equilibrar los jugadores.")
   2. Extrae el código del bucle for de BalanceTeams() y colócalo dentro de BalancePlayer(), cambiando el nombre de TeamPlayer por InPlayer. Tu código BalancePlayer() debería ser como el siguiente:

       # Para cada jugador, se itera por la lista de equipos y se asignan al 
       # equipo con menos jugadores o al equipo inicial en caso de empate.
       BalancePlayer(InPlayer:player):void=
           Logger.Print("Empezando a equilibrar los jugadores.")
           var TeamToAssign:?team = false
           set TeamToAssign = FindTeamWithLargestDifference()
           if (AssignedTeam := TeamToAssign?, GetPlayspace().GetTeamCollection().AddToTeam[InPlayer, AssignedTeam]):
               Logger.Print("Intentando asignar un jugador recién unido a un nuevo equipo")
           else:
               Logger.Print("Este jugador ya estaba en el equipo más pequeño")
      Copy full snippet

      # Para cada jugador, se itera por la lista de equipos y se asignan al # equipo con menos jugadores o al equipo inicial en caso de empate. BalancePlayer(InPlayer:player):void= Logger.Print("Empezando a equilibrar los jugadores.") var TeamToAssign:?team = false set TeamToAssign = FindTeamWithLargestDifference() if (AssignedTeam := TeamToAssign?, GetPlayspace().GetTeamCollection().AddToTeam[InPlayer, AssignedTeam]): Logger.Print("Intentando asignar un jugador recién unido a un nuevo equipo") else: Logger.Print("Este jugador ya estaba en el equipo más pequeño")
   3. Ahora, en BalanceTeams(), añade una llamada a BalancePlayer() dentro del bucle for. Esto conserva la funcionalidad de BalanceTeams() al tiempo que te permite equilibrar a un jugador individualmente. Tu código BalanceTeams() debería tener el siguiente aspecto:

       # Equilibra a todos los jugadores de todos los equipos del juego.
       BalanceTeams():void=
           Logger.Print("Empezando a equilibrar los equipos")
           var AllPlayers:[]player := GetPlayspace().GetPlayers()
           set AllPlayers = Shuffle(AllPlayers)
           Logger.Print("La longitud de AllPlayers es {AllPlayers.Length}")
           for (TeamPlayer:AllPlayers):
               BalancePlayer(TeamPlayer)
      Copy full snippet

      # Equilibra a todos los jugadores de todos los equipos del juego. BalanceTeams():void= Logger.Print("Empezando a equilibrar los equipos") var AllPlayers:[]player := GetPlayspace().GetPlayers() set AllPlayers = Shuffle(AllPlayers) Logger.Print("La longitud de AllPlayers es {AllPlayers.Length}") for (TeamPlayer:AllPlayers): BalancePlayer(TeamPlayer)
5. En OnPlayerAdded(), añade una llamada a BalancePlayer() pasando al jugador que se acaba de unir.

    # Gestiona a un nuevo jugador que se une al juego.
    OnPlayerAdded(InPlayer:player):void=
        Logger.Print("Se ha unido un nuevo jugador; asignándolo a un equipo")
        FortTeamCollection := GetPlayspace().GetTeamCollection()
        set AllPlayers = GetPlayspace().GetPlayers()
        # Asigna al nuevo jugador al equipo más pequeño
        BalancePlayer(InPlayer)
   Copy full snippet

   # Gestiona a un nuevo jugador que se une al juego. OnPlayerAdded(InPlayer:player):void= Logger.Print("Se ha unido un nuevo jugador; asignándolo a un equipo") FortTeamCollection := GetPlayspace().GetTeamCollection() set AllPlayers = GetPlayspace().GetPlayers() # Asigna al nuevo jugador al equipo más pequeño BalancePlayer(InPlayer)
6. Encuentra el índice del equipo del jugador después de equilibrar al iterar cada equipo en la matriz Teams y usar GetTeam[] como filtro para comprobar que es igual a PlayerTeam.

     # Gestiona a un nuevo jugador que se une al juego.
    OnPlayerAdded(InPlayer:player):void=
        Logger.Print("Se ha unido un nuevo jugador; asignándolo a un equipo")
        FortTeamCollection := GetPlayspace().GetTeamCollection()
           
        # Asigna al nuevo jugador al equipo más pequeño, de forma asimétrica.
        BalancePlayer(InPlayer)
   
        for:
            TeamIndex -> PlayerTeam:Teams
            PlayerTeam = FortTeamCollection.GetTeam[InPlayer]
   Copy full snippet

   # Gestiona a un nuevo jugador que se une al juego. OnPlayerAdded(InPlayer:player):void= Logger.Print("Se ha unido un nuevo jugador; asignándolo a un equipo") FortTeamCollection := GetPlayspace().GetTeamCollection() # Asigna al nuevo jugador al equipo más pequeño, de forma asimétrica. BalancePlayer(InPlayer) for: TeamIndex -> PlayerTeam:Teams PlayerTeam = FortTeamCollection.GetTeam[InPlayer]
7. Obtén el teletransportador asociado al equipo del jugador al indexar en la matriz Teleporters mediante TeamIndex y almacenarlo en una variable TeamTeleporter. Guarda la transformación de ese teletransportador en una variable Transform. A continuación, vuelve a situar al nuevo jugador en el teletransportador inicial de su equipo.

    for:
        TeamIndex -> PlayerTeam:Teams
        PlayerTeam = FortTeamCollection.GetTeam[InPlayer]
        TeamTeleporter := Teleporters[TeamIndex]
        Transform := TeamTeleporter.GetTransform()
    do:
        InPlayer.Respawn(Transform.Translation, Transform.Rotation)
        Logger.Print("Se ha teletransportado al jugador que ha aparecido a su ubicación inicial.")
   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("Se ha teletransportado al jugador que ha aparecido a su ubicación inicial.")
8. Por último, comprueba si el jugador que se acaba de unir es un infiltrado comparando su equipo con la opción Infiltrators que configuraste anteriormente. Si lo están, llama a OnInfiltratorJoined() de la clase invisibility_manager en el nuevo jugador para que empiece a parpadear. Tu código OnPlayerAdded() debería tener el siguiente aspecto:

    # Gestiona a un nuevo jugador que se une al juego.
    OnPlayerAdded(InPlayer:player):void=
        Logger.Print("Se ha unido un nuevo jugador; asignándolo a un equipo")
        FortTeamCollection := GetPlayspace().GetTeamCollection()
           
        # Asigna al nuevo jugador al equipo más pequeño, de forma asimétrica.
        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("Se ha teletransportado al jugador que ha aparecido a su ubicación inicial.")
            # Si el jugador era un infiltrado, se llama a OnInfiltratorJoined en
            # InvisibilityManager.
            if(PlayerTeam = MaybeInfiltrators?):
                InvisibilityManager.OnInfiltratorJoined(InPlayer)
   Copy full snippet

   # Gestiona a un nuevo jugador que se une al juego. OnPlayerAdded(InPlayer:player):void= Logger.Print("Se ha unido un nuevo jugador; asignándolo a un equipo") FortTeamCollection := GetPlayspace().GetTeamCollection() # Asigna al nuevo jugador al equipo más pequeño, de forma asimétrica. 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("Se ha teletransportado al jugador que ha aparecido a su ubicación inicial.") # Si el jugador era un infiltrado, se llama a OnInfiltratorJoined en # InvisibilityManager. if(PlayerTeam = MaybeInfiltrators?): InvisibilityManager.OnInfiltratorJoined(InPlayer)
9. Guarda la secuencia de comandos, compílala y haz clic en Abrir sesión en la barra de herramientas de UEFN para poner a prueba el nivel. Cuando pruebes tu nivel, los jugadores deben unirse al equipo correcto cuando se unan a una partida en curso. Si ese jugador es un infiltrado, debería aparecer invisible y parpadear al recibir daño.

Siguiente paso

En el siguiente paso de este tutorial, aprenderás a crear un indicador visual para un jugador cuando captura un objetivo.