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.
| Object | What it is |
|---|---|
Body | The 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, Eyelids | Separate skin pieces in the same skin, a shade darker. The eyelids carry the blink keys. |
Eyes | Both eyes, colored by the Eyes trait. Has eight look shape keys (eyeLookUpLeft and friends). |
Fangs_Upper, Fangs_Lower | The 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_Print | Only 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
| Bones | Use them for |
|---|---|
Root | Sits on the floor under everything. Move it to place the character in a scene. Leave it still when you animate in place. |
Torso | The 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, Toe | The legs. Toe bends at the ball of the foot for heel to toe rolls. |
Spine, Chest, UpperChest | Bend and twist the body in three steps. Spread a bend across all three for a smooth curve. |
Neck, Head | Look and nod. Most of a head turn reads best split about one third neck, two thirds head. |
EarBase, EarMid, EarTip | The 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. |
Jaw | Opens the lower jaw. For talking, the jawOpen and mouth shape keys give cleaner lip shapes than the bone alone. |
MouthCorner | Pull a corner up or out for a smirk. |
Brow and its Inner, Middle, Outer children | Move the parent to raise or drop a whole brow; move the three children to shape it (worried, angry, sly). |
Shoulder, UpperArm, Forearm, Hand | The arms. Shoulder shrugs and hunches; the rest is a standard arm chain. |
Finger1 to Finger3, Thumb | Three 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.R | One 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
- File, Import, glTF 2.0 (.glb/.gltf) and pick your
VAMP-1234.glb. - 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.
- Leave Guess Original Bind Pose on. The file's rest pose and bind pose are the same, so either setting gives the same result.
- Import. In the Outliner you get the armature
VAMP_1234with the meshes under it, and two Actions (Idle and Walk) in the Action editor.
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
- Select the armature and switch to Pose Mode with Ctrl Tab.
- 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.
- Press I to insert a keyframe on the selected bones. Move the playhead, pose again, key again.
- 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.
- Face shapes are on the meshes, not the armature: select
Body, open Object Data properties, Shape Keys, and keyjawOpen,mouthSmileLeftand the rest like any value. The blink is split into eight steps per eye, on bothEyelidsandBrows(key the two together);Blink.L.8at 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.
- 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.
- 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.
- Under Expressions: set
aato thejawOpenkey,blinkLeftandblinkRighttoBlink.L.8andBlink.R.8on both Eyelids and Brows,happyto bothmouthSmilekeys. Point the look at settings to the eighteyeLookkeys on Eyes. - 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.