Skip to content

Export Nodes SourceIOBoneRenameNode

REDxEYE edited this page Nov 20, 2026 · 1 revision

Bone rename table

Renames bones at export time, so the exported skeleton can use Source-style names while your Blender armature keeps its own.

Bone rename table node

Category: Model settings. Node ID: SourceIOBoneRenameNode.

Inputs

None.

Outputs

Socket Type Meaning
Bone names Bone names socket Link to Bone names on the Source 1 model output (single link).

Properties

Property Meaning
Rename table A Blender Text block. Required; the node reports an error when it is empty of assignment. Each line is Blender name = exported name. Blank lines and lines starting with # or // are ignored.
Generate bone table (button) Fills the Text block (creating <node name> bones if none is set) with one name = name line for every bone of the rigs used by the connected model outputs, ready for you to edit the right-hand side. Existing renames are kept; entries for bones no longer found on the rigs are appended under "Not found on the connected rigs". Requires the node to be connected to a model output whose geometry has an armature.

Example table:

# Blender bone name = exported bone name
Spine.001 = ValveBiped.Bip01_Spine1
Hand.L = ValveBiped.Bip01_L_Hand

What gets renamed

The same table is applied to everything that names a bone:

  • the exported skeleton and skin weights of the DMX/SMD meshes (and the direct-export skeleton);
  • attachment and hitbox bone names written to the QC;
  • bone names in the procedural-bones VRD (see Helper bone);
  • bone names looked up and written in the SFM rig script (see SFM IK rig);
  • the Import VRD operator, which matches VRD names through the table.

The preview manifest lists every rename whose names differ as Bone rename: <source> -> <target>. The rename is applied while exporting; it does not write $renamebone lines.

Example workflow

  1. Add a Bone rename table node and link Bone names to the model output.
  2. Make sure the output has a Geometry with an armature, then press Generate bone table.
  3. Edit the Text block's right-hand sides, then run Preview Source 1 export and check the Bone rename: lines.

Caveats

  • A Blender bone can be listed only once; duplicates are an error. Exported names cannot be empty or contain quotes or line breaks.
  • Lines with no = or more than one = are rejected with the line number.
  • Bones not listed keep their Blender name.
  • Names containing . cannot be matched by studiomdl in procedural bones, so helper and control bones (and their parents) must be renamed to dot-free names if their Blender names contain dots.
  • The geometry caches used by Use export cache include the rename table, so editing it re-exports the meshes.

Back to Export Nodes.

Clone this wiki locally