El servicio `Class.Players` contiene objetos `Class.Player` para clientes conectados actualmente a un servidor de Roblox.También contiene información sobre la configuración de un lugar.Puede recuperar información sobre jugadores que no están conectados al servidor, como apariencias de personajes, amigos y una miniatura de avatar.

This example will print "A player has entered: " followed by the name of the
player that enters/joins a game every time a player joins.

Este evento se activa cuando un jugador entra al juego.Se usa para disparar un evento cuando un jugador se une a un juego, como cargar los datos guardados del jugador `Class.GlobalDataStore`.

  Esto se puede usar junto con el evento `Class.Players.PlayerRemoving`, que se activa cuando un jugador está a punto de abandonar el juego.Por instancia, si desea imprimir un mensaje cada vez que se una o se salga un nuevo jugador del juego:

  ```lua
  local Players = game:GetService("Players")

  Players.PlayerAdded:Connect(function(player)
  	print(player.Name .. " joined the game!")
  end)

  Players.PlayerRemoving:Connect(function(player)
  	print(player.Name .. " left the game!")
  end)
  ```

  Si quieres rastrear cuando se agrega o elimina el personaje de un jugador del juego, como cuando un jugador reaparece o muere, puedes usar las funciones `Class.Player.CharacterAdded` y `Class.Player.CharacterRemoving`.

  Tenga en cuenta que este evento no funciona como se esperaba en **modo de juego** porque el jugador se crea antes de que se ejecuten los scripts que se conectan a `Class.Players.PlayerAdded|PlayerAdded` .Para manejar este caso, así como casos en los que se agrega el script al juego después de que un jugador entre, crea una función `onPlayerAdded()` que puedes llamar para manejar la entrada de un jugador.

Players.PlayerAdded

player

Una instancia del jugador que se unió al juego.

Se enciende cuando un jugador entra al juego.

The function in the code sample runs after the game server confirms a player's
membership has changed. It demonstrates how you can grant players access to
Premium benefits (or revoke them) when their membership status changes.

Este evento se activa cuando el servidor del juego reconoce que la membresía de un jugador ha cambiado.Tenga en cuenta, sin embargo, que el servidor solo intentará verificar y actualizar la membresía **después de que se haya cerrado el modo Premium** .Por lo tanto, para cubrir los casos en que el usuario compra Premium **fuera** del juego mientras juega, aún debe solicitarles que compren Premium; esto mostrará un mensaje que les indique que ya están actualizados y, una vez que cierren la ventana modal, el servidor del juego actualizará su membresía y desencadenará este evento.

  Para aprender más sobre y incorporar Premium a tu experiencia y monetizar con el sistema de pagos basado en el compromiso, ve a [Pagos basados en el compromiso](/production/monetization/engagement-based-payouts).

  Vea también:

  *   `Class.MarketplaceService:PromptPremiumPurchase()` , se usa para solicitar a un usuario que compre Premium
  *   `Class.MarketplaceService.PromptPremiumPurchaseFinished` , se activa cuando la interfaz de usuario de compra premium se cierra

Players.PlayerMembershipChanged

Se activa cuando el servidor del juego reconoce que la membresía de un jugador ha cambiado.

This code will print "A player has left: ", followed by the player's name,
every time a player leaves:

El evento Eliminación de jugadores se activa justo antes de que `Class.Player` salga del juego.Este evento se activa antes de que `Class.Instance.ChildRemoved|ChildRemoved` haga en `Class.Players` , y se comporta de manera algo similar a `Class.Instance.DescendantRemoving` .Dado que se activa antes de la eliminación real de un `Class.Player` , este evento es útil para almacenar datos del jugador usando un `Class.GlobalDataStore` .

  Esto se puede usar junto con el evento `Class.Player.PlayerAdded`, que se activa cuando un jugador se une al juego.Por instancia, para imprimir un mensaje cada vez que un nuevo jugador se una o abandone el juego:

  ```lua
  local Players = game:GetService("Players")

  Players.PlayerAdded:Connect(function(player)
  	print(player.Name .. " joined the game!")
  end)

  Players.PlayerRemoving:Connect(function(player)
  	print(player.Name .. " left the game!")
  end)
  ```

  Si quieres rastrear cuando se agrega o elimina el personaje de un jugador del juego, como cuando un jugador reaparece o muere, puedes usar las funciones `Class.Player.CharacterAdded` y `Class.Player.CharacterRemoving`.

Players.PlayerRemoving

Una instancia del jugador que está dejando el juego.

Se activa cuando un jugador está a punto de abandonar el juego.

Este evento se activa cuando el servidor del juego reconoce que el estado del usuario para una determinada suscripción ha cambiado.Tenga en cuenta que el servidor solo intenta verificar y actualizar el estado **después de que se haya cerrado el modo de compra de suscripción** .Para contar los casos en los que el usuario compra la suscripción **fuera** del juego mientras juega, aún debe solicitarles que compren la suscripción; el mensaje les muestra un mensaje que les dice al usuario que ya está suscrito, y después de que cierren la ventana modal, el servidor del juego actualiza el estado de la suscripción y activa este evento.

  Tenga en cuenta que solo los scripts del servidor reciben este evento.

Players.UserSubscriptionStatusChanged

user

Usuario cuyo estado de suscripción ha cambiado.

subscriptionId

El ID de la suscripción con un cambio de estado.

Se activa cuando el servidor del juego reconoce que el estado del usuario para una determinada suscripción ha cambiado.

This example demonstrates that the `Class.Players:Chat()` function executes
without error if using the Command Bar or a Plugin (assuming the local player
can chat freely) and errors if executed in a `Script`.

