Models (wmb files) - Kerilk/bayonetta_tools GitHub Wiki

Files ending with a .wmb extension are model files. They can be opened with Bayonetta 2 wmb.bt, Bayonetta WiiU wmb.bt and Bayonetta wmb.bt.

These files contain vertexes, bone structure (with a bone map), materials information and meshes for a given model.

Bayonetta 1 Mesh Arrangement/Numbering

All .WMB files for player models follow the same mesh numbering. Meshes that are not used are replaced with dummy to keep the numbering consistent. Each mesh number has attributes that most costumes follow (e.g. Nun costume doesn't have Durga/Odette glow effects). The Default costume will be used in this example. This link contains pictures of all meshes and their respective batches.

Mesh 0 - Body

body

Always shown regardless of weapons/cutscenes. It allows transparency during gameplay, but it shows transparent parts as black during cutscenes. Shadow meshes are also contained here. It loads pl0010texA.wtb or pl004btexA.wtb after summoning Wicked Weaves (applies to pl0000, pl004b, & pl0064).

Mesh 0 - Body

Mesh 1 - Beehive Hair, Ribbon, Chain, and Earrings

hair_drill

Allows Durga/Odette effects, but also shows transparency as black during cutscenes.

Mesh 1 - Beehive Hair, Ribbon, Chain, and Earrings

Mesh 2 - Ribbon

ribon1

Disappears during Chapter XII: The Broken Sky to Epilogue. Bayonetta gives her ribbon to Cereza in Chapter XII, which also reflects in the player model.

Mesh 2 - Ribbon

Mesh 3 - Body Hair / Transition Hair

change_hair

Disappears before summoning Wicked Weaves and Infernal Summons (applies to pl0000, pl004b, & pl0064).

Mesh 3 - Body Hair

Mesh 4 - Breast Hair

boin_hair

Also disappears before summoning Wicked Weaves (applies to pl0000, pl004b, & pl0064).

Mesh 4 - Breast Hair

Mesh 5 - Breast Cover

boin_hair2

Hidden when not summoning Wicked Weaves, appears while summoning it (applies to pl0000, pl004b, & pl0064). Allows Durga/Odette effects.

Mesh 5 - Breast Cover

Mesh 6 - Side Bangs

front_hair_ura

Allows Durga/Odette effects.

Mesh 6 - Side Bangs

Mesh 7 - Back Hair

back_hair_ura

Allows Durga/Odette effects.

Mesh 7 - Back Hair

Mesh 8 - In-game Face and Eyes

face_game

Shown during normal gameplay, and hidden during cutscenes. Typically uses bones 003 - 006.

Mesh 8 - In-game Face and Eyes

Mesh 9 - In-game Eyeshadow, Eyebrows, & Eyelashes

eye_kage_game

Also shown during normal gameplay, and hidden during cutscenes. Uses bone 006 only.

Mesh 9 - In-game Eyeshadow, Eyebrows, & Eyelashes

Mesh 10 - Cutscene Face, Mouth, & Eyes

face_event2

Shown during cutscenes, and hidden during normal gameplay. Typically uses global bones 197 - 257.

Mesh 10 - Cutscene Face, Mouth, & Eyes

Mesh 11 - Cutscene Eyeshadow, Eyebrows, & Eyelashes

eye_kage_event1

Also shown during cutscenes, and hidden during normal gameplay. Typically uses global bones 197 - 257.

Mesh 11 - Cutscene Eyeshadow, Eyebrows, & Eyelashes

Mesh 12 - Extra Back Hair

hair_drill3

Allows Durga/Odette effects. BEWARE: Normals are reversed on this mesh.

Mesh 12 - Extra Back Hair

Mesh 13 - Front Bangs

front_hair_omote

Allows Durga/Odette effects.

Mesh 13 - Front Bangs

Mesh 14 - Chains & Emblems

chain

Disappears before summoning Wicked Weaves but stays during Infernal Summons (applies to pl0000, pl004b, & pl0064).

Mesh 14 - Chains & Emblems

Mesh 15 - Trapezoid

glass_renz

No known attributes.

Mesh 15 - Trapezoid

Mesh 16 - Right Cutscene Hand / Mesh 17 - Left Cutscene Hand

R_hand_0 / L_hand_0

Used during cutscenes. Hides during gameplay.

Mesh 16 - Right Cutscene HandMesh 16 - Left Cutscene Hand

Mesh 18 - Right Handguns Hand / Mesh 19 - Left Handguns Hand

R_hand_1 / L_hand_1

Used when Handguns are equipped or when not holding anything.

Mesh 18 - Right Handguns HandMesh 19 - Left Handguns Hand

Mesh 20 - Right Weapons Hand / Mesh 21 - Left Weapons Hand

R_hand_2 / L_hand_2

Used by all weapons except Shuraba & Kulshedra.

Mesh 20 - Right Weapons HandMesh 21 - Left Weapons Hand

Mesh 22 - Right Shuraba & Kulshedra Hand / Mesh 23 - Left Shuraba Hand

R_hand_3 / L_hand_3

Right hand is used by Shuraba & Kulshedra, Left hand is used by Shuraba only.

Mesh 22 - Right Shuraba & Kulshedra HandMesh 23 - Left Shuraba Hand

Mesh 24 - Shoes

boots

Used by Odette. Hides itself when Odette is equipped.

Mesh 24 - Shoes

Mesh 25 - Umbran Watch

watch

Visible during gameplay, also used during cutscenes. Disappears when Jeanne steals this.

Mesh 25 - Umbran Watch

Mesh 26 - Gem

juwel

Visible during gameplay, also used during cutscenes. Disappears when Jeanne holds it after Isla Del Sol fight.

Mesh 26 - Gem

Mesh 27 - Mole Cover

hokuro_cover

Mole cover when translated, appears only on imposter Bayonetta (Joy) after taking Cereza.

Mesh 27 - Mole Cover

Mesh 28 - Glasses

glass

Should be bound to global bone 078.

Mesh 28 - Glasses

Mesh 29 - Lenses

glass_renz1

Should be bound to global bone 078.

Mesh 29 - Lenses

Note: The game does not mind models having less than or more than 30 meshes.

Bayonetta 1 Bone Structure

It has to be noted that in Bayonetta several model share the same animations. For this to work, models need to share a common basic skeleton and motions need to be able to reference it. In model files, bones are numbered from 0 to bone_count - 1. Thus in order to have a common numbering between animation swappable model a translation table is provided in each model. Bone numbers inside a model will be called local bone indexes or local bone numbers, and bone numbers shared between models will be called global bone indexes or global bone numbers.

The mapping between the local and global bone numbers can be obtained, for a given model, by the get_bone_map.rb command.

Animation Relevant Bones and Their Description

The following table will describe each bones involved in animation. This table is a WIP as bones that are used to attached other objects are not fully understood yet. The end of the list (bone 197 and onward) are dedicated to the cutscene head animation.

Global Bone Number Parent Bone Number Bone Description
0 base bone
1 0 base of body
2 1 middle of belly
3 2 top of belly
4 3 base of game neck
5 4 middle of game neck
6 5 base of game head
7 3 right clavicle
8 7 right shoulder
9 8 right shoulder second bone
10 9 right elbow
11 10 right wrist
12 11 right wrist second bone
13 3 left clavicle
14 13 left shoulder
15 14 left shoulder second bone
16 15 left elbow
17 16 left wrist
18 17 left wrist second bone
19 0 hip
20 19 right hip joint
21 20 right knee
22 21 right ankle
23 22 right foot
24 19 left hip joint
25 24 left knee
26 25 left ankle
27 26 left foot
28 3 breast bone
29 10 right elbow second bone
30 10 middle of rigth forearm
31 16 left elbow second bone
32 16 middle of left forearm
33 19 right hip joint second bone
34 21 right knee second bone
35 19 left hip joint second bone
36 25 left knee second bone
37 12 right thumb metacarpal
38 37 right thumb first phalanx
39 38 right thumb second phalanx
40 12 right index finger metacarpal
41 40 right index finger first phalanx
42 41 right index finger second phalanx
43 42 right index finger third phalanx
44 12 right middle finger metacarpal
45 44 right middle finger first phalanx
46 45 right middle finger second phalanx
47 46 right middle finger third phalanx
48 12 right ring finger metacarpal
49 48 right ring finger first phalanx
50 49 right ring finger second phalanx
51 50 right ring finger third phalanx
52 12 right little finger metacarpal
53 52 right little finger first phalanx
54 53 right little finger second phalanx
55 54 right little finger third phalanx
56 18 left thumb metacarpal
57 56 left thumb first phalanx
58 57 left thumb second phalanx
59 18 left index finger metacarpal
60 59 left index finger first phalanx
61 60 left index finger second phalanx
62 61 left index finger third phalanx
63 18 left middle finger metacarpal
64 63 left middle finger first phalanx
65 64 left middle finger second phalanx
66 65 left middle finger third phalanx
67 18 left ring finger metacarpal
68 67 left ring finger first phalanx
69 68 left ring finger second phalanx
70 69 left ring finger third phalanx
71 18 left little finger metacarpal
72 71 left little finger first phalanx
73 72 left little finger second phalanx
74 73 left little finger third phalanx
78 6 glasses attach, middle of head
107 3 or 2 right butterfly shadow wing
108 3 or 2 left butterfly shadow wing
149 summoning hair connector bone
197 3 base of cutscene neck
198 197 middle of cutscene neck
199 198 base of cutscene head
201 199 jaw hinge
202 199 throat
203 201 chin
204 199 upper lip center
205 199 upper lip middle left
206 199 upper lip far left
207 199 lower lip far left
208 199 lower lip middle left 2
209 201 lower lip middle left 1
210 201 lower lip center
211 199 upper lip middle right
212 199 lower lip far right
213 199 upper lip far right
214 199 lower lip middle right 2
215 201 lower lip middle right 1
216 199 top of nose bridge
217 201 between chin and lips
218 199 left cheek
219 199 left lower cheek
220 199 left cheekbone
221 199 left jaw joint
222 199 left eye upper eyelid left
223 199 right cheek
224 199 right lower cheek
225 199 right cheekbone
226 199 right jaw joint
227 199 left eye top eyelid center
228 199 left eye left corner
229 199 left eye bottom eyelid left
230 199 left eye bottom eyelid right
231 199 right eye top eyelid center
232 199 right eye right corner
233 199 right eye bottom eyelid right
234 199 right eye bottom eyelid left
235 199 bottom of forehead
236 199 left eyebrow right
237 199 left eyebrow center
238 199 left eyebrow left
239 199 right eyebrow left
240 199 right eyebrow center
241 199 right eyebrow right
242 199 left eye
243 199 right eye
244 199 throat
245 201 attach tongue
246 201 middle tongue
252 199 nose
253 199 between nose and upper lip
254 199 left eye upper eyelid right
255 246 tip of tongue
256 199 right eye upper eyelid right
257 199 right eye upper eyelid left