NuniAvatarToolkit

Rays are cast outward from every body vertex to find vertices and faces fully enclosed by clothing (or, optionally, by the body itself) that can never be seen from outside.

1. Set Body Mesh (ボディメッシュ) to your body object.
2. In the Clothing Meshes (服メッシュ) list, click "+" to add a slot for each clothing object that covers the body.
3. Adjust Samples (サンプル数), Offset Ratio (オフセット比率), Detection Mode (判定モード) and Safety Margin (安全余白) if needed. Safety Margin shrinks the deletion area by 1–3 steps inward from its edge, so holes are less likely to show when the avatar moves. Medium (中) is recommended for most cases.
4. To protect areas that facial shape keys may reveal, such as the inside of the mouth or around the eyes, create a vertex group and set it as Excluded Vertex Group (除外頂点グループ).
5. Run Select Hidden Faces (隠れた面を選択). Blender switches to Edit Mode and highlights the faces judged hidden. Nothing is deleted at this point. Check them visually and adjust the selection by hand if needed.
6. When you're satisfied, run Delete Selected Faces (選択した面を削除) and confirm the dialog. A hidden, independent copy of the body is saved to the AMT_Backups collection just before deletion.

Notes

• Always review before deleting, so you don't remove faces that only appear with shape keys (blinks, eye movement, mouth open) or with alternate outfits toggled in-game. Take extra care with Include Own Mesh as Occluder (自身のメッシュも遮蔽物に含める), which makes areas like the mouth interior more likely to be selected.
• Modifiers that change vertex count, such as Subdivision Surface, Mirror and Boolean, are temporarily disabled while the pose is evaluated. If the vertex count still doesn't match, you'll get a warning that the rest positions were used instead.
• Processing runs as a modal operation: progress is shown in the status bar and Esc cancels. Avatars with many vertices × samples can take a while.
• Meshes in excluded collections or hidden in the viewport can't be evaluated. Shared or linked bodies are analyzed only, never selected or deleted.

Python API (for scripts and AI agents)

From Python inside Blender, call the public function NuniAvatarToolkit.run_hidden_mesh. It accepts object names or Blender objects.

import NuniAvatarToolkit

result = NuniAvatarToolkit.run_hidden_mesh(
  body="Body",
  clothing=["Tops", "Jacket"],
  action="SELECT",  # ANALYZE / SELECT / DELETE
  safety_margin="MEDIUM",  # NONE / SMALL / MEDIUM / LARGE
)
print(result)

ANALYZE returns results without changing anything, and SELECT selects the faces after the safety margin is applied. DELETE deletes those same faces, always creating a body copy in AMT_Backups first. The return value is a JSON-serializable dict with face indices, counts and the backup name.

1. Set Target Mesh (対象メッシュ) to the object you want to clean.
2. Tick the items you want removed (all are enabled by default).
3. Run Scan (スキャン) to see how many candidates were found. Nothing is deleted yet.
4. Review the results, then run Delete (削除を実行) and confirm the dialog.

Notes

• Vertex groups referenced by modifiers or shape keys, UV maps and color attributes used by the nodes of assigned materials, and shape keys driven by drivers are protected. Edit Mode changes are synced before candidates are evaluated.
• Shared, linked and library-override meshes are rejected before anything is changed.
• If modifiers whose material indices can't be verified remain, such as Solidify, Bevel, Wireframe or Geometry Nodes, removal of unused material slots is cancelled. Apply the modifiers on a duplicate first, or untick Unused Material Slots (未使用のマテリアルスロット) and process the other items only.

• Join Selected Meshes (選択メッシュを結合): make the target object active, select every mesh to join, and run. The confirmation dialog lists anything to watch out for, such as shape keys or differing armature/UV setups. Note that Blender's standard Join drops shape keys from objects other than the active one.
• Merge Duplicate Material Slots (重複マテリアルスロットを統合): in the active object, combines slots that reference the same material and removes only the duplicates (with a confirmation dialog). Unused slots unrelated to duplicates are kept.

