ChangeState

Unsafe

For thread safety, this property is not safe to read in an unsynchronized thread.

Function of:

Description:

This function causes the Humanoid to enter the given Enum/HumanoidStateType.

The humanoid state describes the activity the Humanoid is currently doing.

You should check the page for Enum/HumanoidStateType for more information on what particular states do as some have unintuitive names. For example, running describes a state where the Humanoid|Humanoid's legs are on the ground, including when stationary

Due to the default behavior of the Humanoid some states will automatically be changed when set to. For example:

Setting the state to 'Swimming’ when the Humanoid is not in the water will lead to it being automatically set to ‘GettingUp’
As it is unused, setting the state to ‘PlatformStanding’ will lead to it being automatically set to ‘Running’

Parameters

Name	Type	Default	Description
Name state	Type HumanoidStateType	Default None	Summary The `Enum/HumanoidStateType` that the `Humanoid` is to perform

Returns

Return Type	Summary
Return Type void	Summary No return

Code Samples

Double Jump

This code, when placed inside a LocalScript in StarterCharacterScripts|StarterPlayer.StarterCharacterScripts will allow the player’s characters to perform a double jump.

			
				Double Jump

				Expected Output
			
				Expand
				
			local UserInputService = game:GetService("UserInputService")
local character = script.Parent

local humanoid = character:WaitForChild("Humanoid")

local doubleJumpEnabled = false 

humanoid.StateChanged:Connect(function(oldState, newState)
	if newState == Enum.HumanoidStateType.Jumping then
		if not doubleJumpEnabled then 
			wait(.2)
			if humanoid:GetState() == Enum.HumanoidStateType.Freefall then
				doubleJumpEnabled = true 
			end
		end
	elseif newState == Enum.HumanoidStateType.Landed then	
		doubleJumpEnabled = false
	end
end)

UserInputService.InputBegan:Connect(function(inputObject)
	if inputObject.KeyCode == Enum.KeyCode.Space then
		if doubleJumpEnabled then
			if humanoid:GetState() ~= Enum.HumanoidStateType.Jumping then
				humanoid:ChangeState(Enum.HumanoidStateType.Jumping)
				spawn(function()
					doubleJumpEnabled = false 
				end)
			end
		end		
	end
end)
		
				Copy Code
			
				Light Theme

ChangeState

See also

Parameters

state

Returns

void

Code Samples

Double Jump