WoW:API UnitGUID - Revision history

Move page script: Move page script moved page API UnitGUID to WoW:API UnitGUID without leaving a redirect

2023-08-15T04:47:44Z

Move page script moved page API UnitGUID to API UnitGUID without leaving a redirect

← Older revision	Revision as of 04:47, 15 August 2023
(No difference)

71.200.93.197: /* Notes */

2013-10-17T22:04:32Z

Notes

← Older revision		Revision as of 22:04, 17 October 2013
Line 29:		Line 29:

	A GUID can be thought of as being composed of multiple pieces of data. Consider "'''0xAABCCCDDDDEEEEEE'''", where:		A GUID can be thought of as being composed of multiple pieces of data. Consider "'''0xAABCCCDDDDEEEEEE'''", where:
	:; AA : unknown; Possible battlegroup identifier when used for players.		:; AA
	:; B : unit type, mask with 0x7 to get: 0 for players, 1 for world objects, 3 for NPCs, 4 for permanent pets, 5 for vehicles. Temporary pets (Treants, Spirit Wolves~~, Water Elemental~~, Mirror Images, and Ghouls) are considered NPCs (3), even if talents or glyphs prevent them from expiring.		:: unknown; Possible battlegroup identifier when used for players.
			:; B
			:: unit type, mask with 0x7 to get: 0 for players, 1 for world objects, 3 for NPCs, 4 for permanent pets (including Water Elemental), 5 for vehicles. Temporary pets (Treants, Spirit Wolves, Mirror Images, and Ghouls) are considered NPCs (3), even if talents or glyphs prevent them from expiring.
	:NOTE: According to my personal analysis, I found that the number stands for players should be 8 instead of 0. I don't know if this is a newly update.		:NOTE: According to my personal analysis, I found that the number stands for players should be 8 instead of 0. I don't know if this is a newly update.
	:NOTE: On the server Alexstraza I have seen the 1st 3 numbers be 040, meaning you must mask with 0x7 and 0=player, not 8.		:NOTE: On the server Alexstraza I have seen the 1st 3 numbers be 040, meaning you must mask with 0x7 and 0=player, not 8.
	:CORRECTION: If you have masked with 0x7 then the result CANNOT be 8. Masking 8 with 0x7 gives 0. It seems reasonable to conclude that the original poster is correct.		:CORRECTION: If you have masked with 0x7 then the result CANNOT be 8. Masking 8 with 0x7 gives 0. It seems reasonable to conclude that the original poster is correct.
	:; CCC : If the unit is a pet, CCCDDDD forms a unique ID for the pet based on creation order; if a world object, CCCDDDD is the object ID; otherwise unknown.		:; CCC
	:; DDDD : If the unit is an NPC, this is the hexadecimal representation of the NPC id.		:: If the unit is a pet, CCCDDDD forms a unique ID for the pet based on creation order; if a world object, CCCDDDD is the object ID; otherwise unknown.
	:; EEEEEE : If the unit is a player, this is a unique identifier based on creation order. Otherwise, this is a spawn counter based on spawn order.<br>(For players it can be 7 digits long, so that its DEEEEEE)		:; DDDD
			:: If the unit is an NPC, this is the hexadecimal representation of the NPC id.
			:; EEEEEE
			:: If the unit is a player, this is a unique identifier based on creation order. Otherwise, this is a spawn counter based on spawn order.<br />(For players it can be 7 digits long, so that its DEEEEEE)

WoWWiki>Msaint: Previous note incorrect.

2011-05-25T20:39:51Z

Previous note incorrect.

