mirror of
https://github.com/Kelsidavis/WoWee.git
synced 2026-05-11 11:33:52 +00:00
949a6e0182
Novel replacement for the implicit movementState->animation
binding that vanilla WoW baked into per-race M2 model files.
Each WPHM entry binds one (raceId, genderId, movementState)
tuple to a base M2 animation sequence id, an optional variant
sequence (drunk-walk, wounded-run), and a blend transition
duration in milliseconds.
8-state machine: Idle / Walk / Run / Swim / Fly / Sit / Mount /
Death. Three presets each emit the full 16 bindings (M+F):
--gen-phm-human 16 bindings with drunk-walk variant on Walk
--gen-phm-orc 16 bindings with AttackRun variant on Run
for war-stance flavor
--gen-phm-undead 16 bindings with canonical shambling variant
(anim 38) on Run for low-health renderer
override + slower swim transition (undead are
awkward in water)
Validator catches: id required, raceId 1..10, genderId 0..1,
movementState 0..7, no duplicate mapIds, no duplicate
(race,gender,state) triples (renderer dispatch ambiguity),
baseAnimId=0 forbidden on non-Idle states (model would freeze
when entering that state). Warns on variantAnimId==baseAnimId
(no-op overhead) and transitionMs > 2000 (would feel like
animation hang).
Format count 126 -> 127. CLI flag count 1337 -> 1344.
125 lines
4.5 KiB
C++
125 lines
4.5 KiB
C++
#pragma once
|
|
|
|
#include <cstdint>
|
|
#include <string>
|
|
#include <vector>
|
|
|
|
namespace wowee {
|
|
namespace pipeline {
|
|
|
|
// Wowee Open Player Movement-to-Animation Map (.wphm)
|
|
// — novel replacement for the implicit
|
|
// movementState->animation mapping vanilla WoW baked
|
|
// into per-race M2 model files. Each WPHM entry binds
|
|
// one (raceId, genderId, movementState) tuple to a
|
|
// base animation sequence ID + an optional variant
|
|
// (e.g. wounded run, drunk walk) and a transition
|
|
// blend duration.
|
|
//
|
|
// Cross-references with previously-added formats:
|
|
// WCDB: raceId references the playable-race
|
|
// catalog (currently 1..10 in vanilla:
|
|
// Human=1, Orc=2 ... Troll=8, Goblin=9,
|
|
// BloodElf=10).
|
|
// None to M2 binary directly — animation index
|
|
// numbers come from the standard WoW M2 animation
|
|
// table (Stand=0, Walk=4, Run=5, Death=1...).
|
|
//
|
|
// Binary layout (little-endian):
|
|
// magic[4] = "WPHM"
|
|
// version (uint32) = current 1
|
|
// nameLen + name (catalog label)
|
|
// entryCount (uint32)
|
|
// entries (each):
|
|
// mapId (uint32) — surrogate primary key
|
|
// for cross-format
|
|
// --catalog-find lookups
|
|
// raceId (uint8) — 1..10 vanilla race
|
|
// genderId (uint8) — 0=male, 1=female
|
|
// movementState (uint8) — 0=Idle / 1=Walk / 2=Run
|
|
// / 3=Swim / 4=Fly /
|
|
// 5=Sit / 6=Mount /
|
|
// 7=Death
|
|
// pad0 (uint8)
|
|
// baseAnimId (uint32) — M2 anim sequence id
|
|
// variantAnimId (uint32) — alternate sequence
|
|
// (0 = no variant)
|
|
// transitionMs (uint16) — blend duration to enter
|
|
// pad1 (uint16)
|
|
struct WoweePlayerMovementAnim {
|
|
enum MovementState : uint8_t {
|
|
StateIdle = 0,
|
|
StateWalk = 1,
|
|
StateRun = 2,
|
|
StateSwim = 3,
|
|
StateFly = 4,
|
|
StateSit = 5,
|
|
StateMount = 6,
|
|
StateDeath = 7,
|
|
};
|
|
|
|
struct Entry {
|
|
uint32_t mapId = 0;
|
|
uint8_t raceId = 0;
|
|
uint8_t genderId = 0;
|
|
uint8_t movementState = StateIdle;
|
|
uint8_t pad0 = 0;
|
|
uint32_t baseAnimId = 0;
|
|
uint32_t variantAnimId = 0;
|
|
uint16_t transitionMs = 0;
|
|
uint16_t pad1 = 0;
|
|
};
|
|
|
|
std::string name;
|
|
std::vector<Entry> entries;
|
|
|
|
bool isValid() const { return !entries.empty(); }
|
|
|
|
const Entry* findById(uint32_t mapId) const;
|
|
|
|
// Returns the binding for a specific (race, gender,
|
|
// state) — the canonical lookup the renderer uses
|
|
// each frame to decide which animation sequence to
|
|
// play.
|
|
const Entry* find(uint8_t raceId, uint8_t genderId,
|
|
uint8_t state) const;
|
|
|
|
// Returns all bindings for a race+gender combo.
|
|
// Used by character-preview UIs to show the full
|
|
// state machine for one model.
|
|
std::vector<const Entry*> findByRaceGender(uint8_t raceId,
|
|
uint8_t genderId) const;
|
|
};
|
|
|
|
class WoweePlayerMovementAnimLoader {
|
|
public:
|
|
static bool save(const WoweePlayerMovementAnim& cat,
|
|
const std::string& basePath);
|
|
static WoweePlayerMovementAnim load(const std::string& basePath);
|
|
static bool exists(const std::string& basePath);
|
|
|
|
// Preset emitters used by --gen-phm* variants.
|
|
//
|
|
// makeHumanMovement — full 8-state machine for
|
|
// Human male + female =
|
|
// 16 entries. Walk-while-
|
|
// drunk variant for State
|
|
// Walk only.
|
|
// makeOrcMovement — same shape for Orc male
|
|
// + female. Orc Run uses
|
|
// a more aggressive
|
|
// variant for war-stance
|
|
// flavor.
|
|
// makeUndeadMovement — Undead male + female,
|
|
// with canonical
|
|
// "shambling-when-wounded"
|
|
// variantAnimId on Run
|
|
// state (low-health
|
|
// renderer override).
|
|
static WoweePlayerMovementAnim makeHumanMovement(const std::string& catalogName);
|
|
static WoweePlayerMovementAnim makeOrcMovement(const std::string& catalogName);
|
|
static WoweePlayerMovementAnim makeUndeadMovement(const std::string& catalogName);
|
|
};
|
|
|
|
} // namespace pipeline
|
|
} // namespace wowee
|