https://wiki.returnofreckoning.com/index.php?action=history&feed=atom&title=API%3ASetPlayerVariationAPI:SetPlayerVariation - Revision history2026-10-17T17:53:55ZRevision history for this page on the wikiMediaWiki 1.43.11https://wiki.returnofreckoning.com/index.php?title=API:SetPlayerVariation&diff=30734&oldid=prevMaintenance script: UI Lua API import (WAR 1.4.8)2026-10-16T19:49:15Z<p>UI Lua API import (WAR 1.4.8)</p>
<p><b>New page</b></p><div>{{LuaApi|group=Appearance}}<br />
Shows the player character with the appearance that a marketing reward item in the inventory would give, without applying it.<br />
<br />
<pre><br />
SetPlayerVariation(slot)<br />
</pre><br />
<br />
== Arguments ==<br />
;slot : <code>number</code> – Inventory slot of the item, as used to index <code>DataUtils.GetItems()</code>. The stock UI passes <code>Cursor.Data.SourceSlot</code> for an item picked up from the inventory.<br />
<br />
== Returns ==<br />
Nothing.<br />
<br />
== Details ==<br />
* Nothing happens unless the slot holds an item whose type is <code>GameData.ItemTypes.MARKETING</code>.<br />
* The item carries an appearance slot number and a variation value. The client writes that value into the player's appearance data for that slot (only for slot numbers below 15) and updates the character's look.<br />
* This is a local preview only. Nothing is sent to the server. Use [[API:ApplyPlayerVariation|ApplyPlayerVariation]] to apply the item, or [[API:RevertPlayerVariation|RevertPlayerVariation]] to undo the preview.<br />
* The client remembers the slot and its previous value for [[API:RevertPlayerVariation|RevertPlayerVariation]]. Only one previous value is kept, so a second call replaces it.<br />
* The function returns nothing if there is no player.<br />
<br />
== Errors ==<br />
None besides the generic ''Invalid Parameters'' message when the argument is not a number.<br />
<br />
== Example ==<br />
From <code>ea_characterwindow/source/characterwindow.lua</code>, when a marketing item is dropped on the character window:<br />
<pre><br />
local itemData = DataUtils.GetItems()[Cursor.Data.SourceSlot]<br />
if( Cursor.Data.Source == Cursor.SOURCE_INVENTORY and itemData.type == GameData.ItemTypes.MARKETING) then<br />
local slot = Cursor.Data.SourceSlot<br />
CharacterWindow.marketItemData = itemData<br />
CharacterWindow.marketItemDataSlot = slot<br />
-- ...<br />
SetPlayerVariation(slot)<br />
</pre><br />
<br />
== See also ==<br />
* [[API:RevertPlayerVariation|RevertPlayerVariation]]<br />
* [[API:ApplyPlayerVariation|ApplyPlayerVariation]]<br />
* [[API:GetPlayerVariation|GetPlayerVariation]]</div>Maintenance script