mirror of
https://github.com/Kelsidavis/WoWee.git
synced 2026-05-10 19:13:52 +00:00
492d626c3b
Novel open replacement for AzerothCore-style
mail_loot_template SQL + the in-game mail subset of the
inventory + currency systems. The 34th open format added
to the editor.
Defines templated mail messages with currency + item
attachments. Triggered by quest reward delivery (overflow
when bag is full), auction house bid wins / sales,
achievement reward attachments, GM correspondence, holiday
event mailings (Brewfest samples, Hallow's End candy), and
returned-mail-on-rejection.
Cross-references with previously-added formats:
WMAL.entry.senderNpcId -> WCRT.entry.creatureId
WMAL.entry.attachments.itemId -> WIT.entry.itemId
Format:
• magic "WMAL", version 1, little-endian
• per template: templateId / senderNpcId / subject / body /
senderName / moneyCopperAttached / categoryId / cod /
returnable / expiryDays / attachments[] (each: itemId +
quantity)
Enums:
• Category (8): QuestReward / Auction / GmCorrespondence /
AchievementReward / EventMailing / Raffle /
ScriptDelivery / ReturnedMail
API: WoweeMailLoader::save / load / exists / findById.
Three preset emitters showcase typical mail templates:
• makeStarter — 3 templates (quest overflow / auction won /
GM gift) covering the 3 most common
categories
• makeHoliday — 4 holiday samples that cross-reference the
WTKN seasonal token IDs (200=Tricky Treats,
201=Brewfest, 202=Coin of Ancestry,
203=Stranger's Gift) so the demo content
stack ships a full holiday onboarding
experience
• makeAuction — 5-template auction-house family (outbid /
won / sold / expired / cancelled) — runtime
fills in actual bid amounts / sold items
at send time
CLI added (5 flags, 635 documented total now):
--gen-mail / --gen-mail-holiday / --gen-mail-auction
--info-wmal / --validate-wmal
Validator catches: templateId=0 + duplicates, empty subject,
neither senderNpcId nor senderName set (no displayable
sender), unknown category, expiryDays=0 (mail expires
immediately), cod=1 with no money attached (free COD),
empty mail in categories where the runtime doesn't fill in
content (skips Auction / GmCorrespondence / ReturnedMail
where empty templates are intentional).
Two bugs caught + fixed during smoke-test on the auction
preset:
• print formatting glued the `0` from senderNpcId after
the senderName when no NPC was set (rendered as
"Postmaster0" instead of "Postmaster") — fixed with an
explicit if/else split
• validator's "no money + no items" warning was too
aggressive for the Auction category, where templates
are intentionally informational and the runtime fills
in the real values — added Auction + ReturnedMail to
the skip list
|
||
|---|---|---|
| .. | ||
| adt_loader.hpp | ||
| asset_manager.hpp | ||
| asset_manifest.hpp | ||
| blp_loader.hpp | ||
| custom_zone_discovery.hpp | ||
| dbc_layout.hpp | ||
| dbc_loader.hpp | ||
| loose_file_reader.hpp | ||
| m2_loader.hpp | ||
| terrain_mesh.hpp | ||
| wdt_loader.hpp | ||
| wmo_loader.hpp | ||
| wowee_achievements.hpp | ||
| wowee_battlegrounds.hpp | ||
| wowee_building.hpp | ||
| wowee_chars.hpp | ||
| wowee_collision.hpp | ||
| wowee_creatures.hpp | ||
| wowee_events.hpp | ||
| wowee_factions.hpp | ||
| wowee_gossip.hpp | ||
| wowee_items.hpp | ||
| wowee_light.hpp | ||
| wowee_locks.hpp | ||
| wowee_loot.hpp | ||
| wowee_mail.hpp | ||
| wowee_maps.hpp | ||
| wowee_model.hpp | ||
| wowee_mounts.hpp | ||
| wowee_objects.hpp | ||
| wowee_quests.hpp | ||
| wowee_skills.hpp | ||
| wowee_sound.hpp | ||
| wowee_spawns.hpp | ||
| wowee_spells.hpp | ||
| wowee_talents.hpp | ||
| wowee_taxi.hpp | ||
| wowee_terrain_loader.hpp | ||
| wowee_titles.hpp | ||
| wowee_tokens.hpp | ||
| wowee_trainers.hpp | ||
| wowee_triggers.hpp | ||
| wowee_weather.hpp | ||
| wowee_world_map.hpp | ||