Model Rigging ​

Skeleton Categories ​

Skeleton Overview ​

Humanoid Skeleton: ​

• Supports shared animation resources from the corresponding skeleton library.

• Compatible with interchangeable outfits, though minor discrepancies may occur.

• Allows rotation, scaling, and translation of the skeleton. Ensure to reset scaling to 1 after adjustments.

Multiped Skeleton: ​

• Different animals have corresponding skeletons. Refer to the table below for the appropriate skeleton templates.
• Supports matching with skeletons of the same animal type, allowing shared animation resources from the corresponding skeleton library.
• Allows rotation, scaling, and translation of the skeleton. Ensure to reset scaling to 1 after adjustments.

Quadruped, Upright Legs: Bears, elephants, rhinos, and other animals with hind legs similar to humans.
Quadruped, Digitigrade Legs: Cats, dogs, deer, and other animals with digitigrade hind leg structures.

Custom Skeletons ​

• Supports creating custom skeletons based on the model's design, offering high flexibility.

• The total number of bones in a single skeleton model cannot exceed 75 bones.

• Does not support animations from the shared humanoid or multiped animation libraries.

• When custom skeletons are named with specific identifiers, objects can be attached to corresponding bones in the skeleton model via the attachToSlot() method in the game. Below is the correspondence table between skeleton names and non-humanoid object slot types:

  Skeleton Name	Slot Enum Value	Slot Type (NonHumanoidSlotType)	Description
  Root	0	Root	Root Node
  Spine_03	1	Chest	Chest
  Spine_02	2	UpperSpine	Upper Spine
  Spine_01	3	LowerSpine	Lower Spine
  Neck_01	4	Neck	Neck
  Head	5	Head	Head
  Hand_L	6	FrontalLeftFoot	Front Left Foot
  Hand_R	7	FrontalRightFoot	Front Right Foot
  Foot_L	8	RearLeftFoot	Rear Left Foot
  Foot_R	9	RearRightFoot	Rear Right Foot
  Tail_01	10	Tail	Tail
  Human_Hand_R01	11	RightHand	Humanoid Right Hand 01
  Human_Hand_L01	12	LeftHand	Humanoid Left Hand 01
  Human_Head	13	HumanoidHead	Humanoid Head
  Human_Spine_04	14	HumanoidChest	Humanoid Chest for Multipeds
  Fins_UP_01	15	DorsalFin	Dorsal Fin 01
  Fins_L_01	16	LeftFin	Left Fin 01
  Fins_R_01	17	RightFin	Right Fin 01
  Wing_UpperArm_R_01	18	RightWing	Right Wing 01
  Wing_UpperArm_L_01	19	LeftWing	Left Wing 01
  Foot_R01	20	ExtraRightFoot1	Extra Right Foot 01
  Foot_R02	21	ExtraRightFoot2	Extra Right Foot 02
  Foot_R03	22	ExtraRightFoot3	Extra Right Foot 03
  Foot_R04	23	Extra Right Foot 04	Extra Right Foot 04
  Foot_L01	24	ExtraLeftFoot1	Extra Left Foot 01
  Foot_L02	25	ExtraLeftFoot2	Extra Left Foot 02
  Foot_L03	26	Extra Left Foot 03	Extra Left Foot 03
  Foot_L04	27	Extra Left Foot 04	Extra Left Foot 04
  Mouth	28	Mouth	Mouth
  Eye_R	29	RightEye	Right Eye
  Eye_L	30	LeftEye	Left Eye
  Head_Auxiliary_01	31	Crest	Crest

Skeleton Checklist: ​

Rigging Specifications: ​

• Use standard skeleton files for model adaptation.
• Do not modify the scale attributes of the skeleton.
• Adding, deleting, or rearranging skeleton hierarchy is not allowed.
• Skeleton naming must remain unchanged.
• Ensure the model orientation matches the forward-facing direction in the software's front view.
• Check that the model's coordinates are set to zero (X/Y/Z = 0/0/0) and adjust if necessary.
• Ensure unit settings are standardized to centimeters.

Character/NPC: ​

• Each joint position of the model must match the corresponding skeleton position.

  

• Apply the Skin command to the character and add the required skeletons.

• Exclude Bip_01 and the root node Root from skinning.

• Each vertex in the model can be influenced by a maximum of 3 bones. (The default setting in most DCC software is >4 and must be manually adjusted to 3.)

• You can check the binding weight information for overlaps or structural anomalies by adjusting the skeleton keyframes (exit skeleton editing mode). Make targeted adjustments to optimize the weight information as needed.

Multiped Rigging: ​

• Apply the Skin command to the character and add the required skeletons.
• Exclude Bip_01 and the root node Root from skinning.
• Each vertex in the model can be influenced by a maximum of 3 bones. (The default setting in most DCC software is >4 and must be manually adjusted to 3.)
• Adjust the skeleton keyframes (exit skeleton editing mode) to review the binding weight information for any overlaps or obvious structural anomalies. Make targeted adjustments to optimize the weight distribution.