← Older revision		Revision as of 20:39, 25 May 2011
Line 31:		Line 31:
	:; AA : unknown; Possible battlegroup identifier when used for players.		:; AA : unknown; Possible battlegroup identifier when used for players.
	:; B : unit type, mask with 0x7 to get: 0 for players, 1 for world objects, 3 for NPCs, 4 for permanent pets, 5 for vehicles. Temporary pets (Treants, Spirit Wolves, Water Elemental, Mirror Images, and Ghouls) are considered NPCs (3), even if talents or glyphs prevent them from expiring.		:; B : unit type, mask with 0x7 to get: 0 for players, 1 for world objects, 3 for NPCs, 4 for permanent pets, 5 for vehicles. Temporary pets (Treants, Spirit Wolves, Water Elemental, Mirror Images, and Ghouls) are considered NPCs (3), even if talents or glyphs prevent them from expiring.
	NOTE: According to my personal analysis, I found that the number stands for players should be 8 instead of 0. I don't know if this is a newly update.		:NOTE: According to my personal analysis, I found that the number stands for players should be 8 instead of 0. I don't know if this is a newly update.
	NOTE: On the server Alexstraza I have seen the 1st 3 numbers be 040, meaning you must mask with 0x7 and 0=player, not 8.		:NOTE: On the server Alexstraza I have seen the 1st 3 numbers be 040, meaning you must mask with 0x7 and 0=player, not 8.
			:CORRECTION: If you have masked with 0x7 then the result CANNOT be 8. Masking 8 with 0x7 gives 0. It seems reasonable to conclude that the original poster is correct.
	:; CCC : If the unit is a pet, CCCDDDD forms a unique ID for the pet based on creation order; if a world object, CCCDDDD is the object ID; otherwise unknown.		:; CCC : If the unit is a pet, CCCDDDD forms a unique ID for the pet based on creation order; if a world object, CCCDDDD is the object ID; otherwise unknown.
	:; DDDD : If the unit is an NPC, this is the hexadecimal representation of the NPC id.		:; DDDD : If the unit is an NPC, this is the hexadecimal representation of the NPC id.

WoWWiki>Shimpossible: /* {{C-inline}} 4.0 changes to NPC ID */

2010-12-18T14:46:40Z

{{C-inline}} 4.0 changes to NPC ID

← Older revision		Revision as of 14:46, 18 December 2010
Line 32:		Line 32:
	:; B : unit type, mask with 0x7 to get: 0 for players, 1 for world objects, 3 for NPCs, 4 for permanent pets, 5 for vehicles. Temporary pets (Treants, Spirit Wolves, Water Elemental, Mirror Images, and Ghouls) are considered NPCs (3), even if talents or glyphs prevent them from expiring.		:; B : unit type, mask with 0x7 to get: 0 for players, 1 for world objects, 3 for NPCs, 4 for permanent pets, 5 for vehicles. Temporary pets (Treants, Spirit Wolves, Water Elemental, Mirror Images, and Ghouls) are considered NPCs (3), even if talents or glyphs prevent them from expiring.
	NOTE: According to my personal analysis, I found that the number stands for players should be 8 instead of 0. I don't know if this is a newly update.		NOTE: According to my personal analysis, I found that the number stands for players should be 8 instead of 0. I don't know if this is a newly update.
			NOTE: On the server Alexstraza I have seen the 1st 3 numbers be 040, meaning you must mask with 0x7 and 0=player, not 8.
	:; CCC : If the unit is a pet, CCCDDDD forms a unique ID for the pet based on creation order; if a world object, CCCDDDD is the object ID; otherwise unknown.		:; CCC : If the unit is a pet, CCCDDDD forms a unique ID for the pet based on creation order; if a world object, CCCDDDD is the object ID; otherwise unknown.
	:; DDDD : If the unit is an NPC, this is the hexadecimal representation of the NPC id.		:; DDDD : If the unit is an NPC, this is the hexadecimal representation of the NPC id.
Line 73:		Line 74:

	The NPC portion of this is 0x73AB in hex, and a NPC ID of 29611 in decimal.		The NPC portion of this is 0x73AB in hex, and a NPC ID of 29611 in decimal.

			Water Elemental is now a permanent pet and as such has an id of 4 instead of 3.

WoWWiki>Xionglingfeng: Changed the number which stands for players to 8 instead of 0.

2010-10-17T09:15:02Z

Changed the number which stands for players to 8 instead of 0.

