SeeThrough Parts Rig Probe

Rigging a 2D character starts with knowing which blob is which - is that silhouette left_arm or torso? GameAssets_SeeThroughPartsRigProbe is the sanity check for exactly that: it reads your layer tags, guesses each part's role and side, computes bounds, pivots, and a rough bone hierarchy, and hands you a GAME_ASSET_RIG plus a text report. It's the "is this worth rigging?" probe before you invest in a full rig.

It's part of comfyui-game-assets-maker, quinteroac's pack shared on r/comfyui as a playground for game-asset pipelines. The probe is deliberately the first, cheap step of the rigging workflow - the pack's pose-based rig node builds the same structure and then refines it.

The prerequisite

Like the pack's other SeeThrough nodes, this takes SEETHROUGH_PARTS from SeeThrough_PostProcess in jtydhr88/ComfyUI-See-through (the ComfyUI port of the "see-through" single-image layer decomposition project). Separate install, needed first. The probe's whole job is to tell you whether those parts' tags - left_arm, head, torso, right_hand and friends - are classified correctly enough to build on.

How it works

For each part it detects a semantic role and side from the tag name, computes alpha-based bounds and a centroid (using alpha_threshold to decide what counts as opaque), and picks a pivot that makes sense for the role. It then wires parts into a simple bone hierarchy via _suggest_parent, so arms hang off shoulders and so on. depth_order controls the z-order assumption (back_to_front default, front_to_back, or input_order).

The rig's stats tell you recognized vs unknown parts - the number you actually care about. If most of your tags classify as unknown, the rig will be garbage no matter what follows.

Inputs

Three: parts, alpha_threshold (default 10, how strict alpha is when computing bounds), and depth_order. That's the whole node - it's a probe, not a pipeline.

Outputs

• rig - the GAME_ASSET_RIG object, wireable into Apply Rig Overrides, Rig To SVG Preview, or Rig To Spine Export.
• rig_json - the same rig as editable JSON, when you want to poke at it by hand.
• report - the plain-text per-part breakdown (role, side, pivot, parent). Read this before you build anything on top.

Installing

ComfyUI Manager (search "comfyui-game-assets-maker") or:

cd ComfyUI/custom_nodes
git clone https://github.com/quinteroac/ComfyUI-GameAssetsMaker.git
cd ComfyUI-GameAssetsMaker
pip install -r requirements.txt

Restart after. Only opencv-python in the pack's requirements; the See-through pack is your separate prerequisite.

Where people get burned

The probe guesses from tag names. If your layer decomposition output has inconsistent or terse tags, the role detection will misclassify and you'll get confident-sounding nonsense in the report. That's fine - it's a probe; the fix is better tags upstream, or using SeeThrough Parts Pose Rig to correct pivots with real pose data, or hand-adjusting via Apply Rig Overrides.