mpfb_add_rig
Attach a standard, Rigify or custom rig to an existing MakeHuman character. Rig before dressing, since garments only receive a rig if one is present when attached.
Instructions
Attach a rig to an existing MakeHuman character - MPFB's "Add standard rig" / "Add rigify rig" / "Add custom rig".
Rig the character before dressing it. MPFB rigs a garment only if a
rig is present when the garment is attached, and nothing rigs it
retroactively. This tool does not refuse to rig a dressed character -
decorative garments are legitimate - but mesh_assets_not_rigged names
every asset it just failed to rig, and a non-empty list is a mistake
unless you meant it.
identifier is exactly what mpfb_list_rigs reports in its
identifier field, never the name beside it and never a filename:
"default_no_toes" for a standard rig, "rigify.human" for a Rigify
one, "custom.my_rig" for a user one. The prefix selects which of
MPFB's two non-interchangeable adding functions runs, and
add_function_used says which was taken.
import_weights (default true, MPFB's own) loads the vertex weights
and adds the armature modifier. With it false the mesh is parented to
the armature but not deformed by it.
A rigify.* identifier produces a meta rig, not a finished rig.
is_metarig: true comes back with a next_step: attach the garments
first, then call mpfb_generate_rigify_rig. A meta rig deforms nothing
on its own.
On added: true, result carries rig_object_name - read off the
created object, since Blender uniquifies a name already in use, and the
address other tools need for the rig - plus basemesh_name,
add_function_used, family, is_metarig/next_step,
weights_loaded with weights_from and weights_path (MPFB
resolves weights through a fallback table, so a rig legitimately
borrowing another's is normal and weights_loaded: false is not),
armature_modifier_added, basemesh_location_before with
basemesh_moved_to_origin and rig_location - both adding functions
move the basemesh to the origin and give the armature its old location,
which visibly moves a character standing anywhere else - and
mesh_assets_not_rigged / subrigs_not_rigged.
Refusals come back as added: false (and so performed: false) with a
blocked_by and a sentence: subject_not_found, unknown_identifier
(with known_identifiers for the family you addressed),
rigify_unavailable, not_object_mode, and already_rigged - MPFB
cannot swap a rig, so an existing one has to be deleted first.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | ||
| identifier | No | ||
| import_weights | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||