https://wiki.returnofreckoning.com/index.php?action=history&feed=atom&title=API%3AInitiateTradeAPI:InitiateTrade - Revision history2026-10-17T07:42:49ZRevision history for this page on the wikiMediaWiki 1.43.11https://wiki.returnofreckoning.com/index.php?title=API:InitiateTrade&diff=30510&oldid=prevMaintenance script: UI Lua API import (WAR 1.4.8)2026-10-16T19:45:42Z<p>UI Lua API import (WAR 1.4.8)</p>
<p><b>New page</b></p><div>{{LuaApi|group=Trade}}<br />
Asks the server to open a trade with the current target or with a given player.<br />
<br />
<pre><br />
InitiateTrade(useCurrentTarget, targetId)<br />
</pre><br />
<br />
== Arguments ==<br />
;useCurrentTarget : <code>number</code> – <code>1</code> to trade with the player's current target. Any other value uses <code>targetId</code>.<br />
;targetId : <code>number</code> – Object ID of the player to trade with. Ignored when <code>useCurrentTarget</code> is <code>1</code>.<br />
<br />
== Returns ==<br />
Nothing.<br />
<br />
== Details ==<br />
* With <code>useCurrentTarget = 1</code>:<br />
** If there is no current target, nothing happens.<br />
** If the target's ID is not valid, nothing happens.<br />
** Otherwise the target's name is written to <code>GameData.Player.TradeTarget.Name</code> and the target's ID is used.<br />
* The chosen ID is stored as the current trade partner, and a "start trade" status is sent to the server. [[API:ChangeTrade|ChangeTrade]], [[API:AcceptTrade|AcceptTrade]] and [[API:CancelTrade|CancelTrade]] all use this stored partner.<br />
* With <code>useCurrentTarget</code> other than <code>1</code>, <code>targetId</code> is used as given (cut to a 16-bit value) and <code>GameData.Player.TradeTarget.Name</code> is not changed.<br />
* The client does not check what kind of object the target is. The server decides whether the trade can start.<br />
* Does nothing if the player object does not exist yet.<br />
* The function needs at least two arguments and only reads the last two.<br />
<br />
== Errors ==<br />
None besides the generic ''Invalid Parameters'' message when an argument is not a number.<br />
<br />
== Example ==<br />
From <code>default/ea_tradewindow/source/tradewindow.lua</code>:<br />
<pre><br />
if not EA_Window_Trade.TradeOpen() then<br />
InitiateTrade( 1, 0 )<br />
EA_Window_Trade.RefreshItemData (REFRESH_BOTH)<br />
EA_Window_Trade.Show()<br />
end<br />
</pre><br />
<br />
== See also ==<br />
* [[API:ChangeTrade|ChangeTrade]]<br />
* [[API:AcceptTrade|AcceptTrade]]<br />
* [[API:CancelTrade|CancelTrade]]</div>Maintenance script