WoW:API GetUnitSpeed: Difference between revisions

Latest revision as of 04:46, 15 August 2023

Reference e
AddOns WoW API Widget API XML UI Event API WoW Lua Macro API CVars Battle.net HOWTOs Snippets UI tech Categories

Returns a value representing the moving speed of a unit.

value = GetUnitSpeed("unit")

unit: String - The unitId for which the speed information is returned. This has not been tested with all units but does work for "Player" units.

Player unit moving at 100% -- value = 7
Player unit moving at 175% -- value = 12.25
Player unit moving at 200% -- value = 14

7 * 1.75 = 12.25 so apparently 7 = 100%

For example, the following will put the speed in % into the variable s.

s = string.format("%d", (GetUnitSpeed("Player") / 7) * 100);

@@ Line 1: / Line 1: @@
-This is a work in progress...
+{{wowapi}} __NOTOC__
+Added with WoW 3.0 {{wotlk-inline}}
-When the unit is not moving this returns 0<BR/>
+==Usage==
-When the unit is on a moving object such as a boat that's moving this returns 0<BR/>
+Returns a value representing the moving speed of a unit.
-When the unit is running at 100% (running on foot with no speed increase enhancements) this returns 7<BR/>
-When the unit is running at 175% (Death Knight home city) this returns 12.25<BR/>
-When the unit is running at 200% (Epic Mount) this returns 14
-* 1.75 = 12.25 so apparently 7 = 100%, for example:
+ value = GetUnitSpeed("[[UnitId|unit]]")
+== Parameters ==
+=== Arguments ===
+:;unit : String - The [[unitId]] for which the speed information is returned. This has not been tested with all units but does work for "Player" units.
+=== Returns ===
+:;value : Number - value of the unit speed
+==== Examples ====
+Player unit moving at 100% -- value = 7<BR/>
+Player unit moving at 175% -- value = 12.25<BR/>
+Player unit moving at 200% -- value = 14<BR/>
+== Misc. Calculations ==
+* 1.75 = 12.25 so apparently 7 = 100%
+For example, the following will put the speed in % into the variable s.
   s = string.format("%d", (GetUnitSpeed("Player") / 7) * 100);
-will put the speed in % into the variable s.