WoW:API GetMoney: Difference between revisions

From AddOn Studio
Jump to navigation Jump to search
m (typo)
m (Move page script moved page API GetMoney to API GetMoney without leaving a redirect)
 
(4 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{wowapi}} __NOTOC__
{{wowapi}}
 
Returns an integer value of your held money.
Returns an integer value of your held money.
  money = GetMoney();
  money = GetMoney();


== Parameters ==
== Returns ==
 
;money : Number - The amount of money the player's character has, in copper.
<big>'''Arguments'''</big>
:None
 
 
<big>'''Returns'''</big>
 
:;money : Number - The amount of money in copper. This will need to be parsed to display gold, silver, copper seperately. Format could be expressed as ..ggggsscc
 


== Example ==
== Example ==
The following code prints the amount of gold, silver and copper the player's character currently has:
local copper = GetMoney()
print(("I have %dg %ds %dc"):format(copper / 100 / 100, (copper / 100) % 100, copper % 100));


/script DEFAULT_CHAT_FRAME:AddMessage(GetMoney(),1,1,1);
== Notes ==
 
* The player's wealth is not immediately available; wait until PLAYER_ENTERING_WORLD before calling GetMoney().
/script SendChatMessage("I have "..GetMoney().." copper.")
* As of patch 2.4.2 you can use the {{api|GetCoinText}}(copper) function to convert raw copper values to readable text.
 
<big>'''Result'''</big>
 
1112233
 
[Player] says: I have 1112233 copper.
 
Assuming the player has {{Cost|g=111|s=22|c=33}}.
 
== Example 2 ==
 
/script DEFAULT_CHAT_FRAME:AddMessage("[Money Pouch] contains "..(GetMoney()/10000).." gold.",1,1,1);
 
/script SendChatMessage("[Money Pouch] contains "..(GetMoney()/10000).." gold.");
 
<big>'''Result'''</big>
 
111.2233
 
[Player] says: [Money Pouch] contains 111.2233 gold.
 
Assuming the player has {{Cost|g=111|s=22|c=33}}.
 
By dividing with 10000 you get a result in gold. The decimals behind the dot are the silver and the copper.

Latest revision as of 04:46, 15 August 2023

WoW API < GetMoney

Returns an integer value of your held money.

money = GetMoney();

Returns[edit]

money
Number - The amount of money the player's character has, in copper.

Example[edit]

The following code prints the amount of gold, silver and copper the player's character currently has:

local copper = GetMoney()
print(("I have %dg %ds %dc"):format(copper / 100 / 100, (copper / 100) % 100, copper % 100));

Notes[edit]

  • The player's wealth is not immediately available; wait until PLAYER_ENTERING_WORLD before calling GetMoney().
  • As of patch 2.4.2 you can use the GetCoinText(copper) function to convert raw copper values to readable text.