← Older revision		Revision as of 09:15, 17 October 2010
Line 31:		Line 31:
	:; AA : unknown; Possible battlegroup identifier when used for players.		:; AA : unknown; Possible battlegroup identifier when used for players.
	:; B : unit type, mask with 0x7 to get: 0 for players, 1 for world objects, 3 for NPCs, 4 for permanent pets, 5 for vehicles. Temporary pets (Treants, Spirit Wolves, Water Elemental, Mirror Images, and Ghouls) are considered NPCs (3), even if talents or glyphs prevent them from expiring.		:; B : unit type, mask with 0x7 to get: 0 for players, 1 for world objects, 3 for NPCs, 4 for permanent pets, 5 for vehicles. Temporary pets (Treants, Spirit Wolves, Water Elemental, Mirror Images, and Ghouls) are considered NPCs (3), even if talents or glyphs prevent them from expiring.
			NOTE: According to my personal analysis, I found that the number stands for players should be 8 instead of 0. I don't know if this is a newly update.
	:; CCC : If the unit is a pet, CCCDDDD forms a unique ID for the pet based on creation order; if a world object, CCCDDDD is the object ID; otherwise unknown.		:; CCC : If the unit is a pet, CCCDDDD forms a unique ID for the pet based on creation order; if a world object, CCCDDDD is the object ID; otherwise unknown.
	:; DDDD : If the unit is an NPC, this is the hexadecimal representation of the NPC id.		:; DDDD : If the unit is an NPC, this is the hexadecimal representation of the NPC id.

WoWWiki>Ketho: /* Example: Decomposing a GUID */ Change to 4.0 NPC ID in scripts

2010-10-15T02:23:09Z

Example: Decomposing a GUID: Change to 4.0 NPC ID in scripts

← Older revision		Revision as of 02:23, 15 October 2010
Line 29:		Line 29:

	A GUID can be thought of as being composed of multiple pieces of data. Consider "'''0xAABCCCDDDDEEEEEE'''", where:		A GUID can be thought of as being composed of multiple pieces of data. Consider "'''0xAABCCCDDDDEEEEEE'''", where:
	:; AA : unknown.		:; AA : unknown; Possible battlegroup identifier when used for players.
	:; B : unit type, mask with 0x7 to get: 0 for players, 1 for world objects, 3 for NPCs, 4 for permanent pets, 5 for vehicles. Temporary pets (Treants, Spirit Wolves, Water Elemental, Mirror Images, and Ghouls) are considered NPCs (3), even if talents or glyphs prevent them from expiring.		:; B : unit type, mask with 0x7 to get: 0 for players, 1 for world objects, 3 for NPCs, 4 for permanent pets, 5 for vehicles. Temporary pets (Treants, Spirit Wolves, Water Elemental, Mirror Images, and Ghouls) are considered NPCs (3), even if talents or glyphs prevent them from expiring.
	:; CCC : If the unit is a pet, CCCDDDD forms a unique ID for the pet based on creation order; if a world object, CCCDDDD is the object ID; otherwise unknown.		:; CCC : If the unit is a pet, CCCDDDD forms a unique ID for the pet based on creation order; if a world object, CCCDDDD is the object ID; otherwise unknown.
	:; DDDD : If the unit is an NPC, this is the hexadecimal representation of the NPC id.		:; DDDD : If the unit is an NPC, this is the hexadecimal representation of the NPC id.
	:; EEEEEE : If the unit is a player, this is a unique identifier based on creation order. Otherwise, this is a spawn counter based on spawn order.		:; EEEEEE : If the unit is a player, this is a unique identifier based on creation order. Otherwise, this is a spawn counter based on spawn order.<br>(For players it can be 7 digits long, so that its DEEEEEE)


Line 52:		Line 52:
	The last six digits, "008852" is the spawn counter. There will never be two "Mo'arg Weaponsmith", possible even never two mobs in the outside world, with the same spawn number. This spawn counter, combined with the rest makes it possible to always refer to exactly this "Mo'arg Weaponsmith", and not the one next to it.		The last six digits, "008852" is the spawn counter. There will never be two "Mo'arg Weaponsmith", possible even never two mobs in the outside world, with the same spawn number. This spawn counter, combined with the rest makes it possible to always refer to exactly this "Mo'arg Weaponsmith", and not the one next to it.

	A simple in game script command can be used to get the NPC ID from your target		A simple in game script command can be used to get the NPC ID from your target: ''Target NPC ID: 19755''
	/run print("Target NPC ID:", tonumber((UnitGUID("target")):sub(-12, -7), 16) )		/run print("Target NPC ID:", tonumber((UnitGUID("target")):sub(-12, -9), 16))
			More informative script: ''NPC ID("Mo'arg Weaponsmith") = 0x4D2B = 19755''
			/run local a=strsub(UnitGUID("target"),7,10); print("NPC ID(\""..UnitName("target").."\") = 0x"..a.." = "..tonumber(a,16))

	=== Cross-server and GUID "uniqueness" ===		=== Cross-server and GUID "uniqueness" ===
