This sample shows the basic setup for an `Class.IKControl` that moves a
character's left arm to reach for a point in the world.

**IKControl** instancias generan poses de animación procedural utilizando Kinemática inversa (IK).Te permiten hacer que los personajes respondan de manera realista a su entorno, ambiente.

  Por ejemplo, puedes hacer que un personaje ponga la mano en una manija de puerta exactamente, y el personaje lo hará independientemente de su posición.Los controles de IK proporcionan la ventaja de tener que crear muchas menos animaciones para tu juego mientras le das a tu experiencia un aspecto más realista y pulido.

  `Class.IKControl|IKControls` debe ser un hijo de un `Class.Humanoid` o `Class.AnimationController` con un `Class.Animator` y tener todas sus propiedades requeridas establecidas correctamente, de lo contrario no tienen ningún efecto.Las propiedades requeridas son `Class.IKControl.Type|Type` , `Class.IKControl.EndEffector|EndEffector` , `Class.IKControl.Target|Target` , `Class.IKControl.ChainRoot|ChainRoot` .Tan pronto como se establecer, el IkControl modifica la postura de tu personaje según lo especifiques.El siguiente ejemplo de código muestra cómo configurar tu primera `Class.IKControl` y comenzar a crear animaciones más realistas para tu juego.

  Puedes usar IKControls para crear un personaje:

  *   Gira su cabeza y torso para mirar un punto de interés en el mundo.
  *   Modifica sus posiciones de pies para responder al terreno dinámico. Ajusta sus piernas y pies para colocarlos de acuerdo con el terreno con rocas y laderas.
  *   Mantén una arma y coloca sus manos apropiadamente en el mango sin necesidad de crear animaciones para cada arma en el juego.
  *   Apunta a un punto en el mundo, para que la punta del arma apunte exactamente a lo que quieres disparar. Especialmente útil en shooters de tercera persona.
  *   Pon sus manos en el volante de un automóvil y síguelo cuando gira.
  *   ¡Mucho más!

  `Class.IKControl` anulará la animación para todas las partes entre el `Class.IKControl.ChainRoot|ChainRoot` y el `Class.IKControl.EndEffector|EndEffector` .Puedes activar/desactivarlo usando `Class.IKControl.Enabled|Enabled` o cambiar cuánto tienen un efecto sobre la animación subyacente usando el `Class.IKControl.Weight|Weight` .Tenga cuidado: si no configura correctamente su `Class.IKControl|IKControls`, ¡podría generar poses malas e irrealistas!

IKControl:GetChainCount

IKControl:GetChainLength

IKControl:GetNodeLocalCFrame

index

IKControl:GetNodeWorldCFrame

IKControl:GetRawFinalTarget

IKControl:GetSmoothedFinalTarget

IKControl

Al especificar un `Class.IKControl.ChainRoot|ChainRoot` y un `Class.IKControl.EndEffector|EndEffector` , le instruyes al `Class.IKControl` que está permitido mover y rotar todas las piezas entre las dos para mover el `Class.IKControl.EndEffector|EndEffector` a la `Class.IKControl.Target|Target` .Por ejemplo, si especificas la mano izquierda como `Class.IKControl.EndEffector|EndEffector` y el brazo superior izquierdo como `Class.IKControl.ChainRoot|ChainRoot`, el control mueve 3 partes: la mano izquierda, el brazo inferior izquierdo y el brazo superior izquierdo.Evite establecer `Class.IKControl.ChainRoot|ChainRoot` como la raíz real del personaje porque produce resultados poco realistas.

IKControl.ChainRoot

La última parte en la que estás interesado en mover tu personaje.Por ejemplo, el brazo superior.Debe ser un ancestro de `Class.IKControl.EndEffector|EndEffector` y ser un `Class.BasePart` o un `Class.Bone` en tu personaje.

Esta propiedad le permite alternar el control de IK en y apagado.Está activado por defecto.Cuando `Class.IKControl.Enabled|Enabled` es falso, el control de IK está desactivado y no se resuelve por el solucionador de física PGSsubyacente.

IKControl.Enabled

Alterna el control en y desactivado. Verdadero por defecto.

La `Class.IKControl.EndEffector|EndEffector` describe la última parte de la cadena de tu personaje que quieres afectar.Por ejemplo, podría ser la mano cuando quieras mover todo el brazo para llegar a un punto.Puede ser un `Class.BasePart` en un personaje, que tiene un `Class.Motor6D` como hijo, un `Class.Motor6D` directamente, un `Class.Bone` o un `Class.Attachment` .El pivote de la selección `Class.IKControl.EndEffector|EndEffector` se mueve al `Class.IKControl.Target|Target` , por lo que puedes usar `Class.Attachment|Attachments` para modificar qué punto de un `Class.BasePart` debe llegar al `Class.IKControl.Target|Target` .

IKControl.EndEffector

La parte que estás interesado en mover para llegar al `Class.IKControl.Target|Target` .Por ejemplo, la mano de tu personaje.Debe ser un descendiente de `Class.IKControl.ChainRoot|ChainRoot` y ser un `Class.BasePart` o un `Class.Bone` en tu personaje.

