VAMPS.

Rig guide

Your Vamp, rigged and ready to pose.

The GLB download is your token as it stands in the Playground: body, skin, eyes and every worn trait on one clean skeleton. This page walks through what is in the file and how to drive it in the tools people actually use.

Format
glTF 2.0 binary (.glb)
Skeleton
63 bones, 65 with wings
Scale
Meters, about 1.85 m tall
Clips
Idle, Walk

What is in the file

Each download is named after its token, for example VAMP-1234.glb. Open it and you find one armature, VAMP_1234, with every mesh as its child.

ObjectWhat it is
BodyThe skin, with the token's Skin trait as its material (Skin_RoyalPurple, Skin_GoldenRobot and so on). Carries the mouth and cheek shape keys.
Brows, EyelidsSeparate skin pieces in the same skin, a shade darker. The eyelids carry the blink keys.
EyesBoth eyes, colored by the Eyes trait. Has eight look shape keys (eyeLookUpLeft and friends).
Fangs_Upper, Fangs_LowerThe teeth. They carry the jaw and lip keys too, so they follow the mouth.
Top_*, Back_*, Head_*, Eyewear_*, Face_*, Mouth_*, Neck_*, Misc_*One object per worn trait, named after the trait category and value: Top_VioletBatHoodie, Eyewear_GoldAviators, Back_BloodBatWings. A trait built from several pieces gets _2, _3 on the extra pieces.
Top_TShirt_PrintOnly on tee Vamps: the graphic, as its own thin layer over the shirt.

Textures are packed inside the file. Materials are standard metallic roughness PBR, so the look in a PBR viewer is close to the Playground but not identical: the Playground draws the plain skins with a toon shader, which glTF has no slot for.

The token number, its full trait list, and anything that could not be included are written in the file's asset.extras. Two kinds of trait have no mesh and are listed there instead: the soul flames (a live particle effect) and laser eyes (fired in the Playground, nothing to wear). The download button tells you the same thing when it happens. 1 of 1 Vamps are built on their own skeleton and come without the two clips.

The skeleton

This is the full hierarchy as it is written in the file, read from a downloaded Vamp that wears wings. Every Vamp has the same 63 body bones (the 1 of 1s have a few fewer, on their own proportions); the two wing bones appear only when the token wears a Back trait with wings.

VAMP_1234  (armature)
└─ Root
   └─ Torso
      ├─ Hips
      │  ├─ Thigh.L
      │  │  └─ Shin.L
      │  │     └─ Foot.L
      │  │        └─ Toe.L
      │  └─ Thigh.R
      │     └─ Shin.R
      │        └─ Foot.R
      │           └─ Toe.R
      └─ Spine
         └─ Chest
            └─ UpperChest
               ├─ Neck
               │  └─ Head
               │     ├─ Brow.L
               │     │  ├─ BrowInner.L
               │     │  ├─ BrowMiddle.L
               │     │  └─ BrowOuter.L
               │     ├─ Brow.R
               │     │  ├─ BrowInner.R
               │     │  ├─ BrowMiddle.R
               │     │  └─ BrowOuter.R
               │     ├─ EarBase.L
               │     │  └─ EarMid.L
               │     │     └─ EarTip.L
               │     ├─ EarBase.R
               │     │  └─ EarMid.R
               │     │     └─ EarTip.R
               │     ├─ Jaw
               │     ├─ MouthCorner.L
               │     └─ MouthCorner.R
               ├─ Shoulder.L
               │  └─ UpperArm.L
               │     └─ Forearm.L
               │        └─ Hand.L
               │           ├─ Finger1Base.L
               │           │  └─ Finger1Mid.L
               │           │     └─ Finger1Tip.L
               │           ├─ Finger2Base.L
               │           │  └─ Finger2Mid.L
               │           │     └─ Finger2Tip.L
               │           ├─ Finger3Base.L
               │           │  └─ Finger3Mid.L
               │           │     └─ Finger3Tip.L
               │           └─ ThumbBase.L
               │              └─ ThumbTip.L
               ├─ Shoulder.R
               │  └─ (mirrors the left arm, .R)
               ├─ Wing.L   (winged Vamps only)
               └─ Wing.R   (winged Vamps only)

