|
OpenBF1942-Plus
Refractor 1, rebuilt from scratch
|
Status: structure verified, pose semantics partly verified. tools/anim.py parses all 86 .ske, 120 .skn and 1,593 .baf files of bf1942, XPack1 and XPack2 exactly to their end.
Little-endian. Names are u16 length + bytes including a trailing NUL.
| Field | Notes |
|---|---|
| u32 version | 1 |
| u32 nbones | |
| per bone | name, i16 parent (-1 = root; parents always come first), f32[12] row-major [R \| t] relative to the parent |
The stored pose is not the skin's bind pose (the flag skeleton holds a waving frame); skinning does not need a bind pose, see below.
| Field | Notes |
|---|---|
| u32 version | 1 |
| u32 nrecords | one per unique vertex position |
| per record | f32 pos[3] (mesh space), u8 n, n × { u16 bone, f32 weight, f32 offset[3] } |
| u16 nbones, names | bone table: bone indexes this list; names match skeleton bones |
| Field | Notes |
|---|---|
| u32 version | 3 |
| u16 nbones, names | bones this animation drives |
| u32 nframes, u8 prec | prec 11–15 |
| per bone | u16 total_words, then 7 channels: qx qy qz qw px py pz |
| per channel | u16 words, then blocks until words are used |
| block | u8 head, u8 (unused); n = head & 0x7f; head & 0x80: one i16 repeated n times, else n literal i16 |
Every channel decodes to exactly nframes values; total_words = sum of the channel words.
Values: quaternion component = v / 32767 (unit length, verified); position = v / 2^prec metres (verified: thigh offset 0.094 m matches the skeleton). A bone's local transform is T(p) · R(q*), with the rotation matrix of the conjugate quaternion (−x, −y, −z, w) for column vectors. We checked this in the data, not against the original: with the root rule below, the legs line up with the torso (3° instead of 11°), feet to head is 1.52 m (1.37 m read straight), knees bend forward in all 26 samples of the run cycle, and the left hand lies on the axis of the held weapon (see below). Read straight, soldiers leaned back about 28° and held weapons crossways.
Bones not driven by any active animation keep the skeleton's local matrix. Soldiers combine a lower-body animation (Bip01, pelvis, legs, Spine Root) with an upper-body one (spine, arms, head).
animations/animationstates.con (and the files it runs) define AnimationStateMachine.createState <name> followed by addAnimation <baf> <speed> <flags>, transitions and idles. Templates select states with setAnimationState [index] <state>: flags use FlagBlow; soldiers use index 0 (lower body, Lb_Stand) and 1 (upper body, Ub_StandAim, completed with the weapon name, e.g. Ub_StandAimThompson).
The viewer plays the first animation of each state, looping at 25 frames per second × speed — the frame rate is a guess. A negative speed plays backwards (Lb_RunBackward -1.6, Lb_ClimbLadder1B -5.6). The legs run at their own state's speed (before 2026-11-14 at the item's first state's, so Lb_RunBackward ran forwards). Transitions, idles and weapon selection are not implemented.
Biped animations (Bip01 root) are in 3ds Max space: up is −z, facing +y, the feet near z = −0.1 and the pelvis at z = −1.0. pose() keeps the animated root and turns everything a quarter turn about x, mapping (x, y, z) to (x, −z, y). The result is Y-up, facing +z, standing on the object origin, with no further turn when drawn.
Hand weapons have their own skeleton:
We draw each part at:
soldier hand × main bone local × locals below it × R_y(180°)
Without the 180° turn the barrel points back through the body and the left hand sits on the barrel axis behind the grip. With it, the left hand is on the forestock (M1 Garand: butt 0.29 m behind the grip, left hand 0.27 m ahead, muzzle 0.82 m ahead). The turn is fitted, not explained. It turns each part's mesh, not its bone offset: turning the offsets too put the Colt's slide 4 cm behind the frame (barrel bare, slide over the hand) and the MP40's magazine under the pistol grip. With the turn last, the slide's front meets the muzzle, the hammer sits at the slide's rear and the MP40's magazine hangs from its well.
Upper-body states are per weapon: copyState2 <new> <from> [<3p> <speed> <1p> <speed>] copies the state just created, replacing <from> in its name and animation paths (e.g. Ub_StandAimThompson → Ub_StandAimBar1918, with the bar1918 animations when they exist). There are 1,217 calls. copyState takes the same arguments for weapons that borrow another's third-person animations (K98, K98Sniper, No4Sniper from No4; Panzershreck from Bazooka; WalterP38 from Colt); until it was read those weapons had no arm, fire or reload states. Weapon states (Weapon*, which pose the weapon's own skeleton) use the weapon's own animation when it exists (WalterP38Reload.baf), else the borrowed one (WlaterP38OutOfAmmo.baf is misspelt in the archives, so the Walther locks its slide with the Colt's animation).
Per weapon, from the Thompson states through copyState2:
| State | Plays | When |
|---|---|---|
| Ub_Fire<w> / Ub_LieFire<w> | looping (c_AsmLooping); fireOnce weapons once from the shot (their weapon states are c_AsmPlayOnce, copied from WeaponFireDetonator) | while shots come within 1.5 rounds' interval (at least 0.25 s; ours) |
| Ub_StandReload<w> / Ub_LieReload<w> | once (c_AsmPlayOnce) | from the start of a reload |
| WeaponFire<w>, WeaponReload<w> | on the weapon's own skeleton (bolt, magazine) | the same moments |
Reloads (the arms and the weapon's own animation) are stretched to the weapon's reloadTime. The 3p reload animations (35–37 frames at speed 0.4) match it at 25 fps, but the 1p ones have 99–231 frames: at a fixed rate they were cut off halfway through the new magazine, as the maintainer saw. The upper body runs at its own speed and start time while the legs keep theirs; pose() takes one frame per animation. The state machine's own transitions (addTransitionOne c_PIFire …) are not interpreted.
Swimming, ladders, free falls, parachutes and jumps replace the walking states (AnimationStatesSwim, Climb, Parachute, Jump):
| Situation | Lower / upper state | Weapon |
|---|---|---|
| swimming forward / backward / still | Lb_ / Ub_SwimForward, SwimBackward, Floating | hidden (c_AsmHideWeapon on the lower state) |
| on a ladder: up / down / holding on | ClimbLadder1, ClimbLadder1B (speed -5.6, backwards), ClimbLadderIdle1 | hidden |
| free fall past 10 m/s | ParachuteFall (the explosion fly animation) | hidden |
| parachute open | Lb_ParachuteIdle, upper body unchanged | held |
| in the air up to 1.5 s after a jump | Lb_StandJump / Lb_RunJump, once from the jump | held |
Shortcuts: one climb cycle loops (the start, end and exit states are not played), as do the swim states without Lb_StartSwim / Lb_EndSwim; in first person the arms take the same upper states.
WeaponReload<w> ends in StopDummyState; we then leave the weapon at its skeleton's rest pose. Checked on the Colt and Walther P38: the slide (mantel) is forward at rest and at the last reload frame, back in the first 60 of 156 frames and in <w>OutOfAmmo.baf (played once from the last shot and held when the magazine and every spare are empty: an empty magazine with spares reloads at once). A maintainer report of the slide always looking back was the part placement above, not the states.