Mannequins

Mannequins are special entities that can display player skins and textures. They are highly customizable, allowing you to change their profile, hidden layers, and main hand.

Creating a Mannequin

You can create a mannequin using the mannequin DSL.

val myMannequin = mannequin {
	hiddenLayers(MannequinLayer.CAPE, MannequinLayer.HAT)
	mainHand = MannequinHand.LEFT
	playerProfile("Ayfri")
}

summon(myMannequin.entityType, vec3(), myMannequin.toNbt())
Kotlin

Profiles

Mannequins can have two types of profiles: PlayerProfile and TextureProfile.

Player Profile

A player profile uses a player's name or UUID to fetch their skin and properties.

mannequin {
	playerProfile(name = "Steve", id = uuid("8667ba71-b85a-4004-af54-457a9734eed7"))
}
Kotlin

Texture Profile

A texture profile allows you to specify a direct texture, and optionally a cape, elytra, and model type.

mannequin {
	textureProfile(texture = "tex") {
		cape = model("cape")
		model = MannequinModel.SLIM
	}
}
Kotlin

Customization

Mannequins support additional fields for further customization:

mannequin {
	description = textComponent("Test")
	hideDescription = false
	immovable = true
	pose = MannequinPose.CROUCHING
}
Kotlin

Pose

The pose field allows you to set the mannequin's pose. Available poses are:

  • STANDING
  • CROUCHING
  • SWIMMING
  • FALL_FLYING
  • SLEEPING

Hidden Layers

You can hide specific layers of the mannequin's skin using the hiddenLayers function.

Available layers:

  • CAPE
  • HAT
  • JACKET
  • LEFT_PANTS_LEG
  • LEFT_SLEEVE
  • RIGHT_PANTS_LEG
  • RIGHT_SLEEVE
mannequin {
	hiddenLayers(MannequinLayer.JACKET, MannequinLayer.HAT)
}
Kotlin

Main Hand

You can set which hand is the main hand of the mannequin.

mannequin {
	mainHand = MannequinHand.RIGHT
}
Kotlin