RemoveAccessories

Unsafe

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

Function of:

Description:

This function removes all Accessory|Accessories worn by the Humanoid|Humanoid’s parent. When this function is called, all Accessory|Accessories sharing an Instance/Parent with the Humanoid will be removed. For Player Player/Character|Characters this will remove all hats and other accessories.

This function removes Accessory|Accessories by calling Instance/Destroy on them. This means the Instance/Parent|Parents of the accessories are set to nil and locked.

Returns

Return Type	Summary
Return Type void	Summary

Code Samples

Remove and Return Hats

This code sample will remove all the hats from a Player/Character once the character has fully loaded. After five seconds, if the character still exists and is alive, it will return them.

			
				Remove and Return Hats

				Expected Output
			
				Expand
				
			local Players = game:GetService("Players")

local function playerAdded(player)
	player.CharacterAppearanceLoaded:Connect(function(character)
		local humanoid = character:WaitForChild("Humanoid")

		-- save hats for later
		local accessories = {}
		for _, accessory in pairs(humanoid:GetAccessories()) do 
			table.insert(accessories, accessory:Clone())
		end

		-- remove hats
		humanoid:RemoveAccessories()

		wait(5)

		-- make sure the player still exists, and has the same character
		if player and player.Character and player.Character == character then
			local humanoid = character:FindFirstChildOfClass("Humanoid")
			if humanoid:GetState() ~= Enum.HumanoidStateType.Dead then
				-- give back the hats
				for _, accessory in pairs(accessories) do 
					humanoid:AddAccessory(accessory)
				end
			end
		end

		accessories = nil
	end)
end

-- get existing players
for _, player in pairs(Players:GetPlayers()) do 
	playerAdded(player)
end
-- listen for new players
Players.PlayerAdded:Connect(playerAdded)
		
				Copy Code
			
				Light Theme

RemoveAccessories

See also

Returns

void

Code Samples

Remove and Return Hats