Finding Entities (AMX Mod X) - Revision history

Edon1337 at 21:35, 27 February 2017

2017-02-27T21:35:39Z

Pizzahut: /* Looping */ missing a closing paranthesis

2015-02-16T22:10:08Z

‎Looping: missing a closing paranthesis

VEN: /* find_ent_by_owner */

2006-01-26T13:51:46Z

‎find_ent_by_owner

CyberMind: fixed list, broke up paragraphs

2006-01-21T04:37:31Z

fixed list, broke up paragraphs

Hawk552: /* find_ent_by_model */ -- fixed slight typo

2006-01-21T01:04:33Z

‎find_ent_by_model: -- fixed slight typo

Hawk552: Fixed category

2006-01-21T01:02:13Z

Fixed category

Hawk552 at 01:01, 21 January 2006

2006-01-21T01:01:52Z

Hawk552 at 01:01, 21 January 2006

2006-01-21T01:01:39Z

Hawk552 at 00:57, 21 January 2006

2006-01-21T00:57:47Z

New page

==Introduction==
It is sometimes necessary to find an entity in the world for some reason. For example, you may need to find a button in the world, and then remove it (this example will be covered later). This article will explain how to do so.

==Functions==
There are a number of functions built into AMX Mod X / AMXX Modules that allow you to find entities. For a complete list, please consult this page: http://www.amxmodx.org/funcwiki.php?search=find_ent&go=search

(As of last edit, these are the functions included):
find_ent_by_class
find_ent_by_model
find_ent_by_owner
find_ent_by_target
find_ent_by_tname
find_ent_in_sphere
find_sphere_class

==find_ent_by_class==
<Function is included in Engine>

This function allows you to find an entity based on it's classname. All entities have classnames. For example, a player's classname is "player", while a button is either "func_button" or "func_rot_button".

To find an entity using this, one would simply use the following:
<pawn>
find_ent_by_class(-1,"classname_to_find");
</pawn>

==find_ent_by_model==
<Function is included in Engine>
This function can be used to find an entity based on its model. Some entities do not have models, meaning they cannot be found using this method. Also, it is, most of the time, better to use another type of ent finding, as this can be highly inaccurate and be broken by something as simple as a model changing plugin. This function also takes into account the class name, and is generally used more for isolating a certain model from a set of classnames (ex you have 3 grenades, with different models, and want to find 1 of them)

To find an entity using this, one would use the following:
<pawn>
find_ent_by_model(ent,"classname_to_find","model_to_find")
</pawn>

==find_ent_by_owner==
<Function is included in Engine>
<This section cannot be verified. If anyone knows it is true, please remove this tag.>
This function can be used to find an entity based on an owner. For example, if there is a player in the world, and you want to find if he has thrown a grenade out, you would use this and check for entities that's owner is the player. This function also checks for classname, unless directed not to.

To find an entity using this, one would use the following:
<pawn>
find_ent_by_owner(-1,"classname_to_find",owner_id,0);
</pawn>

Notice the last parameter. This is a mode to find in. To see a full list, consult this page:
http://www.amxmodx.org/funcwiki.php?go=func&id=345

==find_ent_by_target==
<Function is included in Engine>
This function allows one to find an entity based on its target. This function also checks for classname.

To find an entity using this, one would use the following:
<pawn>
find_ent_by_target(-1,"classname_to_find");
</pawn>

==find_ent_by_tname==
<Function is included in Engine>
This essentially functions the same as find_ent_by_target.

==find_ent_in_sphere==
<Function is included in Engine>
This function can be used to find an entity within a certain distance of another entity. This can be quite handy to, for example, see if a player is around another player, and then deal damage or slap that player. This is effectively a shortcut to using find_ent_by_class and get_distance(_f) together.

To find an entity using this, one would use the following:
<pawn>
find_ent_in_sphere(-1,location_of_ent_vector,radius_float);
</pawn>