Esta función hace que el jugador local chatee con el mensaje dado.Dado que este artículo está protegido, intentar usarlo en un `Class.Script` o `Class.LocalScript` causará un error.

  En cambio, al crear un sistema de chat personalizado o un sistema que necesita acceso al chat, puedes usar la función `Class.Chat` del servicio `Class.Chat:Chat()` en lugar.

Players:Chat

message

Hace que el jugador local chatee con el mensaje dado.

Esta función busca cada `Class.Player` en `Class.Players` para uno cuyo `Class.Player.UserId` coincida con el dado `userId`.Si tal jugador no existe, devuelve `nil` .

  Este método es útil para encontrar al comprador de un producto de desarrollador usando `Class.MarketplaceService.ProcessReceipt` que proporciona una tabla que incluye al comprador de `Class.Player.UserId|UserId` y no una referencia al objeto `Class.Player` en sí.La mayoría de las experiencias requerirán una referencia al jugador para otorgar productos.

Players:GetPlayerByUserId

userId

El `Class.Player.UserId` de jugador que se especifica.

Devuelve el `Class.Player` con el dado `Class.Player.UserId|UserId` si están en el juego.

Esta función devuelve el `Class.Player` asociado con el dado `Class.Player.Character` o `nil` si no se puede encontrar uno.Es equivalente a la siguiente función:

  ```lua
  local function getPlayerFromCharacter(character)
  	for _, player in game:GetService("Players"):GetPlayers() do
  		if player.Character == character then
  			return player
  		end
  	end
  end
  ```

  Este método se usa a menudo cuando se activa algún evento en el personaje del jugador (como su `Class.Humanoid``Class.Humanoid.Died|dying` ).Un evento como ese puede no hacer referencia directamente al objeto Jugador, pero este método proporciona un acceso fácil.El inverso de esta función se puede describir como obtener el personaje de un jugador.Para hacer esto, simplemente acceda a la propiedad de Personaje.

Players:GetPlayerFromCharacter

character

Una instancia de personaje de la que quieres obtener al jugador.

Devuelve el `Class.Player` cuyo `Class.Player.Character` coincide con la instancia dada, o `nil` si no se puede encontrar uno.

Esta lista de muestras de código escucha a los jugadores que se generan y les da destellos en la cabeza.Lo hace definiendo dos funciones, `onPlayerSpawned` y `onPlayerAdded`.

Este método devuelve una tabla de todos los objetos `Class.Player` conectados actualmente.Funciona de la misma manera que `Class.Instance:GetChildren()` excepto que solo devuelve objetos `Class.Player` encontrados bajo `Class.Players` .Cuando se usa con un bucle `for`, es útil para iterar sobre todos los jugadores en un juego.

  ```lua
  local Players = game:GetService("Players")

  for _, player in Players:GetPlayers() do
  	print(player.Name)
  end
  ```

  Los scripts que se conectan a `Class.Players.PlayerAdded` a menudo intentan procesar a todos los jugadores que se conectan al juego.Este método es útil para iterar sobre jugadores ya conectados que no dispararían `Class.Players.PlayerAdded|PlayerAdded` .¡Usar este método garantiza que ningún jugador se pierda!

  ```lua
  local Players = game:GetService("Players")

  local function onPlayerAdded(player)
  	print("Player: " .. player.Name)
  end

  for _, player in Players:GetPlayers() do
  	onPlayerAdded(player)
  end
  Players.PlayerAdded:Connect(onPlayerAdded)
  ```

Players:GetPlayers

Una tabla que contiene a todos los jugadores en el servidor.

Devuelve una tabla de todos los objetos conectados actualmente `Class.Player` objetos.

Este ejemplo demuestra que la función `Class.Players:SetChatStyle()` ejecuta sin error si usa la barra de comandos o un plugin y errores si se ejecuta en un `LocalScript`.

  Cuando se ejecuta en la barra de comandos, este código establece el estilo de chat en Clásico usando el enum `Enum.ChatStyle`.

Esta función establece si se están usando BubbleChat y ClassicChat, y le dice a TeamChat y Chat qué hacer usando el enum `Enum.ChatStyle`.Dado que este artículo está protegido, intentar usarlo en un `Class.Script` o `Class.LocalScript` causará un error.

  Esta función se usa internamente cuando el modo de chat se establece por el juego.

Players:SetChatStyle

style

Se establece el estilo de chat establecer.

Establece si se usan BubbleChat y ClassicChat, y le dice a TeamChat y `Class.Chat` qué hacer.

Este ejemplo demuestra que la función `Class.Players:TeamChat()` ejecuta sin error si usa la barra de comandos o un plugin y errores si se ejecuta en un `LocalScript`.

  Cuando se ejecuta en la barra de comandos, la función envía el mensaje especificado a todos los jugadores en el mismo `Team` que el `Class.Players.LocalPlayer`.

Esta función hace que el `Class.Players.LocalPlayer` chat muestre el mensaje dado, que solo será visible para los usuarios del mismo equipo.Dado que este artículo está protegido, intentar usarlo en un `Class.Script` o `Class.LocalScript` causará un error.

  Esta función se usa internamente cuando el `Class.Players.LocalPlayer` envía un mensaje a su equipo.

Players:TeamChat

Hace que el jugador local chatee el mensaje dado, que solo será visible para los usuarios del mismo equipo.

Players:getPlayers

Players:playerFromCharacter

Esta función se utilizó una vez para devolver una lista de jugadores en un juego, pero desde entonces se ha obsoleto a favor de `Class.Players:GetPlayers()`

Players:players

Devuelve una lista de jugadores en un juego.

The following example bans a user with a duration calculated from their ban history, scoped to the entire universe and all of the user's alternate accounts.

