mirror of
https://github.com/Kelsidavis/WoWee.git
synced 2026-05-11 03:23:51 +00:00
Open replacement for AzerothCore's playercreateinfo SQL table plus the per-class/race starting fields in CharStartOutfit.dbc. Defines the initial state for a newly created character: starting map / zone / position / facing, bind point (Hearthstone destination), up to 4 starting items with counts, and up to 4 starting spells. One entry per (race, class) combination — a Human Warrior spawns at Northshire Abbey with a Worn Shortsword and Heroic Strike already learned, while an Orc Hunter spawns in Valley of Trials with Aimed Shot and a starter rifle. Death Knights have their own preset spawning at lvl 55 in Acherus, the Ebon Hold. The race+class fields are bitmasks (mirroring WCHC layout) so one profile entry can cover multiple class/race combinations that share starting state. findByRaceClass(raceBit, classBit) is the engine helper used by character creation. Cross-references back to WCHC (race/class bit layouts), WMS (map ids), WIT (starting item ids), and WSPL (starting spell ids). Three preset emitters: --gen-psp (5 Alliance combos covering each starting zone from Northshire to Ammen Vale), --gen-psp-horde (5 Horde combos from Valley of Trials to Sunstrider Isle), --gen-psp-dk (2 DK combos at lvl 55 in Acherus with Death Coil / Plague Strike / Death Grip starter loadout). Validation enforces id+name+race+class+startingLevel presence, no duplicate ids; warns on (0,0,0) spawn (uninitialized entry), item id/count mismatch (granted item without count or vice versa), startingLevel > 80 (above WotLK cap), and Death Knight class with startingLevel < 55 (DKs canonically start at 55). Wired through the cross-format table; WPSP appears automatically in all 12 cross-format utilities. Format count 76 -> 77; CLI flag count 951 -> 956.
138 lines
5 KiB
C++
138 lines
5 KiB
C++
#pragma once
|
|
|
|
#include <cstdint>
|
|
#include <string>
|
|
#include <vector>
|
|
|
|
namespace wowee {
|
|
namespace pipeline {
|
|
|
|
// Wowee Open Player Spawn Profile catalog (.wpsp) —
|
|
// novel replacement for AzerothCore's playercreateinfo
|
|
// SQL table plus the per-class/race starting fields in
|
|
// CharStartOutfit.dbc. Defines the initial state for a
|
|
// newly created character: starting map / zone /
|
|
// position, bind point (Hearthstone destination),
|
|
// starting items, and starting spells.
|
|
//
|
|
// One entry per (class, race) combination — a Human
|
|
// Warrior spawns at Northshire Abbey with a Warrior's
|
|
// Hammer and Heroic Strike already learned, while an
|
|
// Orc Hunter spawns in Valley of Trials with a starter
|
|
// gun and Aimed Shot. Death Knights have their own
|
|
// preset spawning at lvl 55 in Acherus.
|
|
//
|
|
// Cross-references with previously-added formats:
|
|
// WCHC: race / class fields use the same bit layout
|
|
// as WCHC class / race IDs.
|
|
// WMS: mapId / bindMapId reference WMS map entries.
|
|
// WIT: startingItem*Id reference WIT item entries.
|
|
// WSPL: startingSpell*Id reference WSPL spell entries.
|
|
//
|
|
// Binary layout (little-endian):
|
|
// magic[4] = "WPSP"
|
|
// version (uint32) = current 1
|
|
// nameLen + name (catalog label)
|
|
// entryCount (uint32)
|
|
// entries (each):
|
|
// profileId (uint32)
|
|
// nameLen + name
|
|
// descLen + description
|
|
// raceMask (uint32)
|
|
// classMask (uint32)
|
|
// mapId (uint32)
|
|
// zoneId (uint32)
|
|
// spawnX (float) / spawnY (float) / spawnZ (float)
|
|
// spawnFacing (float)
|
|
// bindMapId (uint32)
|
|
// bindZoneId (uint32)
|
|
// startingItem1Id (uint32) / startingItem1Count (uint32)
|
|
// startingItem2Id (uint32) / startingItem2Count (uint32)
|
|
// startingItem3Id (uint32) / startingItem3Count (uint32)
|
|
// startingItem4Id (uint32) / startingItem4Count (uint32)
|
|
// startingSpell1Id (uint32)
|
|
// startingSpell2Id (uint32)
|
|
// startingSpell3Id (uint32)
|
|
// startingSpell4Id (uint32)
|
|
// startingLevel (uint8) / pad[3]
|
|
// iconColorRGBA (uint32)
|
|
struct WoweePlayerSpawnProfile {
|
|
struct Entry {
|
|
uint32_t profileId = 0;
|
|
std::string name;
|
|
std::string description;
|
|
uint32_t raceMask = 0;
|
|
uint32_t classMask = 0;
|
|
uint32_t mapId = 0;
|
|
uint32_t zoneId = 0;
|
|
float spawnX = 0.0f;
|
|
float spawnY = 0.0f;
|
|
float spawnZ = 0.0f;
|
|
float spawnFacing = 0.0f;
|
|
uint32_t bindMapId = 0;
|
|
uint32_t bindZoneId = 0;
|
|
uint32_t startingItem1Id = 0;
|
|
uint32_t startingItem1Count = 0;
|
|
uint32_t startingItem2Id = 0;
|
|
uint32_t startingItem2Count = 0;
|
|
uint32_t startingItem3Id = 0;
|
|
uint32_t startingItem3Count = 0;
|
|
uint32_t startingItem4Id = 0;
|
|
uint32_t startingItem4Count = 0;
|
|
uint32_t startingSpell1Id = 0;
|
|
uint32_t startingSpell2Id = 0;
|
|
uint32_t startingSpell3Id = 0;
|
|
uint32_t startingSpell4Id = 0;
|
|
uint8_t startingLevel = 1;
|
|
uint8_t pad0 = 0;
|
|
uint8_t pad1 = 0;
|
|
uint8_t pad2 = 0;
|
|
uint32_t iconColorRGBA = 0xFFFFFFFFu;
|
|
};
|
|
|
|
std::string name;
|
|
std::vector<Entry> entries;
|
|
|
|
bool isValid() const { return !entries.empty(); }
|
|
|
|
const Entry* findById(uint32_t profileId) const;
|
|
|
|
// Find the first profile whose race/class masks both
|
|
// include the given bits. Used by character creation
|
|
// to look up "Human Warrior" given race=Human(1) +
|
|
// class=Warrior(1).
|
|
const Entry* findByRaceClass(uint32_t raceBit,
|
|
uint32_t classBit) const;
|
|
};
|
|
|
|
class WoweePlayerSpawnProfileLoader {
|
|
public:
|
|
static bool save(const WoweePlayerSpawnProfile& cat,
|
|
const std::string& basePath);
|
|
static WoweePlayerSpawnProfile load(const std::string& basePath);
|
|
static bool exists(const std::string& basePath);
|
|
|
|
// Preset emitters used by --gen-psp* variants.
|
|
//
|
|
// makeAlliance — 5 Alliance combos covering each
|
|
// starting zone (Human Warrior in
|
|
// Northshire, Dwarf Hunter in Coldridge,
|
|
// NightElf Druid in Shadowglen, Gnome
|
|
// Mage in Anvilmar, Draenei Shaman
|
|
// in Ammen Vale).
|
|
// makeHorde — 5 Horde combos (Orc Warrior in
|
|
// Valley of Trials, Tauren Druid in
|
|
// Camp Narache, Undead Mage in Deathknell,
|
|
// Troll Hunter in Valley of Trials,
|
|
// BloodElf Priest in Sunstrider Isle).
|
|
// makeDeathKnight — 2 DK combos (Alliance Human DK and
|
|
// Horde Orc DK) starting at lvl 55 in
|
|
// Acherus, with the standard DK
|
|
// starter spell set.
|
|
static WoweePlayerSpawnProfile makeAlliance(const std::string& catalogName);
|
|
static WoweePlayerSpawnProfile makeHorde(const std::string& catalogName);
|
|
static WoweePlayerSpawnProfile makeDeathKnight(const std::string& catalogName);
|
|
};
|
|
|
|
} // namespace pipeline
|
|
} // namespace wowee
|