El desplazamiento del efecto final es un desplazamiento adicional de aplicado sobre el que produce el final usado para colocar el .Por defecto, es el marco de identidad CFrame, por lo que si no lo configuras, no tiene efecto y el `Class.IKControl.EndEffector|EndEffector` usa el `Class.IKControl.Target|Target``Datatype.CFrame` directamente, lo que se especifica en el espacio local del `Class.IKControl.EndEffector|EndEffector` .

  Alternativamente, puedes usar archivos adjuntos estableciendo un archivo adjunto como `Class.IKControl.EndEffector|EndEffector` , que lo mueve a la `Class.IKControl.Target|Target` en lugar de las partes a las que está adjunto, obteniendo efectivamente el mismo resultado.

  También puedes usar `Class.IKControl.EndEffectorOffset|EndEffectorOffset` para modificar qué eje de la `Class.IKControl.EndEffector|EndEffector` debe apuntar al `Class.IKControl.Target|Target` al usar `LookAt` como `Class.IKControl.Type|Type` .

IKControl.EndEffectorOffset

Un desplazamiento adicional aplicado en la parte superior del `Class.IKControl.EndEffector|EndEffector` en su espacio local para cambiar a dónde se mueve.

El desplazamiento es un desplazamiento adicional aplicado sobre el que produce el final usado para colocar el .Es la identidad por defecto, por lo que si no la configuras, no tendrá efecto y el `Class.IKControl.EndEffector|EndEffector` usará el `Class.IKControl.Target|Target``Datatype.CFrame` directamente.Puedes animarlo para crear animaciones procedimentales como escribir en un teclado.Es útil cuando el `Class.IKControl.Target|Target` y el `Class.IKControl.EndEffector|EndEffector` no están alineados y necesitas corregirlo con una rotación o traducción adicional.

IKControl.Offset

Un desplazamiento adicional aplicado sobre el `Class.IKControl.Target|Target` para cambiar dónde se mueve el `Class.IKControl.EndEffector|EndEffector`.

El `Class.IKControl.Pole|Pole` es un opcional `Class.Instance` que te da control sobre cómo deben doblarse las partes intermedias en tu personaje.Puede ser cualquier cosa que tenga una posición en el mundo, como `Class.BasePart` , `Class.Attachment` , `Class.Bone` , `Class.Motor6D` .Por defecto es `nil`.Cuando lo especifiques, el solucionador subyacente hará que las piezas se doblen hacia él.Cuando sea `nil`, el solucionador intentará hacer que los codos y las rodillas se doblen apropiadamente en función de la extremidad del personaje.La extremidad será "Brazo" cuando selecciones como la izquierdaMano o derechaMano y como la correspondiente izquierdaSuperior del brazo o derechaSuperior del brazo , y será "Pierna" cuando selecciones como la izquierdaPierna o derechaPierna y como la correspondiente izquierdaSuperior de la pierna o derechaSuperior de la pierna .En todos los demás casos, si no especificas un eje, la cadena podría no doblarse como esperas.

IKControl.Pole

Una instancia opcional que determina hacia qué lado se dobla la cadena. Puedes usar esto para especificar hacia qué lado se dobla un codillo o una rodilla.

Cuando varios controles están activos en un personaje, el orden en que se resuelven por el sistema subyacente afecta la postura final generada.Al cambiar este valor, especificas el orden en el que se satisfacen los controles.Los valores más altos tienen mayor prioridad, y los controles de mayor prioridad se resuelven más tarde porque su resultado podría anular el resultado anterior de otros controles.Si tienes múltiples controles de IK en un personaje y uno es más importante que el otro, especifica una prioridad más baja para él.Por defecto es 0, lo que significa que todos los controles tienen la misma prioridad.

IKControl.Priority

Specifica el orden en el que se resuelven los controles. Los valores más altos tienen mayor prioridad.

Este valor especifica el número promedio de segundos que toma el `Class.IKControl.EndEffector|EndEffector` para llegar al `Class.IKControl.Target|Target` .El comportamiento es el de una resorte críticamente amortiguada, donde la velocidad de cambio es proporcional a la distancia al objetivo y no hay oscilaciones cuando se acerca al objetivo.Los valores más pequeños crean una convergencia más rápida, y los valores más grandes crean una convergencia más lenta.Un valor de 0 desactiva la suavización.El valor predeterminado es 0.05 para proporcionar una suavización muy leve que haga que el movimiento se sienta realista.

IKControl.SmoothTime

Specifica el número promedio de segundos que se tarda en que el `Class.IKControl.EndEffector|EndEffector` llegue suavemente al `Class.IKControl.Target|Target`.

El `Class.IKControl.Target|Target` representa un punto ( `Datatype.CFrame` ) en el mundo al que quieres que llegue tu `Class.IKControl.EndEffector|EndEffector` .El comportamiento exacto de alcanze se puede configurar a través de la propiedad `Class.IKControl.Type|Type`, y se puede aplicar un adicional `Class.IKControl.Offset|Offset` encima de ella para modificarla.Si estableces un `Class.IKControl.Target|Target` que se moverá por física o por un script, en cada marco el `Class.IKControl` intentará satisfacerlo, actualizando automáticamente el punto de llegada.

IKControl.Target

El objeto al que el `Class.IKControl.EndEffector|EndEffector` llega o apunta.Puede ser cualquier cosa que tenga una posición en el mundo, como `Class.BasePart` , `Class.Attachment` , `Class.Bone` o `Class.Motor6D` .

