Version: 2022.3
  • C#


Suggest a change


Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.


Submission failed

For some reason your suggested change could not be submitted. Please <a>try again</a> in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.



public int maxBonesPerVertex;


The maximum number of bones per vertex stored in this mesh data.

Range: 1 - 255, inclusive. Note that higher bone counts may have a performance cost, especially above 4 bones per vertex.

This setting affects the underlying mesh data; vertices with more than this number will have the lowest weighted bones discarded.

You can limit the number of bones that Unity takes into account when performing skinning using the QualitySettings.skinWeights and SkinnedMeshRenderer.quality APIs. Note that these settings do not affect the underlying mesh data.

Additional resources: ModelImporter.minBoneWeight, QualitySettings.skinWeights, SkinnedMeshRenderer.quality.