==find_sphere_class==
This function is probably the most complex of all the find_ent functions. This allows you to find an entity inside a certain radius of another entity, with a certian classname. This is effectively a shortcut to using find_ent_by_class & get_distance & entity_get_string(ent,EV_SZ_classname... or find_ent_in_sphere & entity_get_string(ent,EV_SZ_classname...

To find an entity using this, one would use the following:
<pawn>
new entlist[513];
find_sphere_class(0,"classname_to_find",radius_float,entlist,512,origin_vector);
</pawn>

Also, note that origin_vector and the first parameter (_aroundent) should not both be specified. If _aroundent is specified as 0, origin_vector is used. If origin_vector is not specified, or is 0, then _aroundent is used.

==Looping==
If, for example, one wants to loop one of these, it is quite simple to do so.

Example:
<pawn>
while((ent = find_ent_by_class(ent,"classname_to_find") != 0)
{
// do whatever
}
</pawn>

This will find every entity with classname "classname_to_find" and then execute the "// do whatever" code every time it finds one.

==Wrap Up==
For complete usage, please consult the Engine Module page at:
http://www.amxmodx.org/funcwiki.php?go=module&id=3

← Older revision		Revision as of 01:02, 21 January 2006
Line 96:		Line 96:
	http://www.amxmodx.org/funcwiki.php?go=module&id=3		http://www.amxmodx.org/funcwiki.php?go=module&id=3

−	[[Category: Scripting_(AMX_Mod_X)}}	+	[[Category: Scripting_(AMX_Mod_X)]]

← Older revision		Revision as of 01:01, 21 January 2006
Line 96:		Line 96:
	http://www.amxmodx.org/funcwiki.php?go=module&id=3		http://www.amxmodx.org/funcwiki.php?go=module&id=3

−	[[Category : Scripting_(AMX_Mod_X)}}	+	[[Category: Scripting_(AMX_Mod_X)}}

← Older revision		Revision as of 01:01, 21 January 2006
Line 95:		Line 95:
	For complete usage, please consult the Engine Module page at:		For complete usage, please consult the Engine Module page at:
	http://www.amxmodx.org/funcwiki.php?go=module&id=3		http://www.amxmodx.org/funcwiki.php?go=module&id=3
		+
		+	[[Category : Scripting_(AMX_Mod_X)}}

@@ Line 23: / Line 23: @@
 find_ent_by_class(-1,"classname_to_find");
 </pawn>
 ==find_ent_by_model==

@@ Line 88: / Line 88: @@
 Example:
 <pawn>
-while((ent = find_ent_by_class(ent,"classname_to_find") != 0)
+while((ent = find_ent_by_class(ent,"classname_to_find")) != 0)
+{
 	// do whatever

@@ Line 37: / Line 37: @@
 <Function is included in Engine>
-<This section cannot be verified. If anyone knows it is true, please remove this tag.>
+This function can be used to find an entity based on an owner. For example, if there is a player in the world, and you want to find if he has thrown a grenade out, you would use this and check for "grenade" entities that's owner is the player.
+Note: planted C4 (in CS) also have "grenade" classname.
 To find an entity using this, one would use the following:

@@ Line 6: / Line 6: @@
 (As of last edit, these are the functions included):
-find_ent_by_class
+*find_ent_by_class
-find_ent_by_model
+*find_ent_by_model
-find_ent_by_owner
+*find_ent_by_owner
-find_ent_by_target
+*find_ent_by_target
-find_ent_by_tname
+*find_ent_by_tname
-find_ent_in_sphere
+*find_ent_in_sphere
-find_sphere_class
+*find_sphere_class
 ==find_ent_by_class==
@@ Line 26: / Line 26: @@
 ==find_ent_by_model==
 <Function is included in Engine>
 This function can be used to find an entity based on its model. Some entities do not have models, meaning they cannot be found using this method. Also, it is, most of the time, better to use another type of ent finding, as this can be highly inaccurate and be broken by something as simple as a model changing plugin. This function also takes into account the class name, and is generally used more for isolating a certain model from a set of classnames (ex you have 3 grenades, with different models, and want to find 1 of them)
@@ Line 35: / Line 36: @@
 ==find_ent_by_owner==
 <Function is included in Engine>
 <This section cannot be verified. If anyone knows it is true, please remove this tag.>
 This function can be used to find an entity based on an owner. For example, if there is a player in the world, and you want to find if he has thrown a grenade out, you would use this and check for entities that's owner is the player. This function also checks for classname, unless directed not to.
@@ Line 48: / Line 51: @@
 ==find_ent_by_target==
 <Function is included in Engine>
 This function allows one to find an entity based on its target. This function also checks for classname.
@@ Line 61: / Line 65: @@
 ==find_ent_in_sphere==
 <Function is included in Engine>
 This function can be used to find an entity within a certain distance of another entity. This can be quite handy to, for example, see if a player is around another player, and then deal damage or slap that player. This is effectively a shortcut to using find_ent_by_class and get_distance(_f) together.

@@ Line 30: / Line 30: @@
 To find an entity using this, one would use the following:
 <pawn>
-find_ent_by_model(ent,"classname_to_find","model_to_find")
+find_ent_by_model(-1,"classname_to_find","model_to_find")
 </pawn>