El método `Class.Players:BanAsync()` te permite banear fácilmente a los usuarios que violan las directrices de tu experiencia.Puedes especificar la duración del ban, habilitar el ban para propagarse a cuentas alternativas sospechosas y proporcionar un mensaje al usuario baneado de acuerdo con las [directrices de uso](/players#banning-users).También deberías publicar tus reglas de experiencia en algún lugar accesible para todos los usuarios y proporcionar una manera de apelar.Este método está habilitado y deshabilitado por la propiedad `Class.Players.BanningEnabled`, que puedes alternar en Studio.

  ##### Prohibición y mensajería

  Los usuarios prohibidos serán expulsados inmediatamente y se les impedirá volver a unirse a sus experiencias.Se les presentará un error que muestra el tiempo restante en su prohibición y tu `DisplayReason` .Los sistemas de backend de Roblox expulsarán a los jugadores de todos los servidores desde el lugar (s) que especifiques.`DisplayReason` puede tener una longitud máxima de 400 caracteres y está sujeto a un filtro de texto.Para obtener más información sobre el texto modal aceptable, vea [mensajes de prohibición](/players#message-guidelines).

  ##### Lugares y universo

  Por defecto, las prohibiciones se extienden a cualquier lugar dentro de ese universo.Para limitar el ban a sólo el lugar desde el que se llama esta API, configura `ApplyToUniverse` a `false` .Sin embargo, si un usuario es prohibido en el lugar de inicio del universo, efectivamente resulta en que el usuario sea excluido de la totalidad del universo, independientemente de si existe una prohibición universal o no.

  ##### Cuentas alternativas

  Los usuarios a menudo juegan bajo múltiples cuentas diferentes, conocidas como cuentas alternativas o cuentas alt, que a veces se usan para evadir las prohibiciones de cuentas.Para ayudarlo a mantener a los usuarios prohibidos fuera, el comportamiento predeterminado de esta API propagará todos los baneos desde la cuenta de origen que prohibió a cualquiera de sus cuentas alternativas sospechosas.Puedes desactivar las propagaciones de prohibición a cuentas alternativas configurando `ExcludeAltAccounts` a `true`.

  ##### Duración del ban

  No todas las transgresiones son iguales, por lo que no todas las prohibiciones deben tener la misma longitud.Esta API te permite configurar la duración del expulsar, en segundos, con el campo `Duration`.Para especificar una expulsarpermanente, establece el campo en `-1` .También puede querer configurar dinámicamente la duración del ban en función del historial de prohibiciones del usuario, que puede consultar usando `Class.Players:GetBanHistoryAsync()`.Por ejemplo, es posible que desees considerar el número de prohibiciones, la duración de las prohibiciones anteriores o construir lógica a partir de las notas que guardas bajo `PrivateReason` que pueden tener hasta 1000 caracteres y no se filtran textualmente. `PrivateReason` las notas nunca se comparten con el cliente y se pueden considerar seguras de los atacantes.

  ##### Errores y aceleración

  Este método invoca una llamada HTTP a los servicios de backend que están sujetos a un aceleramiento y pueden fallar.Si está llamando a esta API con más de una `Class.Player.UserId|UserId`, este método intentará realizar la llamada HTTP para cada ID.A continuación, agregará cualquier mensaje de error y los unirá como una lista separada por comas.Por ejemplo, si se invoca este método para cinco usuarios y las solicitudes para aquellos con `Class.Player.UserId|UserIds` 2 y 4 fallan, aparece el siguiente mensaje de error:

  `HTTP failure for UserId 2: Timedout, HTTP 504 (Service unavailable) failure for UserId 4: Service exception`

  El mensaje siempre incluirá `failure for UserId {}` si es un error HTTP.

  ##### Requisito del lado del cliente

  Debido a los riesgos asociados con la prohibición de usuarios, este método solo se puede llamar en el servidor de experiencia en la parte trasera (las llamadas del lado del cliente darán como resultado un error).Puedes probar esta API en Studio, durante la creaciones[colaborativa](/projects/collaboration) o en una prueba [en equipo](/studio/testing-modes#collaborative-testing) , pero las prohibiciones no se aplicarán a la producción

  Esta API utiliza la [API de nube abierta de restricciones de usuario](/cloud/reference/UserRestriction). Podrás utilizar estas APIs para gestionar tus prohibiciones en aplicaciones de terceros.

Players:BanAsync

config

*   `UserIds` (requerido; matriz/lista) — Array de `Class.Player.UserId|UserIds` de jugadores a ser prohibidos. El tamaño máximo es `50` .

  *   `ApplyToUniverse` (opcional; booleano) — Si el ban se propaga a todos los lugares dentro del universo de experiencia. El predeterminado es `true` .

  *   `Duration` (requerido; entero) — Duración del expulsar, en segundos.Las prohibiciones permanentes deberían tener un valor de `-1` .`0` y todos los demás valores negativos son no válido.

  *   `DisplayReason` (requerido; cadena) — El mensaje que se mostrará a los usuarios cuando intenten unirse y fallen en una experiencia.La longitud máxima de la cadena es `400` .

  *   `PrivateReason` (requerido; cadena) — Mensajería interna que se devolverá al consultar el historial de prohibición del usuario. La longitud máxima de la cadena es `1000` .

  *   `ExcludeAltAccounts` (opcional; booleano) — Cuando `true` , Roblox no intenta prohibir las cuentas alternativas. El predeterminado es `false` .

Prohíbe a los usuarios de tu experiencia, con opciones para especificar la duración, la razón, si la prohibición se aplica a todo el universo o solo al lugar actual, y más.Este método está habilitado y deshabilitado por la propiedad `Class.Players.BanningEnabled`, que puedes alternar en Studio.

This code sample creates a Humanoid Model from the passed in
HumanoidDescription and parents the Model to the Workspace.

Devuelve un modelo de personaje equipado con todo lo especificado en la Descripción Humanoide pasada, y es R6 o R15 como se especifica por el tipo de rig.

Players:CreateHumanoidModelFromDescription

description

Specifica la apariencia del personaje devuelto.

rigType

Specifica si el personaje devuelto será R6 o R15.

assetTypeVerification

La verificación del tipo de activo determina si esta función cargará modelos o no (Debe establecer esto en Siempre a menos que desee cargar activos no catalogados).

This code sample creates a Humanoid Model to match the avatar of the passed in
User ID, and parents the Model to the Workspace.

Devuelve un conjunto de configuración de modelo de personaje con todo lo equipado para coincidir con el avatar del usuario especificado por el ID pasado.Esto incluye si ese personaje es actualmente R6 o R15.

Players:CreateHumanoidModelFromUserId

El ID de usuario para un usuario de Roblox. (El ID de usuario es el número en el perfil del usuario, por ejemplo www.roblox.com/usuarios/1/perfil).

Devuelve un conjunto de configuración de modelo de personaje con todo lo equipado para coincidir con el avatar del usuario especificado por el ID pasado.

Recupera el historial de prohibición y desban de cualquier usuario dentro del universo de la experiencia.Este método devuelve una instancia `Class.BanHistoryPages` que hereda de `Class.Pages`.Este método está habilitado y deshabilitado por la propiedad `Class.Players.BanningEnabled`, que puedes alternar en Studio.

  Esta llamada de función solo tendrá éxito en servidores de juegos de producción y no en dispositivos clientes o en Studio.

  Esta API utiliza la [API de nube abierta de restricciones de usuario](/cloud/reference/UserRestriction). Podrás utilizar estas APIs para gestionar tus prohibiciones en aplicaciones de terceros.

Players:GetBanHistoryAsync

Vea `Class.BanHistoryPages` para la referencia de devolución.

Recupera el historial de prohibición y desban de cualquier usuario dentro del universo de la experiencia.Este método está habilitado y deshabilitado por la propiedad `Class.Players.BanningEnabled`, que puedes alternar en Studio.

This example demonstrates how to retrieve a character's appearance.

The returned `Model` is not a child of Workspace by default. If you want the
model to be visible, its `Class.Instance.Parent|parent` property must be set.

Esta función devuelve un `Class.Model` que contiene los activos que lleva el jugador, excluyendo el equipamiento.

  Si prefiere una tabla de información de Luau sobre estos activos en lugar de un aplicación de modelado, use `Class.Players:GetCharacterAppearanceInfoAsync()` .

  Este método se comporta de manera similar a `Class.InsertService:LoadAsset()` , y es como usar `Class.InsertService:LoadAsset()|LoadAsset` en la información de activos devuelta por `Class.Players:GetCharacterAppearanceInfoAsync()` excepto más rápido.

Players:GetCharacterAppearanceAsync

El `Class.Player.UserId` de jugador especificado.

Devuelve un `Class.Model` que contiene los activos que el jugador está usando, excluyendo el equipamiento.

Sometimes it is best to see an example of the returned dictionary structure in
pure Lua. Here is one such example of a player whose avatar uses a package and
wears several hats. Can you guess who it is?

Esta función devuelve información sobre el avatar de un jugador (ignorando el equipamiento) en el sitio web de Roblox en forma de diccionario.No debe confundirse con `Class.Players:GetCharacterAppearanceAsync()|GetCharacterAppearanceAsync`, que en realidad carga los recursos descritos por este método.Puedes usar `Class.InsertService:LoadAsset()` para cargar los recursos que se usan en el avatar del jugador.La estructura del diccionario devuelto es la siguiente:

  <table>
    <thead>
      <tr>
        <th>Nombre</th>

        <th>Tipo</th>

        <th>Descripción</th>
      </tr>
    </thead>

    <tr>
      <td><code>activos</code></td>

      <td>tabla (ver a continuación)</td>

      <td>Describe los activos equipados (sombreros, partes del cuerpo, etc)</td>
    </tr>

    <tr>
      <td><code>colores del cuerpo</code></td>

      <td>tabla (ver a continuación)</td>

      <td>Describe los valores de BrickColor para cada miembro</td>
    </tr>

    <tr>
      <td><code>color del cuerpo3s</code></td>

      <td>tabla (ver a continuación)</td>

      <td>Describe la instancia Color3 para cada extremidad que puede no coincidir perfectamente con los colores del cuerpo</td>
    </tr>

    <tr>
      <td><code>pantalones predeterminados aplicados</code></td>

      <td>bool</td>

      <td>Describe si se aplican los pantalones predeterminados</td>
    </tr>

    <tr>
      <td><code>camisa predeterminada aplicada</code></td>

      <td>bool</td>

      <td>Describe si se aplica la camisa predeterminada</td>
    </tr>

    <tr>
      <td><code>emoticonos</code></td>

      <td>tabla (ver a continuación)</td>

      <td>Describe las animaciones de emote equipadas</td>
    </tr>

    <tr>
      <td><code>tipo de avatar de jugador</code></td>

      <td>cadena</td>

      <td>O bien "R15" o "R6"</td>
    </tr>

    <tr>
      <td><code>escalas</code></td>

      <td>tabla (ver a continuación)</td>

      <td>Describe varios factores de escalado de cuerpo</td>
    </tr>
  </table>

  ##### Subtabla de activos

  La tabla `assets` es un array de tablas que contiene las siguientes claves que describen los activos actualmente equipados por el jugador:

  <table>
    <thead>
      <tr>
        <th>Nombre</th>

        <th>Tipo</th>

        <th>Descripción</th>
      </tr>
    </thead>

    <tr>
      <td><code>id</code></td>

      <td>número</td>

      <td>La identificación del activo del recurso</td>
    </tr>

    <tr>
      <td><code>tipo de activo</code></td>

      <td>tabla</td>

      <td>Una tabla con los campos <code>nombre</code> y <code>ID</code>, cada uno describiendo el tipo de activo equipado ("Sombrero", "Cara", etc.)</td>
    </tr>

    <tr>
      <td><code>nombre</code></td>

      <td>cadena</td>

      <td>El nombre del activo recurso</td>
    </tr>
  </table>

  ##### Subtabla de escalas

  La tabla `scales` tiene las siguientes claves, cada una de ellas es un número que corresponde a una propiedad de escalado `Class.Humanoid` : `bodyType` , `head` , `height` , `proportion` , `depth` , `width` .

  ##### Subtabla de colores del cuerpo

  La tabla `bodyColors` tiene las siguientes claves, cada una de ellas es un número que corresponde a un número de ID `Datatype.BrickColor` que se puede utilizar con `Datatype.BrickColor.new(id)` : `leftArmColorId` , `torsoColorId` , `rightArmColorId` , `headColorId` , `leftLegColorId` , `rightLegColorId` .

Players:GetCharacterAppearanceInfoAsync

El \* *identificador de usuario* del jugador especificado.

Un diccionario que contiene información sobre la apariencia del personaje de un usuario dado.

Devuelve información sobre la apariencia del personaje de un usuario dado.

This code sample loads the `Class.Player.UserId` of the player whose username
is provided at the top of the script by using
`Class.Players:GetUserIdFromNameAsync()`. Then, it gets a `FriendPages` object
by calling `Class.Players:GetFriendsAsync()` and iterates over each entry
using the `iterPageItems` function. The username of each connection is stored in a
table, then printed at the end.

La función GetFriends `Class.Players` devuelve un objeto `Class.FriendPages` que contiene información para todos los amigos del usuario dado.Los elementos dentro del objeto `Class.FriendPages` son tablas con los siguientes campos:

  <table>
    <thead>
      <tr>
        <th>Nombre</th>

        <th>Tipo</th>

        <th>Descripción</th>
      </tr>
    </thead>

    <tr>
      <td>Id</td>

      <td>longitud int64</td>

      <td>El ID de usuario del amistad</td>
    </tr>

    <tr>
      <td>Nombre de usuario</td>

      <td>cadena</td>

      <td>El nombre de usuario del amistad</td>
    </tr>

    <tr>
      <td>Nombre de visualización</td>

      <td>cadena</td>

      <td>El <code>Class.Player.DisplayName|nombre de visualización</code> del amistad.</td>
    </tr>
  </table>

  Vea los ejemplos de código para una manera fácil de iterar sobre todos los amigos de un jugador.

Players:GetFriendsAsync

La ID de usuario del jugador que se especifica.

Devuelve un objeto `Class.FriendPages` que contiene información para todos los amigos del jugador dado.

Shows how to get the HumanoidDescription for bundle 799 (Fishman).

Devuelve la descripción humanoide para un ID de atuendo especificado, que se configurará con las partes/colores/animaciones etc del atuendo.Un traje puede ser uno creado por un usuario, o puede ser el traje para un paquete creado por Roblox.

Players:GetHumanoidDescriptionFromOutfitId

outfitId

El ID del atuendo para el cual se busca la descripción humanoide.

Descripción humanoide inicializada con la especificación para el ID de atuendo pasado.

Devuelve la descripción humanoide para un atuendo específico, que se configurará con las partes/colores/animaciones etc del atuendo.

This code sample shows how to use GetHumanoidDescriptionFromUserId() to create
a Humanoid Model.

Devuelve una descripción humanoide que especifica todo lo equipado para el avatar del usuario especificado por el ID pasado en.También incluye escalas y colores de cuerpo.

Players:GetHumanoidDescriptionFromUserId

Descripción humanoide inicializada con la especificación de avatar del usuario pasada.

Devuelve una descripción humanoide que especifica todo lo equipado para el avatar del usuario especificado por el ID pasado en.

This code sample demonstrates using the
`Class.Players:GetNameFromUserIdAsync()` method to get a user's
`Class.Player.Name` from their `Class.Player.UserId`.

This code sample demonstrates using the
`Class.Players:GetNameFromUserIdAsync()` method to get a user's
`Class.Player.Name` from their `Class.Player.UserId`. Because
`Class.Players:GetNameFromUserIdAsync()|GetNameFromUserIdAsync()` yields, you
can avoid calling it for the same `Class.Player.Name|Name` using a table to
store each `UserId`:`Name` pair found, called a `cache`.
`Global.LuaGlobals.pcall()` is used to catch the failure in case the `Name`
doesn't exist.

La función GetNameFromUserIdAsync `Class.Players` enviará una consulta al sitio web de Roblox para preguntar cuál es el nombre de usuario de la cuenta con el dado `Class.Player.UserId|UserId`.

  Este método falla si no existe una cuenta con el ID de usuario dado.Si no estás seguro de que exista una cuenta así, se recomienda envolver las llamadas a esta función con `Global.LuaGlobals.pcall()` .Además, puedes almacenar manualmente los resultados en caché para hacer futuras llamadas con el mismo UserId rápidamente.Vea los ejemplos de código para aprender más.

Players:GetNameFromUserIdAsync

El nombre de un usuario con el nombre especificado `Class.Player.UserId`.

Envía una consulta al sitio web de Roblox para el nombre de usuario de una cuenta con un dado `Class.Player.UserId|UserId` .

This code sample demonstrates using the
`Class.Players:GetUserIdFromNameAsync()` method to get a user's
`Class.Player.UserId` from their `Class.Player.Name`.

This code sample demonstrates using the
`Class.Players:GetUserIdFromNameAsync()` method to get a user's
`Class.Player.UserId` from their `Class.Player.Name`. Because
`Class.Players:GetUserIdFromNameAsync()|GetUserIdFromNameAsync()` yields, you
can avoid calling it for the same `Class.Player.UserId|UserId` using a table
to store each `Name`:`UserId` pair found, called a `cache`.
`Global.LuaGlobals.pcall()` is used to catch the failure in case the `UserId`
doesn't exist.

Esta función enviará una consulta al sitio web de Roblox preguntando qué es el `Class.Player.UserId` de la cuenta con el nombre dado `Class.Player`.

  Este método falla si no existe una cuenta con el nombre de usuario dado.Si no estás seguro de que exista una cuenta así, se recomienda envolver las llamadas a esta función con `Global.LuaGlobals.pcall()` .Además, puedes almacenar manualmente los resultados para hacer rápidamente llamadas futuras con el mismo nombre de usuario.Vea los ejemplos de código para aprender más.

Players:GetUserIdFromNameAsync

userName

El nombre de usuario del jugador que se especifica.

El `Class.Player.UserId` de un usuario cuyo nombre se especifica.

Envía una consulta al sitio web de Roblox por el `Class.Player.UserId|userId` de una cuenta con un nombre de usuario dado.

This code sample displays the current player's thumbnail in a parent
`ImageLabel` by using `Class.Players:GetUserThumbnailAsync()` and setting the
`Class.ImageLabel.Image|Image()` property as well as its
`Class.GuiObject.Size|Size()`.

Esta función devuelve la URL del contenido de una imagen del avatar de un jugador dada su `Class.Player.UserId|UserId` , el tamaño de imagen deseado como un enum `Enum.ThumbnailSize` , y el tipo deseado como un enum `Enum.ThumbnailType`.También devuelve un booleano que describe si la imagen está lista para usar.

  Con más frecuencia, este método se usa con `Class.ImageLabel.Image` o `Class.Decal.Texture` para mostrar imágenes de avatares de usuario en una experiencia.

Players:GetUserThumbnailAsync

thumbnailType

Un `Enum.ThumbnailType` describiendo el tipo de miniatura.

thumbnailSize

Un `Enum.ThumbnailSize` especificando el tamaño de la miniatura.

Un túnel que contiene la URL del contenido de una miniatura de usuario basada en los parámetros especificados y un bool que describe si la imagen está lista para usarse o no.

Devuelve la URL del contenido de una miniatura de jugador dada el tamaño y el introducir, así como un booleano que describe si la imagen está lista para usar.

The following un-bans a user, as well as another unrelated account with UserId 789.

Desbanea a los jugadores prohibidos de `Class.Players:BanAsync()` o la [API de nube abierta de restricciones de usuario](/cloud/reference/UserRestriction).Este método está habilitado y deshabilitado por la propiedad `Class.Players.BanningEnabled`, que puedes alternar en Studio.

  Como `Class.Players:BanAsync()` , este método toma un diccionario `config` que te permitirá desbanear masivamente a los usuarios.Esto configura a los usuarios que están desbaneados y el alcance desde el cual están desbaneados.

  Las desbaneadas solo tendrán efecto en las prohibiciones con el mismo alcance `ApplyToUniverse`.Por ejemplo, un desban con `ApplyToUniverse` establecido a `true` no invalidará un ban anterior con `ApplyToUniverse` establecido a `false` .En otras palabras, un desban de nivel de universo no invalidará un expulsarde nivel de lugar.Lo contrario también es cierto.

  Este método invoca una llamada HTTP a los servicios de backend, que se ven limitados y pueden fallar.Si está llamando a esta API con múltiples UserIds, este método intentará realizar esta llamada HTTP para cada UserId.A continuación, agregará cualquier mensaje de error y los unirá como una lista separada por comas.Por ejemplo, si este método se invoca para cinco `UserIds` : `{1, 2, 3, 4, 5}` y solicitudes para usuarios 2 y 4 fallan, entonces aparece el siguiente mensaje de error: `HTTP failure for UserId 2: Timedout, HTTP 504 (Service unavailable) failure for UserId 4: Service exception.` El mensaje siempre incluirá `failure for UserId {}` si es un error HTTP.Es un comportamiento no definido si pasas ambos UserIds válidos e inválidos, es decirun `UserId` que no es un número positivo, ya que algunas solicitudes de red pueden tener éxito antes de que se valide toda la entrada.

  Debido a los riesgos asociados con la prohibición de usuarios, este método solo se puede llamar en el servidor de juegos en el backend.Las llamadas del lado del cliente resultarán en un error.Puedes probar esta API en Studio, Creación en equipo y Prueba en equipo, pero las prohibiciones no se aplicarán a la producción.Esta llamada de función solo intentará solicitudes de prohibición en servidores de juegos de producción y no en la prueba de Studio.Sin embargo, todos los pasos de validación de entrada seguirán funcionando en Studio.

  Esta API utiliza la [API de nube abierta de restricciones de usuario](/cloud/reference/UserRestriction). Podrás utilizar estas APIs para gestionar tus prohibiciones en aplicaciones de terceros.

Players:UnbanAsync

<table>
    <thead>
      <tr>
        <th>Nombre</th>

        <th>Tipo</th>

        <th>Descripción</th>
      </tr>
    </thead>

    <tbody>
      <tr>
        <td><code>Identidades de usuario</code></td>

        <td>matriz/lista</td>

        <td>ID de usuario que se permiten forzar en la experiencia(s). El tamaño máximo es <code>50</code>.</td>
      </tr>

      <tr>
        <td><code>Aplicar al universo</code></td>

        <td>booleno</td>

        <td>Propaga la desban a todos los lugares dentro de este universo.</td>
      </tr>
    </tbody>
  </table>

Desbanea a los jugadores prohibidos de `Class.Players:BanAsync()` o la API de la nubede nube abierta de restricciones de usuario.Este método está habilitado y deshabilitado por la propiedad `Class.Players.BanningEnabled`, que puedes alternar en Studio.

Players

Habilita o deshabilita los tres métodos `Class.Players` ( `Class.Players:BanAsync()|BanAsync()` , `Class.Players:UnbanAsync()|UnbanAsync()` y `Class.Players:GetBanHistoryAsync()|GetBanHistoryAsync()` ) que constituyen la API de prohibición.Esta propiedad no es scriptable y solo se puede modificar en Studio.

Players.BanningEnabled

Esta propiedad indica si el chat de burbujas está habilitado o no. Se establece con el método `Class.Players:SetChatStyle()` usando el enum `Enum.ChatStyle`.

  Cuando este modo de chat está habilitado, el juego muestra chats en la interfaz de usuario de chat en la esquina superior izquierda de la pantalla.

  Hay otros dos modos de chat, `Class.Players.ClassicChat` y un modo de chat en el que se habilitan tanto el chat clásico como el de burbujas.

Players.BubbleChat

Indica si el chat de burbujas está habilitado o no. Se establece con el método `Class.Players:SetChatStyle()`.

This example demonstrates one possible usage of the
`Class.Players.CharacterAutoLoads` property.

The example below respawns all players in the game, if dead, once every 10
seconds. This means that players who die 1 second after all players respawn
must wait 9 seconds until the script loads all `Class.Player.Character` again.

First, this script removes a player's character when they die and the
`Class.Humanoid.Died` function fires. This is done so that the respawn loop
that executes every 10 seconds reloads that player when it does not find the
player's character in the Workspace.

To work as expected, this example should be run within a `Script`.

Esta propiedad indica si `Class.Player.Character|characters` reaparecerá automáticamente. El valor predeterminado es verdadero.

  Si esta propiedad está deshabilitada (falsa), el jugador `Class.Player.Character|characters` no aparecerá hasta que se llame la función `Class.Player:LoadCharacter()` para cada `Class.Player`, incluido cuando los jugadores se unan a la experiencia.

  Esto puede ser útil en experiencias en las que los jugadores tienen vidas finitas, como juegos competitivos en los que los jugadores no reaparecen hasta que termine una ronda de juego.

Players.CharacterAutoLoads

Indica si `Class.Player.Character|characters` reaparecerá automáticamente.

Indica si el chat clásico está habilitado o no. Esta propiedad se establece con el método `Class.Players:SetChatStyle()` usando el enum `Enum.ChatStyle`.

  Cuando este modo de chat está habilitado, el juego muestra chats en una burbuja por encima de la cabeza del remitente.

  Hay otros dos modos de chat, `Class.Players.BubbleChat` y un modo de chat en el que se habilitan tanto el chat clásico como el de burbujas.

Players.ClassicChat

Indica si el chat clásico está habilitado o no; establecido por el método `Class.Players:SetChatStyle()`.

Esta propiedad de solo lectura se refiere a la `Class.Player` cuyo cliente está ejecutando la experiencia.

  Esta propiedad solo se define para `Class.LocalScript|LocalScripts` y `Class.ModuleScript|ModuleScripts` requeridas por ellos, ya que se ejecutan en el cliente.Para el servidor, en el que `Class.Script` objetos ejecutan su código, esta propiedad es `nil` .

Players.LocalPlayer

El `Class.Player` que el `Class.LocalScript` está corriendo por.

Esta propiedad determina el número máximo de jugadores que pueden estar en un servidor.Esta propiedad solo se puede establecer a través de las configuraciones de un lugar específico en el [tablero de administrador del creador](https://create.roblox.com/dashboard/creations) o a través de las configuraciones de [juego](/studio/game-settings).

Players.MaxPlayers

El número máximo de jugadores que pueden estar en un servidor.

Esta propiedad indica el número de personas en el servidor en el momento actual. Se lee solo. Es decir, no se puede escribir, solo se puede leído.

Players.NumPlayers

Devuelve el número de personas en el servidor en el momento actual.

Esta propiedad indica el número de jugadores a los que el emparejador de Roblox llenará los servidores.Este número será menor que el número máximo de jugadores ( `Class.Players.MaxPlayers` ) admitidos por la experiencia.

Players.PreferredPlayers

El número preferido de jugadores para un servidor.

Esta propiedad controla el tiempo, en segundos, que toma un jugador para reaparecer cuando `Class.Players.CharacterAutoLoads` es verdadero. Se predetermina en 5.0 segundos.

  Esto es útil cuando quieres cambiar el tiempo que tarda en reaparecer según el tipo de tu experiencia, pero no quieres manejar la aparición de jugadores individualmente.

  Aunque esta propiedad se puede establecer desde dentro de un `Class.Script` , es más fácil establecerla directamente en el objeto `Class.Players` en la ventana [Explorador](/studio/explorer) de Studio.

Players.RespawnTime

Controla la cantidad de tiempo que tarda un personaje de jugador en reaparecer.

Players.UseStrafingAnimations

Players.localPlayer

Players.numPlayers

Un servicio que contiene actualmente objetos conectados `Class.Player` .

`Instance` es la clase base para todas las clases en la jerarquía de clases de Roblox que pueden formar parte del árbol `Class.DataModel`.

  No es posible crear directamente objetos raíz `Instance` , pero el constructor especial `Datatype.Instance.new()` crea objetos a través de código, tomando el nombre de la clase como parámetro y devolviendo el objeto creado.

Demonstrates detecting changes to an instance's ancestry by connecting to the `Class.Instance.AncestryChanged` event.

The ChangingPart's Parent is set to different values overtime. The parent of the part is the part's ancestor, so the `Class.Instance.AncestryChanged` event will fire whenever it changes.

Se incendia cuando la propiedad `Class.Instance.Parent` de la objeto o una de sus ancestros cambia.

  Este evento incluye dos parámetros: `child` se refiere al `Class.Instance` cuyo `Class.Instance.Parent` realmente se cambió, mientras que `parent` se refiere al nuevo `Class.Instance.Parent` de esta instancia.

  Puedes usar este evento para rastrear la eliminación de una instancia en Studio, como la eliminación manual en el Explorador o a través de un plugin.Si necesita detectar cuando se destruye una instancia usando `Class.Instance:Destroy()` , use el evento `Class.Instance.Destroying` en su lugar.

Instance.AncestryChanged

child

El `Class.Instance` cuyo `Class.Instance.Parent` ha sido cambiado.

parent

El nuevo `Class.Instance.Parent` de la `Class.Instance` cuyo `Class.Instance.Parent` se cambió.

Se incendia cuando la propiedad `Class.Instance.Parent` de la objeto o una de sus ancestros cambia.

Este evento se activa cada vez que se cambia cualquier atributo en la instancia, incluido cuando un atributo se establece en `nil`.El nombre del atributo cambiado se pasa a la función conectada.

  Por ejemplo, el siguiente fragmento de código conecta la función `attributeChanged()` a disparar cada vez que cambia uno de los atributos de la parte:

  ```lua
  local Workspace = game:GetService("Workspace")

  local part = Workspace.Part

  local function attributeChanged(attributeName)
  	print(attributeName, "changed")
  end

  part.AttributeChanged:Connect(attributeChanged)
  ```

  Vea también `Class.Instance:GetAttributeChangedSignal()` que devuelve un evento que se activa cuando un atributo específico cambia.

Instance.AttributeChanged

attribute

El nombre del atributo que se ha cambiado.

Se enciende cada vez que se cambia un atributo en el `Class.Instance`.

This snippet prints the names of objects as they are added to the Workspace:

Se produce fuegos después de que un objeto sea padre de este `Class.Instance` .

  Tenga en cuenta, al usar esta función en un cliente para detectar objetos creados por el servidor, es necesario usar `Class.Instance:WaitForChild()` al indexar los descendientes de estos objetos.Esto se debe a que el objeto y sus descendientes no se garantizan de replicarse simultáneamente desde el servidor al cliente.Por ejemplo:

  ```
  local Workspace = game:GetService("Workspace")

  Workspace.ChildAdded:Connect(function(child)
  	-- Use WaitForChild() since descendants may not have replicated yet
  	local head = child:WaitForChild("Head")
  end)
  ```

  Nota, esta función solo funciona para los hijos inmediatos del `Class.Instance` . Para una función que captura todos los descendientes, use `Class.Instance.DescendantAdded` .

  Vea también `Class.Instance.ChildRemoved` .

Instance.ChildAdded

Se produce fuegos después de que un objeto sea padre de este `Class.Instance` .

This snippet prints the names of objects as they are removed from the
Workspace:

Se produce fuegos después de que se elimine a un niño de este `Class.Instance` .

  Removed se refiere a cuando el padre de un objeto se cambia de este `Class.Instance` a algo diferente a esto `Class.Instance` .Nota, este evento también se disparará cuando se destruya un niño (usando `Class.Instance:Destroy()` ) ya que la función de destrucción establece al padre de un objeto en `nil` .

  Esta función solo funciona para los hijos inmediatos del `Class.Instance` . Para una función que capture a todos los descendientes, use `Class.Instance.DescendantRemoving` .

  Vea también `Class.Instance.ChildAdded` .

Instance.ChildRemoved

Se produce fuegos después de que se elimine a un niño de este `Class.Instance` .

This following example will print the name of any object that is added to the
Workspace:

Este evento se activa después de que se agregue un descendiente a la `Class.Instance`.

  Al disparar por cada descendiente, hacer padre de un objeto al `Class.Instance` disparará el evento para este objeto y todos sus descendientes individualmente.

  Si solo te preocupas por los hijos directos del , usa en su lugar.

  Vea también `Class.Instance.DescendantRemoving` .

Instance.DescendantAdded

descendant

Se produce fuegos después de que se agregue un descendiente al `Class.Instance`.

The following example prints the name of any descendant as it is being removed
from the Workspace:

Este evento se activa **inmediatamente antes de** que el padre `Class.Instance` cambie tal que una instancia **descendiente** ya no sea descendiente. `Class.Instance:Destroy()|Destroy()` cambia el `Class.Instance.Parent|Parent` de una instancia a `nil`, por lo que llamar ese método a un descendiente del padre hará que se active este evento.

  Dado que este evento dispara **antes de** la eliminación del descendiente, el padre del descendente se mantendrá sin cambios al momento de disparo de este evento.Si el descendiente es también un **niño directo** del padre, este evento se disparará antes de `Class.Instance.ChildRemoved` .

  Si un descendiente tiene hijos, este evento se activa con el descendiente primero, seguido de sus descendientes.

  ##### Advertencia

  Este evento se dispara con el objeto descendente que se está eliminando.Intentar establecer el `Class.Instance.Parent|Parent` del descendente a algo más fallará.A continuación se muestra un ejemplo que demuestra esto:

  ```
  local Workspace = game:GetService("Workspace")

  Workspace.DescendantRemoving:Connect(function(descendant)
  	-- Do not manipulate the parent of the descendant in this function!
  	-- This event fires BECAUSE the parent was manipulated, and the change hasn't happened yet
  	-- Therefore, it is problematic to change the parent like this:
  	descendant.Parent = game
  end)

  local part = Instance.new("Part")
  part.Parent = Workspace
  part.Parent = nil
  ```

  Vea también `Class.Instance.DescendantAdded|DescendantAdded` .

Instance.DescendantRemoving

El `Class.Instance` que se está eliminando.

Se incendia inmediatamente antes de que se elimine un descendiente del `Class.Instance` se elimine.

Instance

`Instance` es la clase base para todas las clases en la jerarquía de clases de Roblox que pueden formar parte del árbol `Class.DataModel`.