Al cambiar el `Class.IKControl.Type|Type`, puedes cambiar el comportamiento del control. Estas son las opciones disponibles:

  *   Transformar: es una restricción de 6 grados completos. Alinea el `Class.IKControl.EndEffector|EndEffector``Datatype.CFrame` con el de la `Class.IKControl.Target|Target` .
  *   Posición: alinea la posición `Class.IKControl.EndEffector|EndEffector` con la de `Class.IKControl.Target|Target`.
  *   Rotación: alinea la rotación `Class.IKControl.EndEffector|EndEffector` a la de la `Class.IKControl.Target|Target`.
  *   LookAt: mueve y orienta toda la cadena para hacer un eje (por defecto, el eje delantero) en el punto `Class.IKControl.EndEffector|EndEffector` de una posición en el mundo especificada por `Class.IKControl.Target|Target`.

IKControl.Type

Specifica cómo el solucionador satisface este control.

Puedes controlar cuánto afecta un control dado la postura del personaje usando esta propiedad.Los valores deben estar en el rango \[0, 1].0 significa ningún efecto, y 1 significa el efecto completo del control de IK.Los valores fuera de este rango se acortan.Variar suavemente este valor te permite mezclar dentro o fuera de un control específico para evitar movimientos bruscos.Es 1 por defecto.

  El peso determina el factor de interpolación entre el efector final y el objetivo de IK.Establecer el peso en 0 no desactiva el control de IK porque otros factores, incluido el factor de suavización de SmoothTime y Pole, aún pueden cambiar la postura.Para deshabilitar realmente el control de IK, cambia la propiedad `Class.IKControl.Enabled|Enabled` a falsa.

IKControl.Weight

Specifica el peso del objetivo de control de IK. Debe estar en el rango \[0, 1].

Specifica un control para generar una posición de animación procedural utilizando Kinemática inversa.

`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.

This sample demonstrates how, when using Immediate signal behavior, an Instance being destroyed remains in place until the connected function yields.

This sample demonstrates how, when using Deferred signal behavior,
an Instance is destroyed before the signal fires.

El `Class.Instance` nunca se eliminará de la memoria mientras una función conectada aún lo esté utilizando.Sin embargo, si la función se rinde en cualquier punto, los `Class.Instance` y sus descendientes serán padres de `nil` .

  Si la propiedad `Class.Workspace.SignalBehavior` se establece en `Enum.SignalBehavior.Immediate`, este evento se activa inmediatamente antes de que se destruya `Class.Instance` o uno de sus ancestros con `Class.Instance:Destroy()` .

  Si la propiedad `Class.Workspace.SignalBehavior` se establece en `Enum.SignalBehavior.Deferred`, este evento se activa en el siguiente punto de reanudación, que será después de que se destruya el `Class.Instance` o uno de sus ancestros con `Class.Instance:Destroy()`.

  Con el comportamiento `Enum.SignalBehavior.Deferred|Deferred`, conectar un script a su propio evento `Class.Instance.Destroying` es problemático, ya que el script se destruirá antes de que se pueda llamar la llamada de devolución (lo que significa que no se ejecutará).

  Al eliminar un `Class.Instance` en Studio, como eliminar manualmente a través del [Explorador](/studio/explorer) o a través de un plugin, el `Class.Instance` no se destruye.En cambio, el padre se establece en `nil` que puedes rastrear con `Class.Instance.AncestryChanged` .

Instance.Destroying

Se incendia inmediatamente antes (o se retrasa hasta después) de que la instancia se destruya a través de `Class.Instance:Destroy()` .

Este evento se activa cada vez que se cambia cualquier propiedad de estilo en la instancia, incluida cuando una propiedad se establece en `nil`.

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

  local player = Players.LocalPlayer
  local playerGui = player.PlayerGui
  local HUDContainer = playerGui:WaitForChild("HUDContainer")
  local meterBar = HUDContainer.MeterBar

  local function stylePropertyChanged()
  	print("Styled properties changed")
  end

  meterBar:StyledPropertiesChanged():Connect(stylePropertyChanged)
  ```

Instance.StyledPropertiesChanged

Se activa cada vez que se cambia cualquier propiedad de estilo en la instancia, incluida cuando una propiedad se establece en `nil`.

Instance.childAdded

Este método aplica una etiqueta a la instancia, sin efecto si la etiqueta ya se aplica.Añadir con éxito una etiqueta disparará una señal creada por `Class.CollectionService:GetInstanceAddedSignal()` con la etiqueta dada.

  ##### Advertencias

  *   Las etiquetas de una instancia que se agregaron en el lado del cliente se eliminarán si el servidor luego agrega o elimina una etiqueta en esa instancia porque el servidor replica todas las etiquetas juntas y reemplaza etiquetas anteriores.

  *   Cuando se etiqueta una instancia, es común que se utilicen algunos recursos para darle al etiqueta su funcionalidad, por ejemplo conexiones de eventos o tablas.Para evitar fugas de memoria, es una buena idea limpiarlas (desconectarse, establecer en `nil` , etc.) cuando ya no se necesitan para una etiqueta.Haz esto al llamar `Class.Instance:RemoveTag()` , llamar `Class.Instance:Destroy()` o en una función conectada a una señal devuelta por `Class.CollectionService:GetInstanceRemovedSignal()` .

Instance:AddTag

