| description |
|---|
Functions for getting and setting entities and entity data. |
entity.get_all([classname: string]): table (entindex)
| Argument | Type | Description |
|---|---|---|
| classname | string (entity classname) | String that specifies the class name of entities that will be added to the list, for example "CCSPlayer". |
Returns an array of entity indices. Pass no arguments for all entities.
entity.get_bounding_box(player: number): number, number, number, number, number
| Argument | Type | Description |
|---|---|---|
| player | number (entindex) | Entity index of the player. |
Returns x1, y1, x2, y2, alpha_multiplier. The contents of x1, y1, x2, y2 must be ignored when alpha_multiplier is zero, which indicates that the bounding box is invalid and should not be drawn.
entity.get_classname(ent: number): string
| Argument | Type | Description |
|---|---|---|
| ent | number (entindex) | Entity index. |
Returns the name of the entity's class, or nil on failure.
entity.get_esp_data(player: number): table
| Argument | Type | Description |
|---|---|---|
| player | number (entindex) | Entity index |
Returns a table containing alpha, health, and weapon_id, or nil on failure.
entity.get_game_rules(): number (entindex)
Returns entity index of CCSGameRulesProxy instance, or nil if none exists.
entity.get_local_player(): number (entindex)
Returns the entity index for the local player, or nil on failure.
entity.get_origin(ent: number): number, number, number
| Argument | Type | Description |
|---|---|---|
| ent | number (entindex) | Entity index |
Returns the x, y, z coordinates of the entity. Only works for non-dormant entities, except for players, where it will return the dormant esp origin
entity.get_player_name(ent: number): string
| Argument | Type | Description |
|---|---|---|
| ent | number (entindex) | Player entity index. |
Returns the player's name, or the string "unknown" on failure.
entity.get_player_resource(): number (entindex)
Returns entity index of CCSPlayerResource instance, or nil if none exists.
entity.get_player_weapon(ent: number): number (entindex)
| Argument | Type | Description |
|---|---|---|
| ent | number (entindex) | Player entity index. |
Returns the entity index of the player's active weapon, or nil if the player is not alive, dormant, etc.
entity.get_players([enemies_only: boolean]): table (entindex)
| Argument | Type | Description |
|---|---|---|
| enemies_only | boolean | If true then you and the players on your team will not be added to the list. |
Returns an array of player entity indices. Dormant and dead players will not be added to the list.
entity.get_prop(ent: number, propname: string[, array_index: number]): any
| Argument | Type | Description |
|---|---|---|
| ent | number (entindex) | Entity index. |
| propname | string (netprop) | Name of the networked property. |
| array_index | number | If propname is an array, the value at this array index will be returned. |
Returns the value of the property, or nil on failure. For vectors or angles, this returns three values.
entity.get_steam64(player: number): string
| Argument | Type | Description |
|---|---|---|
| player | number (entindex) | Entity index of the player. |
Returns steamID3, or nil on failure.
entity.hitbox_position(player: number, hitbox: number): number, number, number
| Argument | Type | Description |
|---|---|---|
| player | number (entindex) | Entity index of the player. |
| hitbox | number (hitbox id) | Either a string of the hitbox name, or an integer index of the hitbox. |
Returns world coordinates x, y, z, or nil on failure.
entity.is_alive(ent: number): boolean
| Argument | Type | Description |
|---|---|---|
| ent | number (entindex) | Entity index. |
Returns true if the player is not dead.
entity.is_dormant(ent: number): boolean
| Argument | Type | Description |
|---|---|---|
| ent | number (entindex) | Entity index. |
Returns true if the entity is dormant.
entity.is_enemy(ent: number): boolean
| Argument | Type | Description |
|---|---|---|
| ent | number (entindex) | Entity index. |
Returns true if the entity is on the other team.
entity.set_prop(ent: number, propname: string, value: any[, array_index: number])
| Argument | Type | Description |
|---|---|---|
| ent | number (entindex) | Entity index. |
| propname | string (netprop) | Name of the networked property. |
| value | any | The property will be set to this value. For vectors or angles, separate the components by commas. |
| array_index | number | If propname is an array, the value at this array index will be set. |
Sets the value of the property. For vectors or angles, pass three values.