Notes

• Merging duplicate slots is cancelled if modifiers that depend on material indices remain, such as Solidify, Bevel, Wireframe or Geometry Nodes, including ones hidden in the viewport. Apply them on a duplicate first.
• Meshes shared with other objects or linked from a library aren't processed. If the join target is a shared mesh, the join is cancelled to protect unselected objects.

1. Put the whole avatar (body, clothing, armature, etc.) in one collection and set it as Avatar Collection (アバターコレクション).
2. Run Diagnose (診断を実行) to see the results as a list.

What it checks

• Evaluated polygon and material slot counts, bone and shape key counts, with PC and Quest reference ranks (Excellent to Very Poor, e.g. 【PC: Excellent / Quest: Good】)
• Vertices with invalid coordinates (NaN/Inf), including every shape key and Basis
• Negative or non-uniform scale and unapplied rotation on meshes and Armatures, including delta transforms
• Number of non-manifold edges
• Bones that carry no weights from any mesh (nothing is deleted; PhysBones and other references can't be judged from mesh weights alone, so check these by hand)
• Collection layout: meshes placed directly under the collection instead of in sub-collections, contents inside excluded or hidden collections, objects linked to multiple collections, zero or two-plus armatures, collections still using default names such as Collection, and empty sub-collections

Category names (Outfit, Accessory, etc.) don't matter. A flat layout with no sub-collections produces no layout warnings. Ranks are estimates based on the PC and Quest criteria of VRChat's Avatar Performance Ranking System.

When you open an avatar's FBX or .blend file bought on BOOTH, textures sometimes go missing and the model shows up purple/pink. This tool finds those missing images in a folder you choose and relinks them.

1. Set Search Folder (検索フォルダ) to the folder containing the texture files. Subfolders are searched too.
2. Run Relink Missing Textures (欠落テクスチャを再リンク).
3. A report lists the result for each image: relinked, skipped because of multiple candidates, not found, and so on.

Matching order

1. Exact match between image name and file name
2. Match ignoring extension, letter case and Blender's duplicate suffixes such as .001
3. Partial name match
4. If several candidates tie at the same level, nothing is relinked to avoid picking the wrong file; the candidates are listed for you to handle manually

Notes

• It only relinks to files that actually exist in the folder. If you don't have the texture files, this can't fix it.
• Images whose datablocks were never created during FBX import are out of scope. UDIM, image sequences, movies, packed images and images linked from another .blend are left untouched.
• Each candidate is decoded as an image before the path is changed. Broken files aren't counted as success, and the original path is kept so you can retry.

Two versions of the same avatar (say, barefoot and high-heel) can have different rest-pose bone positions even when both objects sit at (0, 0, 0). This translates the whole target Armature so that the chosen bone's rest-pose world position matches.

1. Set Reference Armature (基準Armature) to the Armature that stays in place. A "Hips"-like bone is picked automatically, and you can change it.
2. Set Target Armature (対象Armature) to the Armature you want to move.
3. Run Align (位置を合わせる). The target Armature is translated so the chosen bone lines up with the reference.

Notes

• Only location (translation) is matched. Rotation and scale stay as they are.
• The rest pose (bone layout in Edit Mode) is used, not the current pose.
• Meshes parented to the target Armature move with it. Meshes linked only through an Armature modifier don't, and a warning is shown.
• It won't run while the Armature is in Edit Mode and asks you to switch to Object Mode. If constraints or drivers prevent a clean translation, the changed channels are restored.

Before merging an accessory into the avatar body, assign all of its vertices to one bone at weight 1.0, so it follows that bone rigidly in Unity and VRChat after the merge.

1. Set Target Mesh (対象メッシュ) to the accessory mesh you want to merge.
2. Set Armature (Armature) to the Armature it should follow.
3. Choose the bone to follow under Bone (ボーン).
4. Run Set Merge Weights (統合用ウェイトを設定).
5. Select the target mesh and the destination mesh that uses the same Armature modifier, make the destination active, and run Join Selected Meshes (選択メッシュを結合).

Notes

• Existing weights for bones of the same Armature are removed from the target mesh, and only the chosen bone gets weight 1.0. An Armature modifier is added automatically if missing.
• For safety, meshes with an Armature modifier pointing to a different Armature than the destination, meshes with Bone Parent set, and linked meshes that can't be edited are not processed.
• Shared meshes, targets whose mesh data alone is linked, and non-deform bones (use_deform=False) are rejected before any weights are removed. Make shared meshes single-user first, and pick a deform bone to follow.

Outfits made for another avatar often let the body poke through. Limited to a vertex group you choose, this pushes clothing vertices that are buried in the body out to the body surface and adds the result as a shape key. Unlike shrink-wrapping the whole garment, you can target just the area that needs fixing, such as the chest or hips.

1. On the clothing mesh, create a vertex group covering the area to fit. Weight values act as fit strength, so feathering the edges toward 0 avoids visible steps.
2. Set Body Mesh (ボディメッシュ) to the body and Clothing Mesh (服メッシュ) to the garment to deform.
3. Choose the vertex group from step 1 under Target Vertex Group (対象頂点グループ).
4. Adjust Offset (オフセット), the distance to float above the body surface, and Max Search Distance (最大探索距離) as needed.
5. Run Fit and Create Shape Key (フィットしてシェイプキーを作成). A shape key (named AMT_Fit by default) is added to the clothing at value 1.0.

Vertices already outside the body are left alone and only buried ones are pushed out, so the garment's silhouette is preserved.

Notes

• Because the result is a shape key, setting it to 0 restores the original shape, and you can dial the effect down with the slider.
• If a shape key with the same name exists, it's overwritten after a confirmation dialog. Change Shape Key Name (シェイプキー名) to keep separate keys per area.
• The Armature is treated as being in rest pose during the calculation, and the original pose is restored afterwards.
• Vertices farther than Max Search Distance are skipped. To fit clothing that's far off, raise the value or set it to 0 for no limit.
• The clothing must be a local, single-user mesh. Existing absolute keys, self-referencing relative keys, muted keys, or keys whose slider range excludes 1.0 stop the run instead of being changed silently.
• Clothing modifiers that change coordinates or topology, such as Displace, Shrinkwrap, Mirror and Subdivision, should be disabled or applied on a duplicate first.

Finds body faces sticking out past the clothing surface and selects them in Edit Mode. It only inspects; nothing is deleted or deformed.

1. Set Body Mesh (ボディメッシュ) to your body object.
2. In the Clothing Meshes (服メッシュ) list, click "+" to add a slot for each clothing object that covers the body.
3. Adjust Max Search Distance (最大探索距離), Detection Threshold (検出しきい値) and Detection Mode (判定モード) if needed.
4. To protect parts that are meant to be exposed, such as the face, hands and feet, create a vertex group and set it as Excluded Vertex Group (除外頂点グループ).
5. Run Check Poke-through (貫通をチェック). Offending faces are selected in Edit Mode, and the face count and maximum protrusion are reported.

Notes

• The check uses the current pose. Poke-through comes and goes with the pose, so put the avatar in the problem pose first (the opposite of Clothing Fit, which calculates in rest pose).
• Body vertices with no clothing within Max Search Distance are treated as uncovered and skipped. If skin at necklines or cuffs is falsely flagged, lower it; if poke-through under thick clothing is missed, raise it.
• Detection Threshold is a tolerance so faces that merely touch aren't flagged. If lots of tiny faces get selected like noise, raise it.
• Fix what you find by inflating the clothing with Clothing Fit, or by trimming body faces with Hidden Mesh Removal.
• Bodies using a shared mesh are rejected (sharing on the clothing side is fine).