Line 62:		Line 64:
	NPC GUID collisions have also been observed. It is unknown why or when in specific they occur, but differing mob types have had a NPC ID number which corresponded to an entirely different NPC. This is considered a very rare phenomenon.		NPC GUID collisions have also been observed. It is unknown why or when in specific they occur, but differing mob types have had a NPC ID number which corresponded to an entirely different NPC. This is considered a very rare phenomenon.

	== 3.~~3 PTR~~ changes to NPC ID portion ==		== {{C-inline}} 4.0 changes to NPC ID ==
			Along with the Live [http://www.wowwiki.com/Patch_4.0.1 4.0.1 patch (build 13164)], the NPC portion has moved 2 digits to the left, to <font color="#F6ADC6">CC</font><font color="#ADFF2F">DD</font> instead of <font color="#ADFF2F">DDDD</font>.
			*Before: (9th to 12th digit)
			0xF13000<font color="#ADFF2F">73AB</font>06AE87,"King Varian Wrynn"
			*After: (7th to 10th digit)
			0xF130<font color="#ADFF2F">73AB</font>00001BB4,"King Varian Wrynn"

	~~As of 3.3 PTR build 10522, the NPC ID has moved to CCCD instead of DDDD. For example:~~		The NPC portion of this is 0x73AB in hex, and a NPC ID of 29611 in decimal.

	~~SPELL_CAST_START,0xF1308F32001790BE,"Geißelfürst Tyrannus"~~

	The NPC portion of this is ~~0x8F32~~, ~~which is~~ NPC ~~id 36658~~.

WoWWiki>Orionshock: /* Example: Decomposing a GUID */ add simple run command to section for getting the NCP ID in game

2010-08-27T21:54:23Z

Example: Decomposing a GUID: add simple run command to section for getting the NCP ID in game

← Older revision		Revision as of 21:54, 27 August 2010
Line 51:		Line 51:

	The last six digits, "008852" is the spawn counter. There will never be two "Mo'arg Weaponsmith", possible even never two mobs in the outside world, with the same spawn number. This spawn counter, combined with the rest makes it possible to always refer to exactly this "Mo'arg Weaponsmith", and not the one next to it.		The last six digits, "008852" is the spawn counter. There will never be two "Mo'arg Weaponsmith", possible even never two mobs in the outside world, with the same spawn number. This spawn counter, combined with the rest makes it possible to always refer to exactly this "Mo'arg Weaponsmith", and not the one next to it.

			A simple in game script command can be used to get the NPC ID from your target
			/run print("Target NPC ID:", tonumber((UnitGUID("target")):sub(-12, -7), 16) )

	=== Cross-server and GUID "uniqueness" ===		=== Cross-server and GUID "uniqueness" ===

WoWWiki>Toddimer: /* Notes */ - added information for temporary pets

2010-05-31T02:27:27Z

Notes: - added information for temporary pets

← Older revision		Revision as of 02:27, 31 May 2010
Line 30:		Line 30:
	A GUID can be thought of as being composed of multiple pieces of data. Consider "'''0xAABCCCDDDDEEEEEE'''", where:		A GUID can be thought of as being composed of multiple pieces of data. Consider "'''0xAABCCCDDDDEEEEEE'''", where:
	:; AA : unknown.		:; AA : unknown.
	:; B : unit type, mask with 0x7 to get: 0 for players, 1 for world objects, 3 for NPCs, 4 for pets, 5 for vehicles.		:; B : unit type, mask with 0x7 to get: 0 for players, 1 for world objects, 3 for NPCs, 4 for permanent pets, 5 for vehicles. Temporary pets (Treants, Spirit Wolves, Water Elemental, Mirror Images, and Ghouls) are considered NPCs (3), even if talents or glyphs prevent them from expiring.
	:; CCC : If the unit is a pet, CCCDDDD forms a unique ID for the pet based on creation order; if a world object, CCCDDDD is the object ID; otherwise unknown.		:; CCC : If the unit is a pet, CCCDDDD forms a unique ID for the pet based on creation order; if a world object, CCCDDDD is the object ID; otherwise unknown.
	:; DDDD : If the unit is an NPC, this is the hexadecimal representation of the NPC id.		:; DDDD : If the unit is an NPC, this is the hexadecimal representation of the NPC id.
	:; EEEEEE : If the unit is a player, this is a unique identifier based on creation order. Otherwise, this is a spawn counter based on spawn order.		:; EEEEEE : If the unit is a player, this is a unique identifier based on creation order. Otherwise, this is a spawn counter based on spawn order.


	=== Example: Determining unit type ===		=== Example: Determining unit type ===

WoWWiki>Recedeno: /* Notes */ fixed incorrect reference to "EEEEEE" instead of 7 E's

2009-12-30T01:35:48Z

Notes: fixed incorrect reference to "EEEEEE" instead of 7 E's

← Older revision		Revision as of 01:35, 30 December 2009
Line 33:		Line 33:
	:; CCC : If the unit is a pet, CCCDDDD forms a unique ID for the pet based on creation order; if a world object, CCCDDDD is the object ID; otherwise unknown.		:; CCC : If the unit is a pet, CCCDDDD forms a unique ID for the pet based on creation order; if a world object, CCCDDDD is the object ID; otherwise unknown.
	:; DDDD : If the unit is an NPC, this is the hexadecimal representation of the NPC id.		:; DDDD : If the unit is an NPC, this is the hexadecimal representation of the NPC id.
	:; ~~EEEEEEE~~ : If the unit is a player, this is a unique identifier based on creation order. Otherwise, this is a spawn counter based on spawn order.		:; EEEEEE : If the unit is a player, this is a unique identifier based on creation order. Otherwise, this is a spawn counter based on spawn order.

	=== Example: Determining unit type ===		=== Example: Determining unit type ===

WoWWiki>Blamdarot: "sixth" should be "seventh"

2009-11-03T02:53:18Z

"sixth" should be "seventh"

← Older revision		Revision as of 02:53, 3 November 2009
Line 47:		Line 47:
	First of all, let's find out what kind of unit it is. Take the first three digits in the GUID, ie "F53" (or 0xF53 to show it's an hex value) and apply an AND mask of 0x007 to get 0x003. This GUID is for a normal NPC, neither a pet nor a player.		First of all, let's find out what kind of unit it is. Take the first three digits in the GUID, ie "F53" (or 0xF53 to show it's an hex value) and apply an AND mask of 0x007 to get 0x003. This GUID is for a normal NPC, neither a pet nor a player.

	We can also extract the Unit ID by taking the ~~sixth~~ to tenth digit and converting it to decimal form: "4D2B", or converted to decimal form "19755". A quick visit to wowhead shows that the NPC with that id is "Mo'arg Weaponsmith", [http://www.wowhead.com/?npc=19755]. All "Mo'arg Weaponsmiths" will have that id to identify them.		We can also extract the Unit ID by taking the seventh to tenth digit and converting it to decimal form: "4D2B", or converted to decimal form "19755". A quick visit to wowhead shows that the NPC with that id is "Mo'arg Weaponsmith", [http://www.wowhead.com/?npc=19755]. All "Mo'arg Weaponsmiths" will have that id to identify them.

	The last six digits, "008852" is the spawn counter. There will never be two "Mo'arg Weaponsmith", possible even never two mobs in the outside world, with the same spawn number. This spawn counter, combined with the rest makes it possible to always refer to exactly this "Mo'arg Weaponsmith", and not the one next to it.		The last six digits, "008852" is the spawn counter. There will never be two "Mo'arg Weaponsmith", possible even never two mobs in the outside world, with the same spawn number. This spawn counter, combined with the rest makes it possible to always refer to exactly this "Mo'arg Weaponsmith", and not the one next to it.