View source for ParentType

{{Stub}}{{Notice
| content = This page is not complete! I'm still working on it <span style="font-family:monospace;"><span style="opacity:50%;font-size:.8em;">animations.</span>[[User:PenguinEncounter|PenguinEncounter]]<span style="font-size:.8em;">.[[User talk:PenguinEncounter|talk]]</span></span>
}}

'''ParentType'''s dictate how Figura positions and renders parts in your model. For example, some (like [[#Head|Head]] or [[#LeftLeg|LeftLeg]]) cause the part to mimic the motions of a part of the standard Minecraft player model. Others (like [[#LeftItemPivot|LeftItemPivot]]) control the positioning of special parts like the player's currently held item, armor, and parrots. Finally, ParentTypes like [[#World|World]] change the way the part is positioned entirely. Each ParentType has one or more names associated with them.

== In Blockbench ==
In Blockbench, '''groups''' (and only groups, not cubes or meshes) can be assigned ParentTypes by starting the name of the group with one of the names below.

{{Note
 |Keywords are '''case-sensitive'''. This means that changing the capitalization might make a keyword non-functional.
}}

For example, all of the following group names will assign the ParentType of [[#Head|Head]], which will cause the part to move and rotate like the vanilla player's head.
* Head
* HEAD
* Head2
* Headphones (be careful of assigning ParentTypes by accident!)

The following will '''not''' assign the ParentType of [[#Head|Head]]:
* head ('head' isn't a ParentType name; capitalization matters)
* BigHead (doesn't start with the ParentType)
* HeAd ('HeAd' isn't a ParentType name)

{{Note
 |color=#f2a03c
 |tag=Warning
 |Watch out for English words that incidentally start with ParentType names, like '''Gui'''tar, which assigns a ParentType of [[#Hud|Hud]] (through its alias 'Gui'!)
}}

== Via Scripting ==

Calling [[ModelPart#setParentType|setParentType]] on any {{type|ModelPart}} (including cubes and meshes) will override its ParentType.

Simply [[ModelPart#Accessing ModelParts|access]] the ModelPart and call [[ModelPart#setParentType|setParentType]] on it, passing the ParentType as a {{type|string}}. For example:

<syntaxhighlight lang="lua">
local head = models.model.root.Head
head:setParentType("RightArm") -- make the part act like the vanilla player's right arm
</syntaxhighlight>

To remove the ParentType from a ModelPart, use <code>"None"</code>:

<syntaxhighlight lang="lua">
local head = models.model.root.Head
head:setParentType("None") -- remove the ParentType
</syntaxhighlight>

ModelParts don't remember their original ParentType! If you need to reference the original ParentType of a ModelPart, get ([[ModelPart#getParentType|getParentType]]) and store it in a variable and use it later:

<syntaxhighlight lang="lua">
local head = models.model.root.Head
local headParentType = head:getParentType() -- store the current ParentType for later
head:setParentType("None") -- clear the ParentType
</syntaxhighlight>