Systems
Transmog
Transmog puts the appearance of a cosmetic item onto an *action item* (a quest-reward piece of gear). The item keeps its own collectible, stats and attributes; only the worn/held look is replaced. The work is server-authoritative; the dialog is opened by an action.
Opening the dialog
Action opentransmog (no arguments), usable from any action list or as a dialogue trigger:
{ "id": "opentransmog", "args": [] }Real usage (albase warlord dialogue):
{ "code": "opentransmog", "owner": "npc", "type": "talk", "trigger": "opentransmog",
"text": [ { "value": "albase:dialogue-warlord-transmog-confirm" } ], "jumpTo": "close-now" }The dialog has three slots: source (your gear), target (the look to copy) and a read-only preview. A leftover transmog inventory from an earlier session is emptied back to the player when the action runs again. Closing the dialog without applying returns the items in both slots (dropped next to the player if the bags are full).
Rules
- Source slot accepts only *action items*: stacks that carry the action-item attribute
alegacyvsquest:actionsoralegacyvsquest:effects(items built by the quest item actions / item configs, see Items). Shift-click into the slot is ignored. - Target slot accepts a wearable (armor or clothing) or an attachable (backpack, face item, ...) whose slot type matches the source's slot type (for example
ArmorHead,UpperBody,face,back). Action items cannot be a target. The slot stays closed until the source slot is filled. - On apply, the source item is returned with the transmog stored on it and the cosmetic target item is consumed. The result goes to the player's inventory, or is dropped at their feet.
- Applying again overwrites the stored look, so an already-transmogged item can be re-transmogged.
- Old items from the former "full replacement" transmog are healed: their real collectible is restored before the new look is applied.
- Transmogged items show a
Transmogrifiedline in the tooltip.
Stored attributes: alegacyvsquest:transmog (code of the cosmetic item), alegacyvsquest:transmogSlot, alegacyvsquest:transmogBase. Because everything lives in the item's attributes, the look survives trading, chests and death.
Possible errors shown to the player: both slots must be filled, the left slot only accepts action items, items are incompatible by slot type, "Failed to apply transmog".
Removing a transmog
Action cleartransmog (no arguments) removes the transmog from the item in the player's active hotbar slot and gives it back its own look. The cosmetic item that was used is not returned. If the held item has no transmog the player gets the error "The item in your hand has no transmog."
{ "id": "cleartransmog", "args": [] }Quality looks
An item with a quality of the form <set>-<name> (for example trial-dim, duat-gilded, see Quality & Reroll) automatically renders as the item <code>-<name> if such an item exists next to the base item (same shape, recoloured texture; same domain). An explicit transmog always wins over the quality look. This applies to items and blocks alike.
Notes
- A
transmogachievement event fires on every successful apply (see Achievements). - Worn transmogs are re-checked on the client every 2 seconds. If one did not make it into the player model, the model is rebuilt once; each source-to-target pair is written once to the client log as
Transmog worn render.