Esta función destruye todos los hijos y descendientes de una instancia.

  ```
  local part = Instance.new("Part")

  -- Add some sparkles
  for i = 1, 3 do
  	local sparkles = Instance.new("Sparkles")
  	sparkles.Parent = part

    local sc = Instance.new("Sparkles")
    sc.Parent = sparkles
  end

  print("Children:", #part:GetChildren())  --> Children: 3

  part:ClearAllChildren()

  print("Children:", #part:GetChildren())  --> Children: 0
  ```

  Si no desea destruir **todos** los hijos e hijos, use `Class.Instance:GetChildren()` o `Class.Instance:GetDescendants()` para recorrer esos hijos/descendientes y seleccionar qué destruir.Por ejemplo, el siguiente ejemplo de código destruirá todos los `Class.BasePart|BaseParts` descendientes de un `Class.Model` :

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

  local model = Workspace:FindFirstChild("TestModel")

  for _, descendant in model:GetDescendants() do
  	if descendant:IsA("BasePart") then
  		descendant:Destroy()
  	end
  end
  ```

Instance:ClearAllChildren

Esta función destruye todos los hijos de una instancia.

Demonstrates cloning a model using `Class.Instance:Clone()`.

`Clone()` crea una copia de una instancia y todos sus descendientes, ignorando todas las instancias que no sean `Class.Instance.Archivable|Archivable`.Se devuelve una copia de la instancia raíz por este método y su `Class.Instance.Parent|Parent` se establece en `nil` .Tenga en cuenta que si la instancia misma tiene `Class.Instance.Archivable|Archivable` establecido a `false` , esta función devolverá `nil` .

  Si una propiedad de referencia como `Class.ObjectValue.Value` se establece en una instancia clonada, el valor de la propiedad de la copia depende del valor de la propiedad original:

  *   Si una propiedad de referencia se refiere a una instancia que también fue **clonada** , la copia se referirá a la copia.
  *   Si una propiedad de referencia se refiere a un objeto que no fue **clonado** , el mismo valor se mantiene en la copia.

Instance:Clone

Crea una copia de una instancia y todos sus descendientes, ignorando las instancias que no sean `Class.Instance.Archivable|Archivable`.

Demonstrates destroying a Part using the `Class.Instance:Destroy()` function.

This function is the correct way to dispose of objects that are no longer required.

Establece la propiedad `Class.Instance.Parent` a `nil`, bloquea la propiedad `Class.Instance.Parent` y desconecta todas las conexiones, y llama `Destroy()` a todos los hijos.Esta función es la manera correcta de deshacerse de objetos que ya no son necesarios.

  Deshacerse de objetos no necesarios es importante, ya que los objetos y conexiones innecesarios en un lugar agotan la memoria que puede conducir a problemas de rendimiento serios con el tiempo.

  Como mejor práctica después de llamar `Destroy()` a un objeto, establece cualquier variable que haga referencia al objeto (o sus descendientes) a `nil`.Esto impide que tu código acceda a cualquier cosa que tenga que ver con el objeto.

  ```lua
  local part = Instance.new("Part")
  part.Name = "Hello, world"
  part:Destroy()
  -- No haga esto:
  print(part.Name)  --> "Hola, mundo"
  -- Haz esto para evitar que la línea anterior funcione:
  part = nil
  ```

  Una vez que un `Class.Instance` se ha destruido por este método, no se puede volver a usar porque la propiedad `Class.Instance.Parent` está bloqueada.Para **temporalmente** eliminar un objeto en lugar de destruirlo, establece `Class.Instance.Parent|Parent` a `nil` .Por ejemplo:

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

  object.Parent = nil
  task.wait(2)
  object.Parent = Workspace
  ```

  Para destruir un objeto después de una cantidad determinada de tiempo, usa `Class.Debris:AddItem()` .

Instance:Destroy

Establece la propiedad `Class.Instance.Parent` a `nil`, bloquea la propiedad `Class.Instance.Parent` y desconecta todas las conexiones, y llama `Destroy()` a todos los hijos.

Devuelve al primer ancestro del `Class.Instance` cuyo `Class.Instance.Name` es igual al nombre dado.

  Esta función trabaja hacia arriba, lo que significa que comienza en el inmediato `Class.Instance.Parent` de la instancia y trabaja hacia el `Class.DataModel` .Si no se encuentra un ancestro coincidente, devuelve `nil` .

  El siguiente fragmento de código encontraría al primer ancestro del objeto llamado `Car` .

  ```
  local car = object:FindFirstAncestor("Car")
  ```

  Para las variantes de esta función que encuentran ancestros de una clase específica, consulte `Class.Instance:FindFirstAncestorOfClass()` y `Class.Instance:FindFirstAncestorWhichIsA()` .

Instance:FindFirstAncestor

name

El `Class.Instance.Name` que hay que buscar.

Devuelve al primer ancestro del `Class.Instance` cuyo `Class.Instance.Name` es igual al nombre dado.

Devuelve al primer ancestro del `Class.Instance` cuyo `Class.Object.ClassName` es igual a la clase dada.

  Esta función trabaja hacia arriba, lo que significa que comienza en el inmediato `Class.Instance.Parent` de la instancia y trabaja hacia el `Class.DataModel` .Si no se encuentra un ancestro coincidente, devuelve `nil` .

  Un uso común de esta función es encontrar el `Class.Model` a `Class.BasePart` pertenece. Por ejemplo:

  ```
  local model = part:FindFirstAncestorOfClass("Model")
  ```

  Esta función es una variante de `Class.Instance:FindFirstAncestor()` que comprueba la propiedad `Class.Object.ClassName` en lugar de `Class.Instance.Name`.`Class.Instance:FindFirstAncestorWhichIsA()` también existe, usando el método `Class.Object:IsA()` en lugar de respetar la herencia de clase.

Instance:FindFirstAncestorOfClass

