phaneron/Kelsidavis-WoWee
1
0
Fork 0
mirror of https://github.com/Kelsidavis/WoWee.git synced 2026-05-11 03:23:51 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 2

feat(editor): add WIQR (Item Quality) open catalog format

Browse source 
Open replacement for the hardcoded item quality tiers in the
WoW client (Poor / Common / Uncommon / Rare / Epic / Legendary
/ Artifact / Heirloom). Defines each tier's tooltip text color,
inventory slot border color, vendor price multiplier, drop-level
gating, and disenchant eligibility.

The hardcoded client uses a fixed color table (gray/white/green/
blue/purple/orange/red/gold). This catalog lets server admins:
  - retune the colors (rename "Epic" to "Tier 1" with custom hex)
  - add server-custom tiers above Heirloom
  - change vendor markup per tier (legendary 50x base price)
  - gate quality drops by character level (Heirlooms unlock 80)

The standard preset reproduces the canonical 8-tier scale with
exact hex values from the live client (#9d9d9d through #00ccff)
and standard disenchant rules (Common+ disenchantable, Legendary
and Artifact aren't). The server-custom preset shows 4 tiers
above the standard range with non-standard pricing (Junk 0.1x,
QuestLocked 0.0x unsellable). The raid preset gates 4
progression tiers behind minLevelToDrop=60 with escalating
vendor multipliers up to 50x for Legendary.

Cross-references back to WIT — item entries reference qualityId
here for tooltip color and sort order. canDropAtLevel(id, lvl)
is the engine helper used by loot generation.

Validation enforces name presence, no duplicate ids,
vendorPriceMultiplier >= 0, minLevelToDrop <= maxLevelToDrop;
warns on:
  - minLevelToDrop > 80 (unreachable at WotLK cap)
  - vendorPriceMultiplier > 100x (sanity check the economy)
  - nameColorRGBA with alpha=0 (text would be invisible in
    tooltips — common bug when copy-pasting RGB hex without
    alpha byte)

Wired through the cross-format table; WIQR appears automatically
in all 15 cross-format utilities. Format count 83 -> 84; CLI
flag count 1003 -> 1008.
This commit is contained in:
Kelsi 2026-05-09 22:59:27 -07:00
parent 18f07f1b8a
commit efb88be366
10 changed files with 652 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

116
include/pipeline/wowee_item_qualities.hpp Normal file
View file

@ -0,0 +1,116 @@
#pragma once
#include <cstdint>
#include <string>
#include <vector>
namespace wowee {
namespace pipeline {
// Wowee Open Item Quality catalog (.wiqr) — novel
// replacement for the hardcoded item quality tiers in
// the WoW client (Poor / Common / Uncommon / Rare / Epic
// / Legendary / Artifact / Heirloom). Defines each tier's
// tooltip text color, inventory slot border color,
// vendor price multiplier, drop-level gating, and
// disenchant eligibility.
//
// The hardcoded client uses a static color table:
// Poor = gray #9d9d9d
// Common = white #ffffff
// Uncommon = green #1eff00
// Rare = blue #0070dd
// Epic = purple #a335ee
// Legendary = orange #ff8000
// Artifact = red #e6cc80
// Heirloom = gold #00ccff
//
// This catalog lets server admins:
// - retune the colors (rename "Epic" to "Tier 1" with a
// custom orange-red, etc.)
// - add server-custom tiers above Heirloom
// (Donator / Weekly / Anniversary)
// - change vendor markup per tier (legendary sells for
// 20x base price)
// - gate quality drops by character level (Heirlooms
// unlock at lvl 80)
//
// Cross-references with previously-added formats:
// WIT: item entries reference qualityId here for
// tooltip color and sort order.
//
// Binary layout (little-endian):
// magic[4] = "WIQR"
// version (uint32) = current 1
// nameLen + name (catalog label)
// entryCount (uint32)
// entries (each):
// qualityId (uint32)
// nameLen + name
// descLen + description
// nameColorRGBA (uint32)
// borderColorRGBA (uint32)
// vendorPriceMultiplier (float)
// minLevelToDrop (uint8) / maxLevelToDrop (uint8)
// canBeDisenchanted (uint8) / pad (uint8)
// borderTexLen + inventoryBorderTexture
struct WoweeItemQuality {
struct Entry {
uint32_t qualityId = 0;
std::string name;
std::string description;
uint32_t nameColorRGBA = 0xFFFFFFFFu;
uint32_t borderColorRGBA = 0xFFFFFFFFu;
float vendorPriceMultiplier = 1.0f;
uint8_t minLevelToDrop = 1;
uint8_t maxLevelToDrop = 0; // 0 = no max
uint8_t canBeDisenchanted = 0; // 0/1 bool
uint8_t pad0 = 0;
std::string inventoryBorderTexture;
};
std::string name;
std::vector<Entry> entries;
bool isValid() const { return !entries.empty(); }
const Entry* findById(uint32_t qualityId) const;
// Returns true if an item of this quality can drop
// for a character of the given level (gated by
// [minLevelToDrop, maxLevelToDrop] when maxLevelToDrop
// is non-zero).
bool canDropAtLevel(uint32_t qualityId,
uint8_t characterLevel) const;
};
class WoweeItemQualityLoader {
public:
static bool save(const WoweeItemQuality& cat,
const std::string& basePath);
static WoweeItemQuality load(const std::string& basePath);
static bool exists(const std::string& basePath);
// Preset emitters used by --gen-iqr* variants.
//
// makeStandard — 8 canonical WoW item quality
// tiers (Poor through Heirloom)
// with their standard hex colors
// and disenchant rules. Heirloom
// gated to lvl 80.
// makeServerCustom — 4 server-custom tiers
// (Junk / Weekly / QuestLocked /
// Donator) with custom colors and
// non-standard vendor multipliers.
// makeRaidTiers — 4 raid progression tiers
// (T1 lvl 60 / T2 lvl 60 / T3
// lvl 60 / Legendary lvl 60+)
// gated by minLevelToDrop and
// priced for server economy.
static WoweeItemQuality makeStandard(const std::string& catalogName);
static WoweeItemQuality makeServerCustom(const std::string& catalogName);
static WoweeItemQuality makeRaidTiers(const std::string& catalogName);
};
} // namespace pipeline
} // namespace wowee