What each bone does

BonesUse them for
RootSits on the floor under everything. Move it to place the character in a scene. Leave it still when you animate in place.
TorsoThe body's center of gravity. Bounce, lean and sway go here; the walk's up and down bob is keyed on it.
Hips, Thigh, Shin, Foot, ToeThe legs. Toe bends at the ball of the foot for heel to toe rolls.
Spine, Chest, UpperChestBend and twist the body in three steps. Spread a bend across all three for a smooth curve.
Neck, HeadLook and nod. Most of a head turn reads best split about one third neck, two thirds head.
EarBase, EarMid, EarTipThe ears are the Vamp's biggest acting tool. Rotate the base to swivel or droop the whole ear, then curl the mid and tip a little behind it for follow through.
JawOpens the lower jaw. For talking, the jawOpen and mouth shape keys give cleaner lip shapes than the bone alone.
MouthCornerPull a corner up or out for a smirk.
Brow and its Inner, Middle, Outer childrenMove the parent to raise or drop a whole brow; move the three children to shape it (worried, angry, sly).
Shoulder, UpperArm, Forearm, HandThe arms. Shoulder shrugs and hunches; the rest is a standard arm chain.
Finger1 to Finger3, ThumbThree fingers and a thumb, each with Base, Mid and Tip (the thumb has Base and Tip). Curl all of them on the same axis for a fist.
Wing.L, Wing.ROne bone per wing, at its hinge on the upper back. The rest pose is folded, the way the Vamp stands on the ground. Rotate outward to spread, and key a slow up and down swing for a flap.

There is no tail bone: Vamps do not have tails. Worn traits ride the body bones directly (a hoodie bends with the spine and arms, aviators sit on the head), so there are no extra bones to manage for clothing.

Open it in Blender

  1. File, Import, glTF 2.0 (.glb/.gltf) and pick your VAMP-1234.glb.
  2. In the import options on the right, under Bones & Skin, keep Bone Dir on Blender (best for import/export round trip). The bones were authored in Blender, so this puts every bone tip where it was made.
  3. Leave Guess Original Bind Pose on. The file's rest pose and bind pose are the same, so either setting gives the same result.
  4. Import. In the Outliner you get the armature VAMP_1234 with the meshes under it, and two Actions (Idle and Walk) in the Action editor.
Where is the armature? Click any bone in the viewport or select VAMP_1234 in the Outliner. If the bones are hidden behind the body, open the armature's Object Data properties, Viewport Display, and turn on In Front.

Posing and keyframing

  1. Select the armature and switch to Pose Mode with Ctrl Tab.
  2. Click a bone, then R to rotate, G to move (useful on Root and Torso only), Alt R or Alt G to clear back to rest.
  3. Press I to insert a keyframe on the selected bones. Move the playhead, pose again, key again.
  4. To pose one side and copy it across: select the bones, Ctrl C, then Shift Ctrl V (Paste Flipped Pose). This works because every sided bone ends in .L or .R.
  5. Face shapes are on the meshes, not the armature: select Body, open Object Data properties, Shape Keys, and key jawOpen, mouthSmileLeft and the rest like any value. The blink is split into eight steps per eye, on both Eyelids and Brows (key the two together); Blink.L.8 at 1 is a full close.

To start from the included clips, pick Idle or Walk in the Action editor's dropdown and edit on top of it, or push it to an NLA strip and add your own layer above. Walk is an in place loop.

Unity and Unreal

Unity

Unity does not read .glb on its own. Either add the glTFast package (com.unity.cloud.gltfast) and drop the file into Assets, or open it in Blender and export FBX with Apply Transform on and Add Leaf Bones off.