className

El `Class.Object.ClassName` que hay que buscar.

Devuelve al primer ancestro del `Class.Instance` cuyo `Class.Object.ClassName` es igual a la clase dada.

Devuelve al primer ancestro del `Class.Instance` para el que `Class.Object:IsA()` devuelve verdadero para la clase dada.

  Esta función trabaja hacia arriba, lo que significa que comienza en el inmediato `Class.Instance.Parent` de la instancia y trabaja hacia el `Class.DataModel` .Si no se encuentra un ancestro coincidente, devuelve `nil` .

  A diferencia de `Class.Instance:FindFirstAncestorOfClass()`, esta función usa `Class.Object:IsA()` que respeta la herencia de clase. Por ejemplo:

  ```
  print(part:IsA("Part"))  --> true
  print(part:IsA("BasePart"))  --> true
  print(part:IsA("Instance"))  --> true
  ```

  Por lo tanto, el siguiente ejemplo de código devolverá al primer ancestro `Class.BasePart` , independientemente de si es un `Class.WedgePart` , `Class.MeshPart` o `Class.Part`.

  ```
  local part = object:FindFirstAncestorWhichIsA("BasePart")
  ```

  Vea también `Class.Instance:FindFirstAncestor()` .

Instance:FindFirstAncestorWhichIsA

Devuelve al primer ancestro del `Class.Instance` para el que `Class.Object:IsA()` devuelve verdadero para la clase dada.

The below would look in Workspace for an object name "Brick". If found, it
will change the name of the object to "Foo".

Devuelve el primer hijo del `Class.Instance` con el nombre dado, o `nil` si no existe tal hijo.Si el argumento opcional `recursive` es `true`, esta función busca todos los descendientes en lugar de solo los hijos inmediatos del `Class.Instance`.

  ##### Comprobación de la existencia de un objeto

  `FindFirstChild()` es necesario si necesitas verificar que un objeto exista antes de continuar.Intentar indexar a un hijo por su nombre usando el operador punto arroja un error si el hijo no existe.

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

  -- Los siguientes errores de línea ocurren si la parte no existe en el espacio de trabajo
  Workspace.Part.Transparency = 0.5
  ```

  Un enfoque mejor es usar `FindFirstChild()` para primero verificar `Part` , luego usar una declaración `if` para ejecutar código que lo necesita.

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

  local part = Workspace:FindFirstChild("Part")
  if part then
  	part.Transparency = 0.5
  end
  ```

  ##### Encontrar un niño cuyo nombre coincida con una propiedad

  A veces el `Class.Instance.Name|Name` de un objeto es igual al de una propiedad de su `Class.Instance.Parent|Parent` .Al usar el operador de punto, las propiedades tienen prioridad sobre los hijos si comparten un nombre.

  En el siguiente ejemplo, se agrega un `Class.Folder` llamado `Color` a un `Class.Part` , que también tiene la propiedad `Class.Part.Color`.Observe que `part.Color` se refiere al valor de la propiedad `Datatype.Color3` , no a la instancia hija `Class.Folder`.Una ventaja de usar `Class.Instance:FindFirstChild()|FindFirstChild()` es que la introducción de nuevas propiedades no impone un riesgo en tu código.

  ```lua
  local part = Instance.new("Part")
  local folder = Instance.new("Folder")
  folder.Name = "Color"
  folder.Parent = part
  local c1 = part.Color  -- La propiedad
  local c2 = part:FindFirstChild("Color")  -- The child folder
  ```

  ##### Notas de rendimiento

  `Class.Instance:FindFirstChild()|FindFirstChild()` toma aproximadamente un 20% más de tiempo que usar el operador de punto y casi 8 veces más tiempo que simplemente almacenar una referencia a un objeto.Por lo tanto, debe evitar llamarlo en código dependiente del rendimiento, como en bucles estrechos o funciones conectadas a `Class.RunService.Heartbeat` y `Class.RunService.PreRender` .En cambio, almacene el resultado en una variable, o considere usar `Class.Instance.ChildAdded|ChildAdded` o `Class.Instance:WaitForChild()|WaitForChild()` para detectar cuando un hijo de un nombre dado se vuelve disponible.

Instance:FindFirstChild

recursive

Si debe o no llevarse a cabo la búsqueda recursivamente.

Devuelve el primer hijo del `Class.Instance` encontrado con el nombre dado.

Devuelve el primer hijo del `Class.Instance` cuyo `Class.Object.ClassName|ClassName` es igual al dado `className` .A diferencia de `Class.Instance:FindFirstChildWhichIsA()`, esta función solo devuelve objetos cuya clase coincida con `className`, ignorando la herencia de clases.Si no se encuentra un niño coincidente, esta función devuelve `nil` .

Instance:FindFirstChildOfClass

Devuelve el primer hijo del `Class.Instance` cuyo `Class.Object.ClassName|ClassName` es igual al nombre de clase dado.

