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 1 - Beehive Hair, Ribbon, Chain, and Earrings
hair_drill
Allows Durga/Odette effects, but also shows transparency as black during cutscenes.
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 3 - Body Hair / Transition Hair
change_hair
Disappears before summoning Wicked Weaves and Infernal Summons (applies to pl0000
, pl004b
, & pl0064
).
Mesh 4 - Breast Hair
boin_hair
Also disappears before summoning Wicked Weaves (applies to pl0000
, pl004b
, & pl0064
).
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 6 - Side Bangs
front_hair_ura
Allows Durga/Odette effects.
Mesh 7 - Back Hair
back_hair_ura
Allows Durga/Odette effects.
Mesh 8 - In-game Face and Eyes
face_game
Shown during normal gameplay, and hidden during cutscenes. Typically uses bones 003
- 006
.
Mesh 9 - In-game Eyeshadow, Eyebrows, & Eyelashes
eye_kage_game
Also shown during normal gameplay, and hidden during cutscenes. Uses bone 006
only.
Mesh 10 - Cutscene Face, Mouth, & Eyes
face_event2
Shown during cutscenes, and hidden during normal gameplay. Typically uses global bones 197
- 257
.
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 12 - Extra Back Hair
hair_drill3
Allows Durga/Odette effects. BEWARE: Normals are reversed on this mesh.
Mesh 13 - Front Bangs
front_hair_omote
Allows Durga/Odette effects.
Mesh 14 - Chains & Emblems
chain
Disappears before summoning Wicked Weaves but stays during Infernal Summons (applies to pl0000
, pl004b
, & pl0064
).
Mesh 15 - Trapezoid
glass_renz
No known attributes.
Mesh 16 - Right Cutscene Hand / Mesh 17 - Left Cutscene Hand
R_hand_0 / L_hand_0
Used during cutscenes. Hides during gameplay.
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 20 - Right Weapons Hand / Mesh 21 - Left Weapons Hand
R_hand_2 / L_hand_2
Used by all weapons except Shuraba & Kulshedra.
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 24 - Shoes
boots
Used by Odette. Hides itself when Odette is equipped.
Mesh 25 - Umbran Watch
watch
Visible during gameplay, also used during cutscenes. Disappears when Jeanne steals this.
Mesh 26 - Gem
juwel
Visible during gameplay, also used during cutscenes. Disappears when Jeanne holds it after Isla Del Sol fight.
Mesh 27 - Mole Cover
hokuro_cover
Mole cover
when translated, appears only on imposter Bayonetta (Joy) after taking Cereza.
Mesh 28 - Glasses
glass
Should be bound to global bone 078
.
Mesh 29 - Lenses
glass_renz1
Should be bound to global bone 078
.
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 |