For a Humanoid avatar (needed for Mecanim retargeting), Unity requires Spine to be a child of Hips. In Blender, Edit Mode on the armature, click Spine, Shift click Hips so it is the active bone, then Ctrl P, Keep Offset. Both bones start at the same point, so the mesh does not move. The included Idle and Walk were keyed with Spine under Torso, so after this change use retargeted Humanoid clips instead of those two. In the avatar's Configure screen, check that Thigh went to Upper Leg, Shin to Lower Leg, Toe to Toes and Forearm to Lower Arm; the rest share Unity's names.

Unreal Engine

Import the .glb directly (File, Import Into Level, or drag it into the Content Browser) or go through FBX as above. Unreal converts meters to centimeters for you. Root is already the top bone, which is what Unreal expects for root motion. Create an IK Rig on the imported skeleton and an IK Retargeter to use Mannequin animations; set the retarget chains on Spine to Neck, each arm from Shoulder to Hand, and each leg from Thigh to Toe.

three.js

One thing to know first: three.js removes dots from node names when it loads a glTF, so EarTip.L is found as EarTipL.

import * as THREE from "three";
import { GLTFLoader } from "three/addons/loaders/GLTFLoader.js";

const gltf = await new GLTFLoader().loadAsync("VAMP-1234.glb");
scene.add(gltf.scene);

// the included loops
const mixer = new THREE.AnimationMixer(gltf.scene);
mixer.clipAction(THREE.AnimationClip.findByName(gltf.animations, "Idle")).play();

// bones by name (no dots in three.js)
const head = gltf.scene.getObjectByName("Head");
const ear = gltf.scene.getObjectByName("EarBaseL");
const body = gltf.scene.getObjectByName("Body");

renderer.setAnimationLoop((ms) => {
  mixer.update(clock.getDelta());
  // layer your own motion after the clip has posed the bones
  head.rotation.y += Math.sin(ms / 900) * 0.25;
  ear.rotation.x += Math.sin(ms / 300) * 0.08;
  body.morphTargetInfluences[body.morphTargetDictionary.jawOpen] = 0.3;
  renderer.render(scene, camera);
});

Convert to VRM for VTubing

VSeeFace, Warudo, VNyan and most VTubing apps load VRM, which is glTF with a humanoid map and named expressions on top. The quickest route is Blender with the free VRM Add-on for Blender.

  1. Import the .glb as above and parent Spine to Hips (Ctrl P, Keep Offset, see Unity). VRM needs the same hierarchy as a Unity Humanoid.
  2. Select the armature, open the VRM tab in the sidebar (N), and in Humanoid assign: Hips, Spine, Chest, Upper Chest, Neck, Head, the shoulders, arms and hands, Upper Leg to Thigh, Lower Leg to Shin, Foot, Toes to Toe. Fingers are optional; if your app wants them, assign Thumb, Finger1, Finger2 and Finger3 in order to thumb, index, middle and ring.
  3. Under Expressions: set aa to the jawOpen key, blinkLeft and blinkRight to Blink.L.8 and Blink.R.8 on both Eyelids and Brows, happy to both mouthSmile keys. Point the look at settings to the eight eyeLook keys on Eyes.
  4. Fill in the meta (title, author) and export with File, Export, VRM.

Most of the mouth, cheek and brow keys use Apple ARKit's blendshape names, so apps with ARKit or "perfect sync" face tracking can drive them by name without manual mapping. Spring bones for the ears are worth adding in the VRM tab: a chain from EarBase to EarTip with a little drag gives them their bounce.

Scale and orientation

  • Units: meters, scale 1 on every object. A base Vamp is about 1.85 m to the ear tips; hats, halos and horns add to that.
  • Up and forward: glTF's Y up, and the Vamp faces +Z. In Blender that becomes Z up, facing -Y, so Front view (Numpad 1) looks at his face.
  • Placement: feet on the floor at height 0, hips over the origin.
  • Pose: the file is saved in its rest pose, which is also the bind pose, arms relaxed and wings folded. Skin weights are at most four bones per vertex and add up to one.