Devuelve el primer hijo del `Class.Instance` para quien `Class.Object:IsA()` devuelve verdadero para la clase dada.

  Si no se encuentra un niño coincidente, esta función devuelve `nil` .Si el argumento recursivo opcional es verdadero, esta función busca todos los descendientes en lugar de solo los hijos inmediatos del `Class.Instance` .

  A diferencia de `Class.Instance:FindFirstChildOfClass()`, esta función usa `Class.Object:IsA()` que respeta la herencia de clase. Por ejemplo:

  ```lua
  print(part:IsA("Part")) --> cierto
  print(part:IsA("BasePart")) --> cierto
  print(part:IsA("Instance")) --> true
  ```

  Por lo tanto, el siguiente ejemplo de código devolverá el primer `Class.BasePart` hijo, independientemente de si es un `Class.WedgePart` , `Class.MeshPart` o `Class.Part` .

  ```
  local part = object:FindFirstChildWhichIsA("BasePart")
  ```

  Los desarrolladores que buscan un niño por nombre deberían usar `Class.Instance:FindFirstChild()` en su lugar.

Instance:FindFirstChildWhichIsA

Devuelve el primer hijo del `Class.Instance` para quien `Class.Object:IsA()` devuelve verdadero para la clase dada.

Devuelve al primer descendiente encontrado con el dado `Class.Instance.Name` .

  Este método está deshabilitado y no se puede usar.Para encontrar el primer descendiente de una instancia, considere usar el parámetro `recursive` en `Class.Instance:FindFirstChild()` en lugar.

Instance:FindFirstDescendant

Devuelve al primer descendiente encontrado con el dado `Class.Instance.Name` .

Si el `Class.Instance` es un `Class.Actor` , se devuelve el `Class.Actor` mismo.De lo contrario, se devuelve su ancestro más cercano `Class.Actor` .Si ningún ancestro es un `Class.Actor` , el resultado es `nil` .

Instance:GetActor

Devuelve el `Class.Actor` asociado con la Instancia, si hay alguno.

Este método devuelve el valor que se ha asignado al nombre del atributo dado. Si no se ha asignado ningún atributo, se devuelve `nil`.

  Por ejemplo, el siguiente fragmento de código establece y luego obtiene el valor del atributo `InitialPosition` de la instancia:

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

  local part = Workspace.Part
  part:SetAttribute("InitialPosition", part.Position)

  local initialPosition = instance:GetAttribute("InitialPosition")
  print(initialPosition)
  ```

  ##### Ver también

  *   `Class.Instance:SetAttribute()` que establece el atributo con el nombre dado al valor dado.
  *   `Class.Instance:GetAttributes()` que devuelve un diccionario de pares clave-valor para cada uno de los atributos de la instancia.

Instance:GetAttribute

El nombre del atributo que se está recuperando.

El valor que se ha asignado al nombre del atributo dado. Si no se ha asignado ningún atributo, se devuelve `nil`.

Devuelve el valor que se ha asignado al nombre de atributo dado.

Esta función devuelve un evento que se comporta exactamente como el evento `Class.Object.Changed|Changed` , excepto que solo se activa cuando cambia el atributo específico; efectivamente es similar a `Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()` pero para atributos.

  Generalmente es una buena idea usar este método en lugar de una conexión a `Class.Object.Changed|Changed` con una función que verifica el nombre del atributo.Llamadas posteriores a este método en el mismo objeto con el mismo nombre de atributo devuelven el mismo evento.

  El siguiente ejemplo de código devuelve una señal que activa la función `attributeChanged()` cuando cambia el atributo `InitialPosition` de la parte:

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

  local part = Workspace.Part
  part:SetAttribute("InitialPosition", part.Position)

  local function attributeChanged()
  	print("Attribute changed")
  end

  part:GetAttributeChangedSignal("InitialPosition"):Connect(attributeChanged)
  ```

  Vea también `Class.Instance.AttributeChanged` que se activa cada vez que se cambia cualquier atributo en la instancia.

Instance:GetAttributeChangedSignal

El nombre del atributo especificado para el cual se devuelve la señal de cambio.

Un evento que se activa cuando cambia el atributo dado.

Devuelve un evento que se activa cuando cambia el atributo dado.

