> For the complete documentation index, see [llms.txt](https://golua.fatality.win/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://golua.fatality.win/documentation/datatypes/entity.md).

# entity

entity datatype

## Entity

### get\_index

```lua
local ent = entities.get_entity(1)
ent:get_index()
```

#### Returns:

| [Value](/documentation/datatypes/entity.md) | [Datatype](/documentation/datatypes/entity.md) |
| :-----------------------------------------: | :--------------------------------------------: |
|                 entity index                |                     number                     |

### is\_player

```lua
local ent = entities.get_entity(1)
ent:is_player()
```

#### Returns:

| [Value](/documentation/datatypes/entity.md) | [Datatype](/documentation/datatypes/entity.md) |
| :-----------------------------------------: | :--------------------------------------------: |
|    whether or not the entity is a player    |                     boolean                    |

### get\_class

```lua
ent:get_class() -- ex: CCSPlayer
```

#### Returns:

| [Value](/documentation/datatypes/entity.md) | [Datatype](/documentation/datatypes/entity.md) |
| :-----------------------------------------: | :--------------------------------------------: |
|             entity's class name             |                     string                     |

### get\_prop

```lua
ent:get_prop("m_hMyWeapons", 1)
```

<table data-header-hidden><thead><tr><th align="center"></th><th width="162" align="center"></th><th width="172" align="center"></th><th align="center"></th></tr></thead><tbody><tr><td align="center"><a href="/documentation/datatypes/entity.md">Parameter</a></td><td align="center"><a href="/documentation/datatypes/entity.md">Datatype</a></td><td align="center"><a href="/documentation/datatypes/entity.md">Description</a></td><td align="center"><a href="/documentation/datatypes/entity.md">Default value</a></td></tr><tr><td align="center">name</td><td align="center">string</td><td align="center">prop name</td><td align="center">❌</td></tr><tr><td align="center">table index</td><td align="center">number</td><td align="center">index of prop if it is an array</td><td align="center">0</td></tr></tbody></table>

#### Returns:

| [Value](/documentation/datatypes/entity.md) |             [Datatype](/documentation/datatypes/entity.md)             |
| :-----------------------------------------: | :--------------------------------------------------------------------: |
|                 prop's value                | number, string, boolean, [math.vec3](/documentation/datatypes/vec3.md) |

### set\_prop

```lua
ent:set_prop("m_bSpotted", 0, true)
```

<table data-header-hidden><thead><tr><th align="center"></th><th width="162" align="center"></th><th width="172" align="center"></th></tr></thead><tbody><tr><td align="center"><a href="/documentation/datatypes/entity.md">Parameter</a></td><td align="center"><a href="/documentation/datatypes/entity.md">Datatype</a></td><td align="center"><a href="/documentation/datatypes/entity.md">Description</a></td></tr><tr><td align="center">name</td><td align="center">string</td><td align="center">prop name</td></tr><tr><td align="center">table index</td><td align="center">number</td><td align="center">index of prop if it is an array</td></tr><tr><td align="center">value</td><td align="center">any</td><td align="center">value to set prop to</td></tr></tbody></table>

#### Usage:

Sets prop's value.

{% file src="/files/TvE7Rw1QIRErzBxN4wrh" %}

### is\_alive

```lua
ent:is_alive()
```

#### Returns:

| [Value](/documentation/datatypes/entity.md) | [Datatype](/documentation/datatypes/entity.md) |
| :-----------------------------------------: | :--------------------------------------------: |
|      whether or not the entity is alive     |                     boolean                    |

### get\_esp\_alpha

#### Returns:

| [Value](/documentation/datatypes/entity.md) | [Datatype](/documentation/datatypes/entity.md) |
| :-----------------------------------------: | :--------------------------------------------: |
|             esp alpha (0 - 255)             |                      float                     |

## Player

### is\_valid

```lua
local player = entities.get_entity(engine.get_local_player())
player:is_valid()
```

#### Returns:

| [Value](/documentation/datatypes/entity.md) | [Datatype](/documentation/datatypes/entity.md) |
| :-----------------------------------------: | :--------------------------------------------: |
| true if the player is alive and not dormant |                     boolean                    |

### is\_enemy

```lua
player:is_enemy()
```

#### Returns:

| [Value](/documentation/datatypes/entity.md) | [Datatype](/documentation/datatypes/entity.md) |
| :-----------------------------------------: | :--------------------------------------------: |
|        true if the player is an enemy       |                     boolean                    |

### get\_player\_info

```lua
player:get_player_info()
```

#### Returns:

| [Value](/documentation/datatypes/entity.md) |      [Datatype](/documentation/datatypes/entity.md)     |
| :-----------------------------------------: | :-----------------------------------------------------: |
|              the player's info              | [player\_info](/documentation/datatypes/player_info.md) |

### get\_bbox

```lua
local x1, y1, x2, y2 = player:get_bbox()
```

#### Returns:

| [Value](/documentation/datatypes/entity.md) | [Datatype](/documentation/datatypes/entity.md) |
| :-----------------------------------------: | :--------------------------------------------: |
|                      x1                     |                     number                     |
|                      y1                     |                     number                     |
|                      x2                     |                     number                     |
|                      y2                     |                     number                     |

{% hint style="warning" %}
Only works on enemy players!
{% endhint %}

### get\_weapon

```lua
player:get_weapon()
```

#### Returns:

| [Value](/documentation/datatypes/entity.md) | [Datatype](/documentation/datatypes/entity.md) |
| :-----------------------------------------: | :--------------------------------------------: |
|          the player's active weapon         |                [entity](#entity)               |

### get\_eye\_position

```lua
player:get_eye_position()
```

#### Returns:

| [Value](/documentation/datatypes/entity.md) | [Datatype](/documentation/datatypes/entity.md) |
| :-----------------------------------------: | :--------------------------------------------: |
|                      x                      |                     number                     |
|                      y                      |                     number                     |
|                      z                      |                     number                     |

### get\_hitbox\_position

```lua
player:get_hitbox_position(1)
```

<table data-header-hidden><thead><tr><th align="center"></th><th width="162" align="center"></th><th width="172" align="center"></th></tr></thead><tbody><tr><td align="center"><a href="/documentation/datatypes/entity.md">Parameter</a></td><td align="center"><a href="/documentation/datatypes/entity.md">Datatype</a></td><td align="center"><a href="/documentation/datatypes/entity.md">Description</a></td></tr><tr><td align="center">hitbox_index</td><td align="center">number</td><td align="center">the hitbox id</td></tr></tbody></table>

#### Returns:

| [Value](/documentation/datatypes/entity.md) | [Datatype](/documentation/datatypes/entity.md) |
| :-----------------------------------------: | :--------------------------------------------: |
|                      x                      |                     number                     |
|                      y                      |                     number                     |
|                      z                      |                     number                     |
