GetState

Unsafe

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

Function of:

Description:

This function returns the Humanoid|Humanoid's current Enum/HumanoidStateType.

The humanoid state describes the activity the Humanoid is currently doing, such as jumping or freefalling.

Returns

Return Type	Summary
Return Type HumanoidStateType	Summary The current `Enum/HumanoidStateType` of the `Humanoid`

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

GetState

See also

Returns

HumanoidStateType

Code Samples

Double Jump