mirror of
https://github.com/Kelsidavis/WoWee.git
synced 2026-05-11 03:23:51 +00:00
feat(editor): add WPSP (Player Spawn Profile) open catalog format
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.
This commit is contained in:
Kelsi
parent
f606edc4c9
commit
082ee495dc
10 changed files with 789 additions and 0 deletions
342
src/pipeline/wowee_player_spawn_profiles.cpp
Normal file
342
src/pipeline/wowee_player_spawn_profiles.cpp
Normal file
|
|
@ -0,0 +1,342 @@
|
|||
#include "pipeline/wowee_player_spawn_profiles.hpp"
|
||||
|
||||
#include <cstdio>
|
||||
#include <cstring>
|
||||
#include <fstream>
|
||||
|
||||
namespace wowee {
|
||||
namespace pipeline {
|
||||
|
||||
namespace {
|
||||
|
||||
constexpr char kMagic[4] = {'W', 'P', 'S', 'P'};
|
||||
constexpr uint32_t kVersion = 1;
|
||||
|
||||
template <typename T>
|
||||
void writePOD(std::ofstream& os, const T& v) {
|
||||
os.write(reinterpret_cast<const char*>(&v), sizeof(T));
|
||||
}
|
||||
|
||||
template <typename T>
|
||||
bool readPOD(std::ifstream& is, T& v) {
|
||||
is.read(reinterpret_cast<char*>(&v), sizeof(T));
|
||||
return is.gcount() == static_cast<std::streamsize>(sizeof(T));
|
||||
}
|
||||
|
||||
void writeStr(std::ofstream& os, const std::string& s) {
|
||||
uint32_t n = static_cast<uint32_t>(s.size());
|
||||
writePOD(os, n);
|
||||
if (n > 0) os.write(s.data(), n);
|
||||
}
|
||||
|
||||
bool readStr(std::ifstream& is, std::string& s) {
|
||||
uint32_t n = 0;
|
||||
if (!readPOD(is, n)) return false;
|
||||
if (n > (1u << 20)) return false;
|
||||
s.resize(n);
|
||||
if (n > 0) {
|
||||
is.read(s.data(), n);
|
||||
if (is.gcount() != static_cast<std::streamsize>(n)) {
|
||||
s.clear();
|
||||
return false;
|
||||
}
|
||||
}
|
||||
return true;
|
||||
}
|
||||
|
||||
std::string normalizePath(std::string base) {
|
||||
if (base.size() < 5 || base.substr(base.size() - 5) != ".wpsp") {
|
||||
base += ".wpsp";
|
||||
}
|
||||
return base;
|
||||
}
|
||||
|
||||
uint32_t packRgba(uint8_t r, uint8_t g, uint8_t b, uint8_t a = 0xFF) {
|
||||
return (static_cast<uint32_t>(a) << 24) |
|
||||
(static_cast<uint32_t>(b) << 16) |
|
||||
(static_cast<uint32_t>(g) << 8) |
|
||||
static_cast<uint32_t>(r);
|
||||
}
|
||||
|
||||
// Race bits, mirroring WCHC layout. Used by presets.
|
||||
constexpr uint32_t RACE_HUMAN = 1u << 0;
|
||||
constexpr uint32_t RACE_ORC = 1u << 1;
|
||||
constexpr uint32_t RACE_DWARF = 1u << 2;
|
||||
constexpr uint32_t RACE_NIGHTELF = 1u << 3;
|
||||
constexpr uint32_t RACE_UNDEAD = 1u << 4;
|
||||
constexpr uint32_t RACE_TAUREN = 1u << 5;
|
||||
constexpr uint32_t RACE_GNOME = 1u << 6;
|
||||
constexpr uint32_t RACE_TROLL = 1u << 7;
|
||||
constexpr uint32_t RACE_BLOODELF = 1u << 9;
|
||||
constexpr uint32_t RACE_DRAENEI = 1u << 10;
|
||||
|
||||
// Class bits, mirroring WCHC layout. Used by presets.
|
||||
constexpr uint32_t CLS_WARRIOR = 1u << 0;
|
||||
constexpr uint32_t CLS_PALADIN = 1u << 1;
|
||||
constexpr uint32_t CLS_HUNTER = 1u << 2;
|
||||
constexpr uint32_t CLS_PRIEST = 1u << 4;
|
||||
constexpr uint32_t CLS_DK = 1u << 5;
|
||||
constexpr uint32_t CLS_SHAMAN = 1u << 6;
|
||||
constexpr uint32_t CLS_MAGE = 1u << 7;
|
||||
constexpr uint32_t CLS_DRUID = 1u << 10;
|
||||
|
||||
} // namespace
|
||||
|
||||
const WoweePlayerSpawnProfile::Entry*
|
||||
WoweePlayerSpawnProfile::findById(uint32_t profileId) const {
|
||||
for (const auto& e : entries)
|
||||
if (e.profileId == profileId) return &e;
|
||||
return nullptr;
|
||||
}
|
||||
|
||||
const WoweePlayerSpawnProfile::Entry*
|
||||
WoweePlayerSpawnProfile::findByRaceClass(uint32_t raceBit,
|
||||
uint32_t classBit) const {
|
||||
for (const auto& e : entries) {
|
||||
if ((e.raceMask & raceBit) && (e.classMask & classBit))
|
||||
return &e;
|
||||
}
|
||||
return nullptr;
|
||||
}
|
||||
|
||||
bool WoweePlayerSpawnProfileLoader::save(
|
||||
const WoweePlayerSpawnProfile& cat,
|
||||
const std::string& basePath) {
|
||||
std::ofstream os(normalizePath(basePath), std::ios::binary);
|
||||
if (!os) return false;
|
||||
os.write(kMagic, 4);
|
||||
writePOD(os, kVersion);
|
||||
writeStr(os, cat.name);
|
||||
uint32_t entryCount = static_cast<uint32_t>(cat.entries.size());
|
||||
writePOD(os, entryCount);
|
||||
for (const auto& e : cat.entries) {
|
||||
writePOD(os, e.profileId);
|
||||
writeStr(os, e.name);
|
||||
writeStr(os, e.description);
|
||||
writePOD(os, e.raceMask);
|
||||
writePOD(os, e.classMask);
|
||||
writePOD(os, e.mapId);
|
||||
writePOD(os, e.zoneId);
|
||||
writePOD(os, e.spawnX);
|
||||
writePOD(os, e.spawnY);
|
||||
writePOD(os, e.spawnZ);
|
||||
writePOD(os, e.spawnFacing);
|
||||
writePOD(os, e.bindMapId);
|
||||
writePOD(os, e.bindZoneId);
|
||||
writePOD(os, e.startingItem1Id);
|
||||
writePOD(os, e.startingItem1Count);
|
||||
writePOD(os, e.startingItem2Id);
|
||||
writePOD(os, e.startingItem2Count);
|
||||
writePOD(os, e.startingItem3Id);
|
||||
writePOD(os, e.startingItem3Count);
|
||||
writePOD(os, e.startingItem4Id);
|
||||
writePOD(os, e.startingItem4Count);
|
||||
writePOD(os, e.startingSpell1Id);
|
||||
writePOD(os, e.startingSpell2Id);
|
||||
writePOD(os, e.startingSpell3Id);
|
||||
writePOD(os, e.startingSpell4Id);
|
||||
writePOD(os, e.startingLevel);
|
||||
writePOD(os, e.pad0);
|
||||
writePOD(os, e.pad1);
|
||||
writePOD(os, e.pad2);
|
||||
writePOD(os, e.iconColorRGBA);
|
||||
}
|
||||
return os.good();
|
||||
}
|
||||
|
||||
WoweePlayerSpawnProfile WoweePlayerSpawnProfileLoader::load(
|
||||
const std::string& basePath) {
|
||||
WoweePlayerSpawnProfile out;
|
||||
std::ifstream is(normalizePath(basePath), std::ios::binary);
|
||||
if (!is) return out;
|
||||
char magic[4];
|
||||
is.read(magic, 4);
|
||||
if (std::memcmp(magic, kMagic, 4) != 0) return out;
|
||||
uint32_t version = 0;
|
||||
if (!readPOD(is, version) || version != kVersion) return out;
|
||||
if (!readStr(is, out.name)) return out;
|
||||
uint32_t entryCount = 0;
|
||||
if (!readPOD(is, entryCount)) return out;
|
||||
if (entryCount > (1u << 20)) return out;
|
||||
out.entries.resize(entryCount);
|
||||
for (auto& e : out.entries) {
|
||||
if (!readPOD(is, e.profileId)) {
|
||||
out.entries.clear(); return out;
|
||||
}
|
||||
if (!readStr(is, e.name) || !readStr(is, e.description)) {
|
||||
out.entries.clear(); return out;
|
||||
}
|
||||
if (!readPOD(is, e.raceMask) ||
|
||||
!readPOD(is, e.classMask) ||
|
||||
!readPOD(is, e.mapId) ||
|
||||
!readPOD(is, e.zoneId) ||
|
||||
!readPOD(is, e.spawnX) ||
|
||||
!readPOD(is, e.spawnY) ||
|
||||
!readPOD(is, e.spawnZ) ||
|
||||
!readPOD(is, e.spawnFacing) ||
|
||||
!readPOD(is, e.bindMapId) ||
|
||||
!readPOD(is, e.bindZoneId) ||
|
||||
!readPOD(is, e.startingItem1Id) ||
|
||||
!readPOD(is, e.startingItem1Count) ||
|
||||
!readPOD(is, e.startingItem2Id) ||
|
||||
!readPOD(is, e.startingItem2Count) ||
|
||||
!readPOD(is, e.startingItem3Id) ||
|
||||
!readPOD(is, e.startingItem3Count) ||
|
||||
!readPOD(is, e.startingItem4Id) ||
|
||||
!readPOD(is, e.startingItem4Count) ||
|
||||
!readPOD(is, e.startingSpell1Id) ||
|
||||
!readPOD(is, e.startingSpell2Id) ||
|
||||
!readPOD(is, e.startingSpell3Id) ||
|
||||
!readPOD(is, e.startingSpell4Id) ||
|
||||
!readPOD(is, e.startingLevel) ||
|
||||
!readPOD(is, e.pad0) ||
|
||||
!readPOD(is, e.pad1) ||
|
||||
!readPOD(is, e.pad2) ||
|
||||
!readPOD(is, e.iconColorRGBA)) {
|
||||
out.entries.clear(); return out;
|
||||
}
|
||||
}
|
||||
return out;
|
||||
}
|
||||
|
||||
bool WoweePlayerSpawnProfileLoader::exists(
|
||||
const std::string& basePath) {
|
||||
std::ifstream is(normalizePath(basePath), std::ios::binary);
|
||||
return is.good();
|
||||
}
|
||||
|
||||
WoweePlayerSpawnProfile WoweePlayerSpawnProfileLoader::makeAlliance(
|
||||
const std::string& catalogName) {
|
||||
using P = WoweePlayerSpawnProfile;
|
||||
WoweePlayerSpawnProfile c;
|
||||
c.name = catalogName;
|
||||
auto add = [&](uint32_t id, const char* name, uint32_t race,
|
||||
uint32_t cls, uint32_t map, uint32_t zone,
|
||||
float x, float y, float z, float facing,
|
||||
uint32_t i1, uint32_t i2, uint32_t i3,
|
||||
uint32_t s1, uint32_t s2, const char* desc) {
|
||||
P::Entry e;
|
||||
e.profileId = id; e.name = name; e.description = desc;
|
||||
e.raceMask = race; e.classMask = cls;
|
||||
e.mapId = map; e.zoneId = zone;
|
||||
e.spawnX = x; e.spawnY = y; e.spawnZ = z;
|
||||
e.spawnFacing = facing;
|
||||
e.bindMapId = map; e.bindZoneId = zone;
|
||||
e.startingItem1Id = i1; e.startingItem1Count = i1 ? 1 : 0;
|
||||
e.startingItem2Id = i2; e.startingItem2Count = i2 ? 1 : 0;
|
||||
e.startingItem3Id = i3; e.startingItem3Count = i3 ? 1 : 0;
|
||||
e.startingSpell1Id = s1;
|
||||
e.startingSpell2Id = s2;
|
||||
e.startingLevel = 1;
|
||||
e.iconColorRGBA = packRgba(100, 140, 240); // alliance blue
|
||||
c.entries.push_back(e);
|
||||
};
|
||||
// Map 0 = Eastern Kingdoms, Map 1 = Kalimdor, Map 530 = Outland.
|
||||
// Coordinates are illustrative — match standard 3.3.5a starting
|
||||
// positions for each race's home zone.
|
||||
add(1, "HumanWarrior", RACE_HUMAN, CLS_WARRIOR, 0, 9,
|
||||
-8949.95f, -132.49f, 83.53f, 0.0f,
|
||||
25, 38, 6948, 78, 81, "Human Warrior — Northshire Abbey, Elwynn Forest.");
|
||||
add(2, "DwarfHunter", RACE_DWARF, CLS_HUNTER, 0, 132,
|
||||
-6240.32f, 331.03f, 382.76f, 6.18f,
|
||||
117, 38, 6948, 75, 2480, "Dwarf Hunter — Coldridge Valley, Dun Morogh.");
|
||||
add(3, "NightElfDruid", RACE_NIGHTELF, CLS_DRUID, 1, 141,
|
||||
10311.30f, 832.97f, 1326.41f, 5.69f,
|
||||
2070, 38, 6948, 5176, 8946, "Night Elf Druid — Shadowglen, Teldrassil.");
|
||||
add(4, "GnomeMage", RACE_GNOME, CLS_MAGE, 0, 132,
|
||||
-6240.32f, 331.03f, 382.76f, 6.18f,
|
||||
2362, 38, 6948, 168, 5009, "Gnome Mage — Coldridge Valley, Dun Morogh.");
|
||||
add(5, "DraeneiShaman", RACE_DRAENEI, CLS_SHAMAN, 530, 3524,
|
||||
-3961.64f, -13931.20f, 100.61f, 2.08f,
|
||||
24146, 38, 6948, 403, 332, "Draenei Shaman — Ammen Vale, Azuremyst Isle.");
|
||||
return c;
|
||||
}
|
||||
|
||||
WoweePlayerSpawnProfile WoweePlayerSpawnProfileLoader::makeHorde(
|
||||
const std::string& catalogName) {
|
||||
using P = WoweePlayerSpawnProfile;
|
||||
WoweePlayerSpawnProfile c;
|
||||
c.name = catalogName;
|
||||
auto add = [&](uint32_t id, const char* name, uint32_t race,
|
||||
uint32_t cls, uint32_t map, uint32_t zone,
|
||||
float x, float y, float z, float facing,
|
||||
uint32_t i1, uint32_t i2, uint32_t i3,
|
||||
uint32_t s1, uint32_t s2, const char* desc) {
|
||||
P::Entry e;
|
||||
e.profileId = id; e.name = name; e.description = desc;
|
||||
e.raceMask = race; e.classMask = cls;
|
||||
e.mapId = map; e.zoneId = zone;
|
||||
e.spawnX = x; e.spawnY = y; e.spawnZ = z;
|
||||
e.spawnFacing = facing;
|
||||
e.bindMapId = map; e.bindZoneId = zone;
|
||||
e.startingItem1Id = i1; e.startingItem1Count = i1 ? 1 : 0;
|
||||
e.startingItem2Id = i2; e.startingItem2Count = i2 ? 1 : 0;
|
||||
e.startingItem3Id = i3; e.startingItem3Count = i3 ? 1 : 0;
|
||||
e.startingSpell1Id = s1;
|
||||
e.startingSpell2Id = s2;
|
||||
e.startingLevel = 1;
|
||||
e.iconColorRGBA = packRgba(220, 60, 60); // horde red
|
||||
c.entries.push_back(e);
|
||||
};
|
||||
add(100, "OrcWarrior", RACE_ORC, CLS_WARRIOR, 1, 14,
|
||||
-618.51f, -4251.67f, 38.71f, 4.74f,
|
||||
25, 38, 6948, 78, 81, "Orc Warrior — Valley of Trials, Durotar.");
|
||||
add(101, "TaurenDruid", RACE_TAUREN, CLS_DRUID, 1, 215,
|
||||
-2917.58f, -257.98f, 52.99f, 5.27f,
|
||||
2070, 38, 6948, 5176, 8946, "Tauren Druid — Camp Narache, Mulgore.");
|
||||
add(102, "UndeadMage", RACE_UNDEAD, CLS_MAGE, 0, 85,
|
||||
1676.71f, 1677.45f, 121.67f, 2.70f,
|
||||
2362, 38, 6948, 168, 5009, "Undead Mage — Deathknell, Tirisfal Glades.");
|
||||
add(103, "TrollHunter", RACE_TROLL, CLS_HUNTER, 1, 14,
|
||||
-618.51f, -4251.67f, 38.71f, 4.74f,
|
||||
117, 38, 6948, 75, 2480, "Troll Hunter — Valley of Trials, Durotar.");
|
||||
add(104, "BloodElfPriest", RACE_BLOODELF, CLS_PRIEST, 530, 3431,
|
||||
10349.60f, -6357.29f, 33.43f, 5.31f,
|
||||
24145, 38, 6948, 585, 2050, "Blood Elf Priest — Sunstrider Isle, Eversong.");
|
||||
return c;
|
||||
}
|
||||
|
||||
WoweePlayerSpawnProfile WoweePlayerSpawnProfileLoader::makeDeathKnight(
|
||||
const std::string& catalogName) {
|
||||
using P = WoweePlayerSpawnProfile;
|
||||
WoweePlayerSpawnProfile c;
|
||||
c.name = catalogName;
|
||||
auto add = [&](uint32_t id, const char* name, uint32_t race,
|
||||
const char* desc) {
|
||||
P::Entry e;
|
||||
e.profileId = id; e.name = name; e.description = desc;
|
||||
e.raceMask = race;
|
||||
e.classMask = CLS_DK;
|
||||
// Acherus, the Ebon Hold — instance map 609.
|
||||
e.mapId = 609; e.zoneId = 4298;
|
||||
e.spawnX = 2406.18f;
|
||||
e.spawnY = -5342.66f;
|
||||
e.spawnZ = 382.34f;
|
||||
e.spawnFacing = 1.43f;
|
||||
e.bindMapId = 609; e.bindZoneId = 4298;
|
||||
// Standard DK starter loadout: Acherus Knight's
|
||||
// sword, mail set, runeforging knowledge.
|
||||
e.startingItem1Id = 38147; // Tabard of the Lich King
|
||||
e.startingItem1Count = 1;
|
||||
e.startingItem2Id = 38149; // Acherus Knight sword
|
||||
e.startingItem2Count = 1;
|
||||
// Standard DK starter spells: Death Coil, Plague
|
||||
// Strike, Death Grip.
|
||||
e.startingSpell1Id = 47541; // Death Coil
|
||||
e.startingSpell2Id = 45462; // Plague Strike
|
||||
e.startingSpell3Id = 49576; // Death Grip
|
||||
e.startingLevel = 55;
|
||||
e.iconColorRGBA = packRgba(140, 240, 220); // DK frost cyan
|
||||
c.entries.push_back(e);
|
||||
};
|
||||
add(200, "AllianceHumanDK", RACE_HUMAN,
|
||||
"Alliance Human Death Knight — starts at lvl 55 in "
|
||||
"Acherus, the Ebon Hold.");
|
||||
add(201, "HordeOrcDK", RACE_ORC,
|
||||
"Horde Orc Death Knight — starts at lvl 55 in "
|
||||
"Acherus, the Ebon Hold.");
|
||||
return c;
|
||||
}
|
||||
|
||||
} // namespace pipeline
|
||||
} // namespace wowee
|
||||
Loading…
Add table
Add a link
Reference in a new issue