Este método devuelve un diccionario de pares clave-valor para cada atributo donde la clave es el nombre del atributo y el valor es un valor no `nil` no.

  Por ejemplo, el siguiente fragmento de código produce los atributos y valores de una instancia:

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

  local part = Workspace.Part
  part:SetAttribute("InitialPosition", part.Position)
  part:SetAttribute("CanUse", true)

  for name, value in part:GetAttributes() do
  	print(name .. " = " .. value)
  end
  ```

  Vea también `Class.Instance:GetAttribute()` que devuelve el valor que se ha asignado al nombre del atributo dado.

Instance:GetAttributes

Un diccionario de pares de cuerda → nombre de atributo para cada atributo donde la cuerda es el nombre del atributo y el variante es un valor no nulo.

Devuelve un diccionario de los atributos de la instancia.

The below would print the name of all objects currently in Workspace when ran.

Devuelve un array (una tabla indexada numéricamente) que contiene todos los hijos directos de la instancia, o cada `Class.Instance` cuyo `Class.Instance.Parent|Parent` es igual al objeto.El array se puede iterar al usar un bucle for numérico o genérico:

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

  -- Ejemplo de bucle numérico
  local children = Workspace:GetChildren()
  for i = 1, #children do
  	local child = children[i]
  	print(child.Name .. " is child number " .. i)
  end
  ```

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

  -- Ejemplo genérico de bucle while
  local children = Workspace:GetChildren()
  for i, child in children do
  	print(child.Name .. " is child number " .. i)
  end
  ```

  Los niños se ordenan por el orden en que su propiedad `Class.Instance.Parent|Parent` se estableció al objeto.

  Vea también la función `Class.Instance:GetDescendants()|GetDescendants` .

Instance:GetChildren

Un array que contiene los hijos de la instancia.

Devuelve un array que contiene todos los hijos de la instancia.

Devuelve una cadena codificada del ID de depuración utilizado internamente por Roblox. Tenga en cuenta que:

  *   Este artículo está protegido. Intentar usarlo en un `Class.Script` o `Class.LocalScript` causará un error.
  *   Un ID de depuración es un ID utilizado en procesos de depuración.Permite que un depurador lea cada instrucción antes de que una aplicación la procese.Todos los objetos en Roblox actúan como procesos y cada instrucción de ejecución (o 'código') que se puede depurar si es necesario.
  *   Esto puede ser útil para los plugins que necesitan distinguir objetos similares entre sí (como objetos que comparten el mismo nombre).

Instance:GetDebugId

scopeLength

La cadena de identificación de depuración.

Devuelve una cadena codificada del ID de depuración utilizado internamente por Roblox.

GetDescendants is often used to do something to all the descendants that are a
particular type of object. The code in this example uses GetDescendants and
`Class.Instance:IsA()` to find all of the parts in the workspace and turns
them green.

Este método de objeto devuelve un array que contiene todos los descendientes de ese objeto.A diferencia de `Class.Instance:GetChildren()`, que solo devuelve los hijos inmediatos de un objeto, este método encuentra a todos los hijos del objeto, a todos los hijos de esos hijos, y así sucesivamente.

Instance:GetDescendants

Un array que contiene los descendientes de la instancia.

Devuelve un array que contiene todos los descendientes de la instancia.

This code sample demonstrates the behavior of `Class.Instance:GetFullName()`.
It shows how the function behaves when called on an object not in the
`DataModel` hierarchy, and it also shows how the return value does not escape
special characters.

This code sample re-implements the `Class.Instance:GetFullName()` function in
Lua.

Devuelve una cadena que describe el ancestro de la instancia.La cadena es una concatenación del `Class.Instance.Name|Name` del objeto y sus ancestros, separados por períodos.El `Class.DataModel` ( `game` ) no se considera.Por ejemplo, un `Class.Part` en el `Class.Workspace` puede devolver `Class.Workspace.Part` .

  Cuando se llama a un `Class.Instance` que no es un descendiente del `Class.DataModel` , esta función considera todos los ancestros hasta y, incluido el superior, sin un `Class.Instance.Parent|Parent` .

  Esta función es útil para registrar y depurar.No deberías intentar analizar la cadena devuelta para ninguna operación útil; esta función no escapa períodos (o cualquier otro símbolo) en los nombres de objetos.En otras palabras, aunque su salida a menudo parece ser un identificador válido de Luau, no está garantizada.

Instance:GetFullName

El nombre completo del `Class.Instance` .

Devuelve una cadena que describe el ancestro de la instancia.

Este método devuelve el valor estilizado o modificado explícitamente de la propiedad especificada, o el valor de propiedad predeterminado si no se ha estilizado/modificado.Esto difiere ligeramente de acceder al valor de la propiedad directamente, como `[GuiObject].Rotation`, que devuelve el valor predeterminado o modificado de la propiedad.

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

  local player = Players.LocalPlayer
  local playerGui = player.PlayerGui
  local HUDContainer = playerGui:WaitForChild("HUDContainer")

  local coreSheet = ReplicatedStorage:FindFirstChild("CoreSheet")
  local rule = coreSheet:FindFirstChildWhichIsA("StyleRule")
  rule.Selector = "TextButton"

  -- Referencia a un botón
  local button = HUDContainer:FindFirstChildWhichIsA("TextButton")

  print(button:GetStyled("Rotation")) --> 0 (valor predeterminado)
  print(button.Rotation) --> 0 (valor predeterminado)

  -- Aplicar rotación a través de la propiedad de regla de estilo
  rule:SetProperty("Rotation", 30)

  print(button:GetStyled("Rotation")) --> 30 (valor estilizado basado en regla)
  print(button.Rotation) --> 0 (valor predeterminado)

  -- Modificar/anular explícitamente la propiedad estilizada
  button.Rotation = 45

  print(button:GetStyled("Rotation")) --> 45 (valor modificado)
  print(button.Rotation) --> 45 (modified value)
  ```

Instance:GetStyled

El valor estilizado o modificado explícitamente de la propiedad especificada, o el valor de propiedad predeterminado si no se ha estilizado/modificado.

Devuelve el valor estilizado o modificado explícitamente de la propiedad especificada, o el valor de propiedad predeterminado si no se ha estilizado/modificado.

