# Humanoid

Roblox Engine API class from Roblox Studio 0.744.0.7441077 (version-7aaa6838d36c4448).

- Inherits from, nearest first: [Instance](https://rapi.sleaze.dev/classes/Instance.md), [Object](https://rapi.sleaze.dev/classes/Object.md)
- Memory category: Instances
- HTML page: https://rapi.sleaze.dev/classes/Humanoid/
- Roblox documentation: https://create.roblox.com/docs/reference/engine/classes/Humanoid

A special object that gives models the functionality of a character.

## Properties

### BreakJointsOnDeath

```luau
Humanoid.BreakJointsOnDeath: boolean = true
```

- Tags: Capabilities: AvatarBehavior

Determines whether the humanoid's joints break when in the `HumanoidStateType.Dead` state.

### EvaluateStateMachine

```luau
Humanoid.EvaluateStateMachine: boolean = true
```

- Tags: Capabilities: AvatarBehavior, Simulation access

Used to disable the internal physics and state machine of the Humanoid.

### RequiresNeck

```luau
Humanoid.RequiresNeck: boolean = true
```

- Tags: Capabilities: AvatarBehavior

Allows developers to disable the behavior where a player `Character|character` dies if the Neck [`Motor6D`](https://rapi.sleaze.dev/classes/Motor6D.md) is removed or disconnected even momentarily.

### CollisionType

```luau
Humanoid.CollisionType: Enum.HumanoidCollisionType = Enum.HumanoidCollisionType.OuterBox
```

- Tags: Deprecated, Write: Plugin security

**Deprecated:**

Selects the `HumanoidCollisionType` for R15 and Rthro non-player characters.

### AutoRotate

```luau
Humanoid.AutoRotate: boolean = true
```

- Tags: Capabilities: AvatarBehavior, Simulation access

AutoRotate sets whether or not the Humanoid will automatically rotate to face in the direction they are moving in.

### FloorMaterial

```luau
Humanoid.FloorMaterial: Enum.Material = Enum.Material.Air
```

- Tags: Read only, Capabilities: AvatarBehavior, Simulation access

Describes the `Material` that the [`Humanoid`](https://rapi.sleaze.dev/classes/Humanoid.md) is currently standing on. If the [`Humanoid`](https://rapi.sleaze.dev/classes/Humanoid.md) isn't standing on anything, the value of this property will be *Air*.

### Jump

```luau
Humanoid.Jump: boolean = false
```

- Tags: Not replicated, Capabilities: AvatarBehavior, Load only, Simulation access

If `true`, the [`Humanoid`](https://rapi.sleaze.dev/classes/Humanoid.md) jumps with an upwards force.

### JumpReplicate

```luau
Humanoid.JumpReplicate: boolean = false
```

- Tags: Hidden, Not scriptable, Capabilities: AvatarBehavior, Simulation access

### MoveDirection

```luau
Humanoid.MoveDirection: Vector3 = Vector3.zero
```

- Tags: Read only, Capabilities: AvatarBehavior, Simulation access

Describes the direction that the [`Humanoid`](https://rapi.sleaze.dev/classes/Humanoid.md) is walking in.

### MoveDirectionInternal

```luau
Humanoid.MoveDirectionInternal: Vector3 = Vector3.zero
```

- Tags: Hidden, Not scriptable, Capabilities: AvatarBehavior, Simulation access

### PlatformStand

```luau
Humanoid.PlatformStand: boolean = false
```

- Tags: Capabilities: AvatarBehavior

Determines whether the [`Humanoid`](https://rapi.sleaze.dev/classes/Humanoid.md) is currently in the `HumanoidStateType.PlatformStanding` state.

### SeatPart

```luau
Humanoid.SeatPart: BasePart
```

- Tags: Read only, Capabilities: AvatarBehavior, Simulation access

A reference to the seat that a [`Humanoid`](https://rapi.sleaze.dev/classes/Humanoid.md) is currently sitting in, if any.

### Sit

```luau
Humanoid.Sit: boolean = false
```

- Tags: Capabilities: AvatarBehavior, Simulation access

Describes whether the [`Humanoid`](https://rapi.sleaze.dev/classes/Humanoid.md) is currently sitting.

### Strafe

```luau
Humanoid.Strafe: boolean = false
```

- Tags: Hidden, Not scriptable, Capabilities: AvatarBehavior, Simulation access

### TargetPoint

```luau
Humanoid.TargetPoint: Vector3 = Vector3.zero
```

- Tags: Capabilities: AvatarBehavior

Describes the 3D position where the [`Player`](https://rapi.sleaze.dev/classes/Player.md) controlling the [`Humanoid`](https://rapi.sleaze.dev/classes/Humanoid.md) last clicked in the world while using a [`Tool`](https://rapi.sleaze.dev/classes/Tool.md).

### WalkAngleError

```luau
Humanoid.WalkAngleError: number = 0
```

- Tags: Hidden, Not scriptable, Capabilities: AvatarBehavior

### WalkDirection

```luau
Humanoid.WalkDirection: Vector3 = Vector3.zero
```

- Tags: Hidden, Not scriptable, Capabilities: AvatarBehavior, Simulation access

### WalkToPart

```luau
Humanoid.WalkToPart: BasePart
```

- Tags: Capabilities: AvatarBehavior

A reference to a part whose position is trying to be reached by a humanoid.

### WalkToPoint

```luau
Humanoid.WalkToPoint: Vector3 = Vector3.zero
```

- Tags: Capabilities: AvatarBehavior, Simulation access

The position that a humanoid is trying to reach, after a call to [`Humanoid:MoveTo()`](https://rapi.sleaze.dev/classes/Humanoid.md) is made.

### CameraMaxDistance

```luau
Humanoid.CameraMaxDistance: number = 400
```

- Tags: Hidden, Not scriptable, Capabilities: AvatarAppearance

### CameraMinDistance

```luau
Humanoid.CameraMinDistance: number = 0
```

- Tags: Hidden, Not scriptable, Capabilities: AvatarAppearance

### CameraMode

```luau
Humanoid.CameraMode: Enum.CameraMode = Enum.CameraMode.Classic
```

- Tags: Hidden, Not scriptable, Capabilities: AvatarBehavior

### CameraOffset

```luau
Humanoid.CameraOffset: Vector3 = Vector3.zero
```

- Tags: Capabilities: AvatarBehavior

An offset applied to the Camera's subject position when its CameraSubject is set to this Humanoid.

### DisplayDistanceType

```luau
Humanoid.DisplayDistanceType: Enum.HumanoidDisplayDistanceType = Enum.HumanoidDisplayDistanceType.Viewer
```

- Tags: Capabilities: AvatarAppearance

Controls the distance behavior of the humanoid's name and health display.

### DisplayName

```luau
Humanoid.DisplayName: string = ""
```

- Tags: Capabilities: AvatarAppearance

Sets the text of a Humanoid, displayed above their head.

### FinishedState

```luau
Humanoid.FinishedState: boolean = false
```

- Tags: Hidden, Not scriptable, Capabilities: AvatarBehavior, Simulation access

### HealthDisplayDistance

```luau
Humanoid.HealthDisplayDistance: number = 100
```

- Tags: Capabilities: AvatarAppearance

Used in conjunction with the [`DisplayDistanceType`](https://rapi.sleaze.dev/classes/Humanoid.md) property to control the distance from which a humanoid's health bar can be seen.

### HealthDisplayType

```luau
Humanoid.HealthDisplayType: Enum.HumanoidHealthDisplayType = Enum.HumanoidHealthDisplayType.DisplayWhenDamaged
```

- Tags: Capabilities: AvatarAppearance

Controls when the humanoid's health bar is allowed to be displayed.

### InternalAvatarRulesRootPartSize

```luau
Humanoid.InternalAvatarRulesRootPartSize: Vector3 = Vector3.zero
```

- Tags: Hidden, Not scriptable, Capabilities: AvatarAppearance

### InternalAvatarRulesRootPartSizeScalesWithBody

```luau
Humanoid.InternalAvatarRulesRootPartSizeScalesWithBody: boolean = false
```

- Tags: Hidden, Not scriptable, Capabilities: AvatarAppearance

### InternalBodyScale

```luau
Humanoid.InternalBodyScale: Vector3 = Vector3.one
```

- Tags: Hidden, Not replicated, Not scriptable, Capabilities: AvatarAppearance

### InternalDisplayName

```luau
Humanoid.InternalDisplayName: string = ""
```

- Tags: Hidden, Not replicated, Roblox script security

### InternalHeadScale

```luau
Humanoid.InternalHeadScale: number = 1
```

- Tags: Hidden, Not replicated, Not scriptable, Capabilities: AvatarAppearance

### InternalOriginalHipHeight

```luau
Humanoid.InternalOriginalHipHeight: number = 0
```

- Tags: Hidden, Not scriptable, Capabilities: AvatarAppearance

### NameDisplayDistance

```luau
Humanoid.NameDisplayDistance: number = 100
```

- Tags: Capabilities: AvatarAppearance

Used in conjunction with the [`Humanoid.DisplayDistanceType`](https://rapi.sleaze.dev/classes/Humanoid.md) property to control the distance from which a humanoid's name can be seen.

### NameOcclusion

```luau
Humanoid.NameOcclusion: Enum.NameOcclusion = Enum.NameOcclusion.OccludeAll
```

- Tags: Capabilities: AvatarAppearance

Controls whether a humanoid's name and health bar can be seen behind walls or other objects.

### NetworkHumanoidState

```luau
Humanoid.NetworkHumanoidState: Enum.HumanoidStateType = Enum.HumanoidStateType.FallingDown
```

- Tags: Hidden, Not scriptable, Capabilities: AvatarBehavior, Simulation access

### NoFloorTimerState

```luau
Humanoid.NoFloorTimerState: number = 0
```

- Tags: Hidden, Not scriptable, Capabilities: AvatarBehavior, Simulation access

### OverrideDefaultCollisions

```luau
Humanoid.OverrideDefaultCollisions: boolean = false
```

- Tags: Hidden, Not scriptable, Roblox engine security

### RigType

```luau
Humanoid.RigType: Enum.HumanoidRigType = Enum.HumanoidRigType.R6
```

- Tags: Capabilities: AvatarAppearance

Describes whether this [`Humanoid`](https://rapi.sleaze.dev/classes/Humanoid.md) is utilizing the legacy R6 character rig, or the new R15 character rig.

### RootPart

```luau
Humanoid.RootPart: BasePart
```

- Tags: Read only, Capabilities: AvatarBehavior, Save only, Simulation access

A reference to the humanoid's `HumanoidRootPart` object.

### RotationType

```luau
Humanoid.RotationType: Enum.RotationType = Enum.RotationType.MovementRelative
```

- Tags: Hidden, Not scriptable, Roblox engine security

### TimerState

```luau
Humanoid.TimerState: number = 0
```

- Tags: Hidden, Not scriptable, Capabilities: AvatarBehavior, Simulation access

### LeftLeg

```luau
Humanoid.LeftLeg: BasePart
```

- Tags: Deprecated, Hidden, Not replicated, Capabilities: AvatarBehavior, Load only

**Deprecated:** This instance only works with the old R6 rig. It will not work with the R15 rig and should not be used in new work not using the R6 rig.

A reference to the humanoid's *Left Leg* part.

### RightLeg

```luau
Humanoid.RightLeg: BasePart
```

- Tags: Deprecated, Hidden, Not replicated, Capabilities: AvatarBehavior, Load only

**Deprecated:** This instance only works with the old R6 rig. It will not work with the R15 rig and should not be used in new work not using the R6 rig.

A reference to the humanoid's *Right Leg* part.

### Torso

```luau
Humanoid.Torso: BasePart
```

- Tags: Deprecated, Hidden, Not replicated, Capabilities: AvatarBehavior, Load only

**Deprecated:** This instance only works with the old R6 rig. It will not work with the R15 rig and should not be used in new work not using the R6 rig.

A reference to a humanoid's root driving part.

### AutomaticScalingEnabled

```luau
Humanoid.AutomaticScalingEnabled: boolean = true
```

- Tags: Capabilities: AvatarAppearance

When Enabled, AutomaticScalingEnabled causes the size of the character to change in response to the values in the humanoid's child scale values changing.

### Health

```luau
Humanoid.Health: number = 100
```

- Tags: Not replicated, Capabilities: AvatarBehavior, Load only

Describes the current health of the Humanoid on the range [0, [`Humanoid.MaxHealth`](https://rapi.sleaze.dev/classes/Humanoid.md)].

### Health_XML

```luau
Humanoid.Health_XML: number = 100
```

- Tags: Hidden, Not scriptable, Capabilities: AvatarBehavior

### HipHeight

```luau
Humanoid.HipHeight: number = 0
```

- Tags: Capabilities: AvatarAppearance, Simulation access

Determines the distance off the ground the [`Humanoid.RootPart`](https://rapi.sleaze.dev/classes/Humanoid.md) should be.

### MaxHealth

```luau
Humanoid.MaxHealth: number = 100
```

- Tags: Capabilities: AvatarBehavior

The maximum value of a humanoid's [`Health`](https://rapi.sleaze.dev/classes/Humanoid.md).

### MaxSlopeAngle

```luau
Humanoid.MaxSlopeAngle: number = 89
```

- Tags: Capabilities: AvatarBehavior

The maximum slope angle that a humanoid can walk on without slipping.

### WalkSpeed

```luau
Humanoid.WalkSpeed: number = 16
```

- Tags: Capabilities: AvatarBehavior, Simulation access

Describes the humanoid's maximum movement speed in studs per second.

### maxHealth

```luau
Humanoid.maxHealth: number = 100
```

- Tags: Deprecated, Not replicated, Capabilities: AvatarBehavior, Load only
- Use instead: [`Humanoid.MaxHealth`](https://rapi.sleaze.dev/classes/Humanoid.md)

**Deprecated:** This deprecated property is a variant of [`Humanoid.MaxHealth`](https://rapi.sleaze.dev/classes/Humanoid.md) which should be used instead.

### AutoJumpEnabled

```luau
Humanoid.AutoJumpEnabled: boolean = true
```

- Tags: Capabilities: AvatarBehavior, Simulation access

Sets whether the character will automatically jump when they hit an obstacle as a player on a mobile device.

### JumpHeight

```luau
Humanoid.JumpHeight: number = 7.19999981
```

- Tags: Capabilities: AvatarBehavior, Simulation access

Provides control over the height that the [`Humanoid`](https://rapi.sleaze.dev/classes/Humanoid.md) jumps to.

### JumpPower

```luau
Humanoid.JumpPower: number = 50
```

- Tags: Capabilities: AvatarBehavior, Simulation access

Determines how much upwards force is applied to the [`Humanoid`](https://rapi.sleaze.dev/classes/Humanoid.md) when jumping.

### UseJumpPower

```luau
Humanoid.UseJumpPower: boolean = true
```

- Tags: Capabilities: AvatarBehavior, Simulation access

Determines whether the [`JumpHeight`](https://rapi.sleaze.dev/classes/Humanoid.md) (false) or [`Humanoid.JumpPower`](https://rapi.sleaze.dev/classes/Humanoid.md) (true) property is used.

## Methods

### AddAccessory

```luau
Humanoid:AddAccessory(accessory: Instance)
```

- Tags: Capabilities: AvatarAppearance

Attaches the specified [`Accessory`](https://rapi.sleaze.dev/classes/Accessory.md) to the humanoid's parent.

Parameters:

- `accessory`: The [`Accessory`](https://rapi.sleaze.dev/classes/Accessory.md) to be attached.

### ApplyAvatarRulesAsync

```luau
Humanoid:ApplyAvatarRulesAsync(avatarRules: any)
```

- Tags: Yields, Capabilities: AvatarAppearance

### ApplyDescriptionAsync

```luau
Humanoid:ApplyDescriptionAsync(humanoidDescription: HumanoidDescription, assetTypeVerification: Enum.AssetTypeVerification? = Enum.AssetTypeVerification.Default)
```

- Tags: Yields, Capabilities: AvatarAppearance

Makes the character's look match that of the passed in [`HumanoidDescription`](https://rapi.sleaze.dev/classes/HumanoidDescription.md). If `UseAvatarSettings` is true, the Avatar Settings for the experience will also be applied to the character.

Parameters:

- `humanoidDescription`: The [`HumanoidDescription`](https://rapi.sleaze.dev/classes/HumanoidDescription.md) instance which you want to set the character to match.
- `assetTypeVerification`: The asset type verification mode.

### ApplyDescriptionResetAsync

```luau
Humanoid:ApplyDescriptionResetAsync(humanoidDescription: HumanoidDescription, assetTypeVerification: Enum.AssetTypeVerification? = Enum.AssetTypeVerification.Default)
```

- Tags: Yields, Capabilities: AvatarAppearance

Makes the character's look match that of the passed in [`HumanoidDescription`](https://rapi.sleaze.dev/classes/HumanoidDescription.md), even after external changes.

Parameters:

- `humanoidDescription`: The [`HumanoidDescription`](https://rapi.sleaze.dev/classes/HumanoidDescription.md) instance which you want to set the character to match.
- `assetTypeVerification`: The asset type verification mode.

### BuildRigFromAttachments

```luau
Humanoid:BuildRigFromAttachments()
```

- Tags: Capabilities: AvatarBehavior

Assembles a tree of [`Motor6D`](https://rapi.sleaze.dev/classes/Motor6D.md) joints by attaching together [`Attachment`](https://rapi.sleaze.dev/classes/Attachment.md) objects in a humanoid's character.

### CacheDefaults

```luau
Humanoid:CacheDefaults()
```

- Tags: Roblox script security

### ChangeState

```luau
Humanoid:ChangeState(state: Enum.HumanoidStateType? = Enum.HumanoidStateType.None)
```

- Tags: Capabilities: AvatarBehavior, Simulation access

Sets the [`Humanoid`](https://rapi.sleaze.dev/classes/Humanoid.md) to enter the given `HumanoidStateType`.

Parameters:

- `state`: The `HumanoidStateType` that the [`Humanoid`](https://rapi.sleaze.dev/classes/Humanoid.md) is to perform.

### ComputeOriginalSizeForPart

```luau
Humanoid:ComputeOriginalSizeForPart(part: Instance): Vector3?
```

- Tags: Roblox script security

### ComputeR15BodyBoundingBox

```luau
Humanoid:ComputeR15BodyBoundingBox(): (CFrame, Vector3)
```

- Tags: Roblox script security

### EquipTool

```luau
Humanoid:EquipTool(tool: Instance)
```

- Tags: Capabilities: AvatarBehavior

Makes the [`Humanoid`](https://rapi.sleaze.dev/classes/Humanoid.md) equip the given [`Tool`](https://rapi.sleaze.dev/classes/Tool.md).

Parameters:

- `tool`: The [`Tool`](https://rapi.sleaze.dev/classes/Tool.md) to equip.

### GetAccessories

```luau
Humanoid:GetAccessories(): { any }
```

- Tags: Capabilities: AvatarAppearance

Returns an array of [`Accessory`](https://rapi.sleaze.dev/classes/Accessory.md) objects that the humanoid's parent is currently wearing.

Returns: An array of [`Accessory`](https://rapi.sleaze.dev/classes/Accessory.md) objects that are parented to the humanoid's parent.

### GetAccessoryHandleScale

```luau
Humanoid:GetAccessoryHandleScale(instance: Instance, partType: Enum.BodyPartR15): Vector3
```

- Tags: Roblox script security

### GetAppliedDescription

```luau
Humanoid:GetAppliedDescription(): HumanoidDescription
```

- Tags: Capabilities: AvatarAppearance

Returns a copy of the humanoid's cached [`HumanoidDescription`](https://rapi.sleaze.dev/classes/HumanoidDescription.md) which describes its current look.

Returns: A copy of the [`HumanoidDescription`](https://rapi.sleaze.dev/classes/HumanoidDescription.md) currently applied to the humanoid.

### GetBodyPartR15

```luau
Humanoid:GetBodyPartR15(part: Instance): Enum.BodyPartR15
```

- Tags: Capabilities: AvatarBehavior

Pass a body part to this method (the body part should be a sibling of Humanoid, and a child of a Model) to get the `BodyPartR15` of the [`Part`](https://rapi.sleaze.dev/classes/Part.md).

Parameters:

- `part`: The specified part being checked to see if it is an R15 body part.

Returns: The specified part's R15 body part type or unknown if the part is not a body part.

### GetLimb

```luau
Humanoid:GetLimb(part: Instance): Enum.Limb
```

- Tags: Capabilities: AvatarBehavior

Returns the `Limb` enum that is associated with the given [`Part`](https://rapi.sleaze.dev/classes/Part.md).

Parameters:

- `part`: The [`Part`](https://rapi.sleaze.dev/classes/Part.md) for which the [`Enum.Limb`](https://rapi.sleaze.dev/enums/Limb.md) is to be retrieved.

Returns: The `Limb` the part corresponds with.

### GetMoveVelocity

```luau
Humanoid:GetMoveVelocity(): Vector3
```

- Tags: Capabilities: AvatarBehavior

Returns the current intended movement velocity of the Humanoid.

Returns: A [`Vector3`](https://rapi.sleaze.dev/index/types/Vector3.md) representing the Humanoid's intended movement velocity in world space.

### GetRelativeVelocityAtFloor

```luau
Humanoid:GetRelativeVelocityAtFloor(): Vector3
```

- Tags: Capabilities: AvatarBehavior, Simulation access

Returns the humanoid's actual physical velocity relative to the surface it is standing on as a [`Vector3`](https://rapi.sleaze.dev/index/types/Vector3.md) in world-space orientation.

Returns: The humanoid's velocity relative to the floor surface, as a [`Vector3`](https://rapi.sleaze.dev/index/types/Vector3.md) in world-space orientation. Returns `(0, 0, 0)` if the humanoid has no root part.

### GetState

```luau
Humanoid:GetState(): Enum.HumanoidStateType
```

- Tags: Thread safe, Capabilities: AvatarBehavior, Simulation access

Returns the humanoid's current `HumanoidStateType`.

Returns: The current `HumanoidStateType` of the [`Humanoid`](https://rapi.sleaze.dev/classes/Humanoid.md).

### GetStateEnabled

```luau
Humanoid:GetStateEnabled(state: Enum.HumanoidStateType): boolean
```

- Tags: Thread safe, Capabilities: AvatarBehavior, Simulation access

Returns whether a `HumanoidStateType` is enabled for the [`Humanoid`](https://rapi.sleaze.dev/classes/Humanoid.md).

Parameters:

- `state`: The given `HumanoidStateType`.

Returns: Whether the given `HumanoidStateType` is enabled.

### Move

```luau
Humanoid:Move(moveDirection: Vector3, relativeToCamera: boolean? = false)
```

- Tags: Capabilities: AvatarBehavior, Simulation access

Causes the [`Humanoid`](https://rapi.sleaze.dev/classes/Humanoid.md) to walk in the given direction.

Parameters:

- `moveDirection`: The direction to walk in.
- `relativeToCamera`: Set to `true` if the `moveDirection` parameter should be taken as relative to the `CurrentCamera`.

### MoveTo

```luau
Humanoid:MoveTo(location: Vector3, part: Instance? = nil)
```

- Tags: Capabilities: AvatarBehavior, Simulation access

Causes the [`Humanoid`](https://rapi.sleaze.dev/classes/Humanoid.md) to attempt to walk to the given location by setting the [`Humanoid.WalkToPoint`](https://rapi.sleaze.dev/classes/Humanoid.md) and [`Humanoid.WalkToPart`](https://rapi.sleaze.dev/classes/Humanoid.md) properties.

Parameters:

- `location`: The position to set [`Humanoid.WalkToPoint`](https://rapi.sleaze.dev/classes/Humanoid.md) to.
- `part`: The [`BasePart`](https://rapi.sleaze.dev/classes/BasePart.md) to set [`Humanoid.WalkToPart`](https://rapi.sleaze.dev/classes/Humanoid.md) to.

### PlayEmoteAndGetAnimTrackById

```luau
Humanoid:PlayEmoteAndGetAnimTrackById(emoteId: number): ...any
```

- Tags: Yields, Roblox script security

### PlayEmoteAsync

```luau
Humanoid:PlayEmoteAsync(emoteName: string): boolean
```

- Tags: Yields, Capabilities: AvatarBehavior

Plays emotes and returns if was successfully ran.

Parameters:

- `emoteName`: name of the emote to play.

Returns: successfully played.

### RemoveAccessories

```luau
Humanoid:RemoveAccessories()
```

- Tags: Capabilities: AvatarAppearance

Removes all [`Accessory`](https://rapi.sleaze.dev/classes/Accessory.md) objects worn by the humanoid's parent.

### ReplaceBodyPartR15

```luau
Humanoid:ReplaceBodyPartR15(bodyPart: Enum.BodyPartR15, part: BasePart): boolean
```

- Tags: Capabilities: AvatarAppearance

Dynamically replaces a Humanoid body part with a different part.

Parameters:

- `bodyPart`: The body part to replace. `BodyPartR15.Unknown` will fail.
- `part`: The [`Part`](https://rapi.sleaze.dev/classes/Part.md) [`Instance`](https://rapi.sleaze.dev/classes/Instance.md) which will be parented to the character.

Returns: Whether the body part replacement was successful; returns false if the specified body part could not be found in the character.

### SetClickToWalkEnabled

```luau
Humanoid:SetClickToWalkEnabled(enabled: boolean)
```

- Tags: Roblox script security

### SetStateEnabled

```luau
Humanoid:SetStateEnabled(state: Enum.HumanoidStateType, enabled: boolean)
```

- Tags: Capabilities: AvatarBehavior, Simulation access

Sets whether a given `HumanoidStateType` is enabled for the [`Humanoid`](https://rapi.sleaze.dev/classes/Humanoid.md).

Parameters:

- `state`: The `HumanoidStateType` to be enabled or disabled.
- `enabled`: `true` if `state` is to be enabled, `false` if `state` is to be disabled.

### TakeDamage

```luau
Humanoid:TakeDamage(amount: number)
```

- Tags: Capabilities: AvatarBehavior

Lowers the [`Humanoid.Health`](https://rapi.sleaze.dev/classes/Humanoid.md) of the [`Humanoid`](https://rapi.sleaze.dev/classes/Humanoid.md) by the given *amount* if it is not protected by a [`ForceField`](https://rapi.sleaze.dev/classes/ForceField.md).

Parameters:

- `amount`: The damage, or amount to be deduced from the [`Humanoid.Health`](https://rapi.sleaze.dev/classes/Humanoid.md).

### UnequipTools

```luau
Humanoid:UnequipTools()
```

- Tags: Capabilities: AvatarBehavior

Unequips any [`Tool`](https://rapi.sleaze.dev/classes/Tool.md) currently equipped by the [`Humanoid`](https://rapi.sleaze.dev/classes/Humanoid.md).

### AddCustomStatus

```luau
Humanoid:AddCustomStatus(status: string): boolean
```

- Tags: Deprecated

**Deprecated:** This item is deprecated, as it was a part of the unfinished RbxStatus library which would have allowed you to add conditions to a Humanoid. Do not use it for new work.

Adds a custom status to the Humanoid.

Parameters:

- `status`: The custom status name to add to the Humanoid.

Returns: Whether the custom status was successfully added; returns false if it already exists.

### AddStatus

```luau
Humanoid:AddStatus(status: Enum.Status? = Enum.Status.Poison): boolean
```

- Tags: Deprecated

**Deprecated:** This item is deprecated, as it was a part of the unfinished RbxStatus library which would have allowed you to add conditions to a Humanoid. Do not use it for new work.

Adds a BoolValue to the Humanoid's *Status* object.

Parameters:

- `status`: The [`Status`](https://rapi.sleaze.dev/classes/Status.md) value to add to the Humanoid.

Returns: Whether the status was successfully added; returns false if it already exists.

### ApplyAvatarRules

```luau
Humanoid:ApplyAvatarRules(avatarRules: any)
```

- Tags: Deprecated, Yields, Roblox script security
- Use instead: [`Humanoid.ApplyAvatarRulesAsync`](https://rapi.sleaze.dev/classes/Humanoid.md)

### ApplyDescription

```luau
Humanoid:ApplyDescription(humanoidDescription: HumanoidDescription, assetTypeVerification: Enum.AssetTypeVerification? = Enum.AssetTypeVerification.Default)
```

- Tags: Deprecated, Yields, Capabilities: AvatarAppearance
- Use instead: [`Humanoid.ApplyDescriptionAsync`](https://rapi.sleaze.dev/classes/Humanoid.md)

**Deprecated:** This method has been superseded by [`ApplyDescriptionAsync()`](https://rapi.sleaze.dev/classes/Humanoid.md).

Makes the character's look match that of the passed in [`HumanoidDescription`](https://rapi.sleaze.dev/classes/HumanoidDescription.md).

Parameters:

- `humanoidDescription`: The [`HumanoidDescription`](https://rapi.sleaze.dev/classes/HumanoidDescription.md) instance which you want to set the character to match.
- `assetTypeVerification`: The asset type verification mode.

### ApplyDescriptionReset

```luau
Humanoid:ApplyDescriptionReset(humanoidDescription: HumanoidDescription, assetTypeVerification: Enum.AssetTypeVerification? = Enum.AssetTypeVerification.Default)
```

- Tags: Deprecated, Yields, Capabilities: AvatarAppearance
- Use instead: [`Humanoid.ApplyDescriptionResetAsync`](https://rapi.sleaze.dev/classes/Humanoid.md)

**Deprecated:** This method has been superseded by [`ApplyDescriptionResetAsync()`](https://rapi.sleaze.dev/classes/Humanoid.md).

Makes the character's look match that of the passed in [`HumanoidDescription`](https://rapi.sleaze.dev/classes/HumanoidDescription.md), even after external changes.

Parameters:

- `humanoidDescription`: The [`HumanoidDescription`](https://rapi.sleaze.dev/classes/HumanoidDescription.md) instance which you want to set the character to match.
- `assetTypeVerification`: The asset type verification mode.

### GetPlayingAnimationTracks

```luau
Humanoid:GetPlayingAnimationTracks(): { any }
```

- Tags: Deprecated, Capabilities: Animation
- Use instead: [`Humanoid.GetPlayingAnimationTracks`](https://rapi.sleaze.dev/classes/Humanoid.md)

**Deprecated:**

Returns an array of all `AnimationTracks` that are currently being played on the [`Humanoid`](https://rapi.sleaze.dev/classes/Humanoid.md).

Returns: An array of currently playing `AnimationTracks`.

### GetStatuses

```luau
Humanoid:GetStatuses(): { any }
```

- Tags: Deprecated

**Deprecated:** This item is deprecated, as it was a part of the unfinished RbxStatus library which would have allowed you to add conditions to a Humanoid. Do not use it for new work.

Returns a table of the Humanoid's statuses, and custom statuses.

Returns: An array of strings representing the names of all statuses currently applied to the Humanoid.

### HasCustomStatus

```luau
Humanoid:HasCustomStatus(status: string): boolean
```

- Tags: Deprecated

**Deprecated:** This item is deprecated, as it was a part of the unfinished RbxStatus library which would have allowed you to add conditions to a Humanoid. Do not use it for new work.

Returns boolean based on if custom statuses exist.

Parameters:

- `status`: The custom status name to check for.

Returns: Whether the specified custom status exists on the Humanoid.

### HasStatus

```luau
Humanoid:HasStatus(status: Enum.Status? = Enum.Status.Poison): boolean
```

- Tags: Deprecated

**Deprecated:** This item is deprecated, as it was a part of the unfinished RbxStatus library which would have allowed you to add conditions to a Humanoid. Do not use it for new work.

Returns a boolean based on if a status exists.

Parameters:

- `status`: The [`Status`](https://rapi.sleaze.dev/classes/Status.md) value to check for.

Returns: Whether the specified status exists on the Humanoid.

### LoadAnimation

```luau
Humanoid:LoadAnimation(animation: Animation): AnimationTrack
```

- Tags: Deprecated, Capabilities: Animation, Simulation access
- Use instead: [`Humanoid.LoadAnimation`](https://rapi.sleaze.dev/classes/Humanoid.md)

**Deprecated:** This function is deprecated in favor of using [`Animator:LoadAnimation()`](https://rapi.sleaze.dev/classes/Animator.md) directly (the [`Animator`](https://rapi.sleaze.dev/classes/Animator.md) may be created while editing or at runtime).

Loads an [`Animation`](https://rapi.sleaze.dev/classes/Animation.md) onto a [`Humanoid`](https://rapi.sleaze.dev/classes/Humanoid.md), returning an [`AnimationTrack`](https://rapi.sleaze.dev/classes/AnimationTrack.md) that can be used for playback.

Parameters:

- `animation`: The [`Animation`](https://rapi.sleaze.dev/classes/Animation.md) to load.

Returns: The [`AnimationTrack`](https://rapi.sleaze.dev/classes/AnimationTrack.md) created from the loaded [`Animation`](https://rapi.sleaze.dev/classes/Animation.md).

### PlayEmote

```luau
Humanoid:PlayEmote(emoteName: string): boolean
```

- Tags: Deprecated, Yields, Capabilities: AvatarBehavior
- Use instead: [`Humanoid.PlayEmoteAsync`](https://rapi.sleaze.dev/classes/Humanoid.md)

**Deprecated:** This method has been superseded by [`PlayEmoteAsync()`](https://rapi.sleaze.dev/classes/Humanoid.md).

Plays emotes and returns if was successfully ran.

Parameters:

- `emoteName`: name of the emote to play.

Returns: successfully played.

### RemoveCustomStatus

```luau
Humanoid:RemoveCustomStatus(status: string): boolean
```

- Tags: Deprecated

**Deprecated:** This item is deprecated, as it was a part of the unfinished RbxStatus library which would have allowed you to add conditions to a Humanoid. Do not use it for new work.

Removes the defined custom status from the Status model in the Humanoid..

Parameters:

- `status`: The custom status name to remove from the Humanoid.

Returns: Whether the custom status was successfully removed; returns false if it does not exist.

### RemoveStatus

```luau
Humanoid:RemoveStatus(status: Enum.Status? = Enum.Status.Poison): boolean
```

- Tags: Deprecated

**Deprecated:** This item is deprecated, as it was a part of the unfinished RbxStatus library which would have allowed you to add conditions to a Humanoid. Do not use it for new work.

Removes the defined status from the Status model in the Humanoid.

Parameters:

- `status`: The [`Status`](https://rapi.sleaze.dev/classes/Status.md) value to remove from the Humanoid.

Returns: Whether the status was successfully removed; returns false if it does not exist.

### loadAnimation

```luau
Humanoid:loadAnimation(animation: Animation): AnimationTrack
```

- Tags: Deprecated, Capabilities: Animation, Simulation access
- Use instead: [`Humanoid.LoadAnimation`](https://rapi.sleaze.dev/classes/Humanoid.md)

**Deprecated:** This deprecated method is a variant of [`Humanoid:LoadAnimation()`](https://rapi.sleaze.dev/classes/Humanoid.md). [`Animator:LoadAnimation()`](https://rapi.sleaze.dev/classes/Animator.md) should be used instead.

### takeDamage

```luau
Humanoid:takeDamage(amount: number)
```

- Tags: Deprecated, Capabilities: AvatarBehavior
- Use instead: [`Humanoid.TakeDamage`](https://rapi.sleaze.dev/classes/Humanoid.md)

**Deprecated:** This deprecated method is a variant of [`Humanoid:TakeDamage()`](https://rapi.sleaze.dev/classes/Humanoid.md), which should be used instead.

## Events

### ApplyDescriptionFinished

```luau
Humanoid.ApplyDescriptionFinished: RBXScriptSignal<(description: HumanoidDescription)>
```

- Tags: Capabilities: AvatarAppearance

Fires when a [`HumanoidDescription`](https://rapi.sleaze.dev/classes/HumanoidDescription.md) has finished being applied to the [`Humanoid`](https://rapi.sleaze.dev/classes/Humanoid.md).

### Climbing

```luau
Humanoid.Climbing: RBXScriptSignal<(speed: number)>
```

- Tags: Capabilities: AvatarBehavior

Fires when the speed at which a [`Humanoid`](https://rapi.sleaze.dev/classes/Humanoid.md) is climbing changes.

### ClusterCompositionFinished

```luau
Humanoid.ClusterCompositionFinished: RBXScriptSignal<()>
```

- Tags: Roblox script security

### Died

```luau
Humanoid.Died: RBXScriptSignal<()>
```

- Tags: Capabilities: AvatarBehavior

Fires when the [`Humanoid`](https://rapi.sleaze.dev/classes/Humanoid.md) dies.

### EmoteTriggered

```luau
Humanoid.EmoteTriggered: RBXScriptSignal<(success: boolean, animationTrack: AnimationTrack)>
```

- Tags: Roblox script security

### FallingDown

```luau
Humanoid.FallingDown: RBXScriptSignal<(active: boolean)>
```

- Tags: Capabilities: AvatarBehavior

Fires when the [`Humanoid`](https://rapi.sleaze.dev/classes/Humanoid.md) enters or leaves the [`FallingDown`](https://rapi.sleaze.dev/classes/Humanoid.md) `HumanoidStateType`.

### FreeFalling

```luau
Humanoid.FreeFalling: RBXScriptSignal<(active: boolean)>
```

- Tags: Capabilities: AvatarBehavior

Fires when the [`Humanoid`](https://rapi.sleaze.dev/classes/Humanoid.md) enters or leaves the `Freefall` `HumanoidStateType`.

### GettingUp

```luau
Humanoid.GettingUp: RBXScriptSignal<(active: boolean)>
```

- Tags: Capabilities: AvatarBehavior

Fires when the [`Humanoid`](https://rapi.sleaze.dev/classes/Humanoid.md) enters or leaves the [`GettingUp`](https://rapi.sleaze.dev/classes/Humanoid.md) `HumanoidStateType`.

### HealthChanged

```luau
Humanoid.HealthChanged: RBXScriptSignal<(health: number)>
```

- Tags: Capabilities: AvatarBehavior

Fires when the [`Humanoid.Health`](https://rapi.sleaze.dev/classes/Humanoid.md) changes (or when the [`Humanoid.MaxHealth`](https://rapi.sleaze.dev/classes/Humanoid.md) is set).

### Jumping

```luau
Humanoid.Jumping: RBXScriptSignal<(active: boolean)>
```

- Tags: Capabilities: AvatarBehavior

Fires when the [`Humanoid`](https://rapi.sleaze.dev/classes/Humanoid.md) enters and leaves the [`Jumping`](https://rapi.sleaze.dev/classes/Humanoid.md) `HumanoidStateType`.

### MoveToFinished

```luau
Humanoid.MoveToFinished: RBXScriptSignal<(reached: boolean)>
```

- Tags: Capabilities: AvatarBehavior

Fires when the [`Humanoid`](https://rapi.sleaze.dev/classes/Humanoid.md) finishes walking to a goal declared by [`Humanoid:MoveTo()`](https://rapi.sleaze.dev/classes/Humanoid.md).

### PlatformStanding

```luau
Humanoid.PlatformStanding: RBXScriptSignal<(active: boolean)>
```

- Tags: Capabilities: AvatarBehavior

Fires when the [`Humanoid`](https://rapi.sleaze.dev/classes/Humanoid.md) enters or leaves the [`PlatformStanding`](https://rapi.sleaze.dev/classes/Humanoid.md) `HumanoidStateType`.

### Ragdoll

```luau
Humanoid.Ragdoll: RBXScriptSignal<(active: boolean)>
```

- Tags: Capabilities: AvatarBehavior

Fires when the [`Humanoid`](https://rapi.sleaze.dev/classes/Humanoid.md) enters or leaves the [`Ragdoll`](https://rapi.sleaze.dev/classes/Humanoid.md) `HumanoidStateType`.

### Running

```luau
Humanoid.Running: RBXScriptSignal<(speed: number)>
```

- Tags: Capabilities: AvatarBehavior

Fires when the speed at which a [`Humanoid`](https://rapi.sleaze.dev/classes/Humanoid.md) is running changes.

### Seated

```luau
Humanoid.Seated: RBXScriptSignal<(active: boolean, currentSeatPart: BasePart)>
```

- Tags: Capabilities: AvatarBehavior

Fired when a [`Humanoid`](https://rapi.sleaze.dev/classes/Humanoid.md) either sits in a [`Seat`](https://rapi.sleaze.dev/classes/Seat.md) or [`VehicleSeat`](https://rapi.sleaze.dev/classes/VehicleSeat.md) or gets up.

### ServerApplyDescription

```luau
Humanoid.ServerApplyDescription: RBXScriptSignal<(status: boolean)>
```

- Tags: Hidden, Roblox engine security

### ServerBreakJoints

```luau
Humanoid.ServerBreakJoints: RBXScriptSignal<()>
```

- Tags: Hidden, Roblox engine security

### ServerEquipTool

```luau
Humanoid.ServerEquipTool: RBXScriptSignal<(tool: Tool)>
```

- Tags: Hidden, Roblox engine security

### ServerResetCharacter

```luau
Humanoid.ServerResetCharacter: RBXScriptSignal<()>
```

- Tags: Hidden, Roblox engine security

### StateChanged

```luau
Humanoid.StateChanged: RBXScriptSignal<(old: Enum.HumanoidStateType, new: Enum.HumanoidStateType)>
```

- Tags: Capabilities: AvatarBehavior

Fires when the state of the [`Humanoid`](https://rapi.sleaze.dev/classes/Humanoid.md) is changed.

### StateEnabledChanged

```luau
Humanoid.StateEnabledChanged: RBXScriptSignal<(state: Enum.HumanoidStateType, isEnabled: boolean)>
```

- Tags: Capabilities: AvatarBehavior

Fires when [`Humanoid:SetStateEnabled()`](https://rapi.sleaze.dev/classes/Humanoid.md) is called on the [`Humanoid`](https://rapi.sleaze.dev/classes/Humanoid.md).

### Strafing

```luau
Humanoid.Strafing: RBXScriptSignal<(active: boolean)>
```

- Tags: Capabilities: AvatarBehavior

Fires when the [`Humanoid`](https://rapi.sleaze.dev/classes/Humanoid.md) enters or leaves the `StrafingNoPhysics` `HumanoidStateType`.

### Swimming

```luau
Humanoid.Swimming: RBXScriptSignal<(speed: number)>
```

- Tags: Capabilities: AvatarBehavior

Fires when the speed at which a [`Humanoid`](https://rapi.sleaze.dev/classes/Humanoid.md) is swimming in [`Terrain`](https://rapi.sleaze.dev/classes/Terrain.md) water changes.

### Touched

```luau
Humanoid.Touched: RBXScriptSignal<(touchingPart: BasePart, humanoidPart: BasePart)>
```

- Tags: Capabilities: AvatarBehavior

Fires when one of the humanoid's limbs come in contact with another [`BasePart`](https://rapi.sleaze.dev/classes/BasePart.md).

### AnimationPlayed

```luau
Humanoid.AnimationPlayed: RBXScriptSignal<(animationTrack: AnimationTrack)>
```

- Tags: Deprecated, Capabilities: Animation
- Use instead: [`Humanoid.AnimationPlayed`](https://rapi.sleaze.dev/classes/Humanoid.md)

**Deprecated:**

Fires when an [`AnimationTrack`](https://rapi.sleaze.dev/classes/AnimationTrack.md) begins playing on the [`Humanoid`](https://rapi.sleaze.dev/classes/Humanoid.md).

### CustomStatusAdded

```luau
Humanoid.CustomStatusAdded: RBXScriptSignal<(status: string)>
```

- Tags: Deprecated

**Deprecated:** This item is deprecated, as it was a part of the unfinished RbxStatus library which would have allowed you to add conditions to a Humanoid. Do not use it for new work.

Fired when a status is added to the Humanoid.

### CustomStatusRemoved

```luau
Humanoid.CustomStatusRemoved: RBXScriptSignal<(status: string)>
```

- Tags: Deprecated

**Deprecated:** This item is deprecated, as it was a part of the unfinished RbxStatus library which would have allowed you to add conditions to a Humanoid. Do not use it for new work.

Fired when a status is removed from the Humanoid.

### StatusAdded

```luau
Humanoid.StatusAdded: RBXScriptSignal<(status: Enum.Status)>
```

- Tags: Deprecated

**Deprecated:** This item is deprecated, as it was a part of the unfinished RbxStatus library which would have allowed you to add conditions to a Humanoid. Do not use it for new work.

Fired when a status is added to the Humanoid.

### StatusRemoved

```luau
Humanoid.StatusRemoved: RBXScriptSignal<(status: Enum.Status)>
```

- Tags: Deprecated

**Deprecated:** This item is deprecated, as it was a part of the unfinished RbxStatus library which would have allowed you to add conditions to a Humanoid. Do not use it for new work.

Fired when a status is removed from the Humanoid.

## Inherited members

- From [Instance](https://rapi.sleaze.dev/classes/Instance.md): `Archivable`, `archivable`, `Attributes`, `AttributesReplicate`, `AttributesSerialize`, `HistoryId`, `Name`, `Parent`, `PredictionMode`, `PropertyStatusStudio`, `RobloxLocked`, `SerializedOverrides`, `SourceAssetId`, `Tags`, `UniqueId`, `numExpectedDirectChildren`, `DataCost`, `Capabilities`, `DefinesCapabilities`, `IsInSandbox`, `Sandboxed`, `AddTag`, `ClearAllChildren`, `Clone`, `Destroy`, `FindFirstAncestor`, `FindFirstAncestorOfClass`, `FindFirstAncestorWhichIsA`, `FindFirstChild`, `FindFirstChildOfClass`, `FindFirstChildWhichIsA`, `FindFirstDescendant`, `GetActor`, `GetAttribute`, `GetAttributeChangedSignal`, `GetAttributes`, `GetChildren`, `GetDebugId`, `GetDescendants`, `GetFullName`, `GetStyled`, `GetStyledPropertyChangedSignal`, `GetTags`, `HasTag`, `IsAncestorOf`, `IsDescendantOf`, `IsPropertyModified`, `QueryDescendants`, `RemoveTag`, `ResetPropertyToDefault`, `SetAttribute`, `WaitForChild`, `Remove`, `children`, `clone`, `destroy`, `findFirstChild`, `getChildren`, `isDescendantOf`, `remove`, `AncestryChanged`, `AttributeChanged`, `ChildAdded`, `ChildRemoved`, `DescendantAdded`, `DescendantRemoving`, `Destroying`, `StyledPropertiesChanged`, `childAdded`
- From [Object](https://rapi.sleaze.dev/classes/Object.md): `ClassName`, `className`, `GetPropertyChangedSignal`, `IsA`, `isA`, `Changed`