Este método devuelve un evento que se comporta exactamente como el evento `Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged`, excepto que solo se activa cuando cambia la propiedad de estilo dada.En general, es una buena idea usar este método en lugar de una conexión a `Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged` con una función que verifica el nombre de la propiedad.Llamadas posteriores a este método en el mismo objeto con el mismo nombre de propiedad devuelven el mismo evento.

  Tenga en cuenta que este evento no pasará ningún argumento a una función conectada, por lo que el valor de la propiedad cambiada debe leerse directamente dentro de un script.

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

  local player = Players.LocalPlayer
  local playerGui = player.PlayerGui
  local HUDContainer = playerGui:WaitForChild("HUDContainer")
  local meterBar = HUDContainer.MeterBar

  local function stylePropertyChanged()
  	print("Style property changed!")
  end

  meterBar:GetStyledPropertyChangedSignal("AnchorPoint"):Connect(stylePropertyChanged)
  ```

Instance:GetStyledPropertyChangedSignal

property

Nombre de la propiedad de estilo para la que escuchar cambios.

Evento que se activa cuando cambia la propiedad de estilo dada.

Este método devuelve un array de las etiquetas aplicadas a la instancia dada, como cadenas.Puedes agregar etiquetas en Studio en la ventana [Propiedades](/studio/properties) o en tiempo de ejecución con `Class.Instance:AddTag()|AddTag()`.

  Este método es útil cuando quieres hacer algo con varias etiquetas en una instancia a la vez.Sin embargo, es ineficiente usar este método para verificar la existencia de una etiqueta única; en cambio, use `Class.Instance:HasTag()|HasTag()` para verificar una etiqueta específica.

Instance:GetTags

Obtiene un array de todas las etiquetas aplicadas a la instancia.

Este método devuelve `true` si la etiqueta proporcionada se ha agregado al objeto.Puedes agregar etiquetas en Studio en la ventana [Propiedades](/studio/properties) o en tiempo de ejecución con `Class.Instance:AddTag()|AddTag()`.

Instance:HasTag

Compruebe si la instancia tiene una etiqueta dada.

Demonstrates determining if one instance is the ancestor of another using `Class.Instance:IsAncestorOf()`

Workspace and SpawnLocation are ancestors of the SpawnLocation's decal.
Workspace is an ancestor of SpawnLocation.

SpawnLocation and its decal are descendants of Workspace, not ancenstors.
Decal is a descendant to SpawnLocation, not an ancestor.

Devuelve verdadero si un `Class.Instance` es un ancestro del descendiente dado.

  Un `Class.Instance` se considera el ancestro de un objeto si el `Class.Instance.Parent` o uno de los padres del objeto `Class.Instance.Parent` se establece en el `Class.Instance`.

  Vea también, `Class.Instance:IsDescendantOf()` .

Instance:IsAncestorOf

Verdadero si el `Class.Instance` es un ancestro del descendiente dado.

Devuelve verdadero si un `Class.Instance` es un ancestro del descendiente dado.

Devuelve `true` si un `Class.Instance` es un descendiente del ancestro dado.

  Tenga en cuenta que `IsDescendantOf()` no se puede usar con un parámetro de `nil` para verificar si un objeto se ha eliminado.

  Vea también `Class.Instance:IsAncestorOf()` .

Instance:IsDescendantOf

ancestor

Verdadero si el `Class.Instance` es un descendiente del ancestro dado.

Devuelve `true` si un `Class.Instance` es un descendiente del ancestro dado.

Devuelve `true` si el valor almacenado en la propiedad especificada es igual al código predeterminado instanciado.Por ejemplo, si se imprime la propiedad `Class.TextLabel.TextSize|TextSize` de un `Class.TextLabel` que indica `8` , entonces llamar `IsPropertyModified("TextSize")` a la etiqueta devolverá `false` porque `8` es el valor predeterminado para `Class.TextLabel.TextSize` cuando la etiqueta se crea a través de `Instance.new("TextLabel")` en lugar de insertarse a través de los flujos de trabajo de inserción de Studio.

  Tenga en cuenta que si este método devuelve , el estilo no afectará la propiedad porque modificar explícitamente una propiedad tiene prioridad sobre estilarla.

Instance:IsPropertyModified

Booleano que indica si la propiedad se modifica.

Devuelve `true` si el valor almacenado en la propiedad especificada es igual al código predeterminado instanciado.

The following code demonstrates how a part can be re-added to the DataModel
after being removed:

Esta función establece el `Class.Instance.Parent` del objeto en `nil` , y hace lo mismo con todos sus descendientes.

  Si el objeto se referencia antes de ser eliminado, es posible recuperar el objeto en un punto posterior.

Instance:Remove

Establece el objeto `Parent` a `nil` y hace lo mismo con todos sus descendientes.

Este método elimina una etiqueta de una instancia.No lanzará un error si el objeto no tiene la etiqueta.La eliminación exitosa de una etiqueta disparará una señal creada por `Class.CollectionService:GetInstanceRemovedSignal()` con la etiqueta dada.

  Tenga en cuenta que cuando se etiqueta una instancia, es común que se utilicen algunos recursos para darle al etiqueta su funcionalidad, por ejemplo conexiones de eventos o tablas.Para evitar fugas de memoria, es una buena idea limpiarlas (desconectarse, establecer en `nil` , etc.) cuando ya no se necesitan para una etiqueta.

Instance:RemoveTag

Restablece una propiedad a su valor predeterminado.Por ejemplo, llamar `ResetPropertyToDefault("Rotation")` en un `Class.TextLabel` es equivalente a establecer su `Class.TextLabel.Rotation|Rotation` a `0` (el valor predeterminado de la propiedad).Este método se puede usar para asegurar que el estilo anule el valor predeterminado de esta propiedad.

Instance:ResetPropertyToDefault

Restablece una propiedad a su valor predeterminado.

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`.

IKControl

Muestras de código

Resumen

Propiedades

Métodos

Eventos

Propiedades

ChainRoot

Enabled

EndEffector

EndEffectorOffset

Offset

Pole

Priority

SmoothTime

Target

Type

Weight

Métodos

GetChainCount

Devuelve

GetChainLength

Devuelve

GetNodeLocalCFrame

Parámetros

Devuelve

GetNodeWorldCFrame

Parámetros

Devuelve

GetRawFinalTarget

Devuelve

GetSmoothedFinalTarget

Devuelve

Eventos