> ## Documentation Index
> Fetch the complete documentation index at: https://cs-lua.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# players — CS-состояние

> Читает и меняет `CBasePlayer` игры

# CS-состояние

Читает и меняет `CBasePlayer` игры.

<h2 id="team">
  p:team
</h2>

Читает или меняет сторону игрока.

```lua theme={null}
p:team([team[, opts]])
```

### Аргументы

| # | имя    | тип           |                                          |
| - | ------ | ------------- | ---------------------------------------- |
| 1 | `team` | string \| nil | `CT`, `T`, `SPEC`; без него метод читает |
| 2 | `opts` | table \| nil  | см. [Опции](#team-опции)                 |

### Возвращает

| тип      |                              |
| -------- | ---------------------------- |
| `string` | `CT`, `T`, `SPEC` или `NONE` |

<h3 id="team-опции">
  Опции
</h3>

| поле    | тип     |                                                     |
| ------- | ------- | --------------------------------------------------- |
| `force` | boolean | игрок умирает и заходит заново, как это делает игра |

### Пример

```lua theme={null}
p:team("CT")                      -- сторона меняется, игрок остаётся жив
p:team("T", { force = true })     -- через смерть и повторный вход
```

Вход из спектатора всегда идёт как force: мягкий путь не умеет завести зрителя в идущий раунд.

<Warning>
  Требует ReGameDLL. На ванильном `mp.dll` метод бросает ошибку.
</Warning>

### Смотри также

* [p:spawn](cs-state.md#spawn)

<h2 id="spawn">
  p:spawn
</h2>

Респаун игрока без потери денег и счёта.

```lua theme={null}
p:spawn()
```

### Возвращает

Ничего.

Тот же `RoundRespawn`, что игра делает между раундами. Работает и на живом, и на мёртвом. У игрока в `SPEC` или `NONE` не делает ничего.

<Warning>
  Требует ReGameDLL. На ванильном `mp.dll` метод бросает ошибку.
</Warning>

<Note>
  `p:team(t, { force = true })` — не респаун: он убивает живого
  игрока, экран мигает, счёт сбрасывается.
</Note>

<h2 id="money">
  p:money
</h2>

Читает или задаёт деньги игрока.

```lua theme={null}
p:money([amount[, opts]])
```

### Аргументы

| # | имя      | тип           |                                   |
| - | -------- | ------------- | --------------------------------- |
| 1 | `amount` | number \| nil | новая сумма; без неё метод читает |
| 2 | `opts`   | table \| nil  | см. [Опции](#money-опции)         |

### Возвращает

| тип      |                          |
| -------- | ------------------------ |
| `number` | текущая сумма при чтении |

<h3 id="money-опции">
  Опции
</h3>

| поле  | тип     |                                                 |
| ----- | ------- | ----------------------------------------------- |
| `hud` | boolean | мигнуть цифрой на экране, как при подборе денег |

### Пример

```lua theme={null}
p:money(p:money() + 1000, { hud = true })
```

<Warning>
  Требует ReGameDLL. На ванильном `mp.dll` метод бросает ошибку.
</Warning>

<h2 id="deaths">
  p:deaths
</h2>

Счётчик смертей.

```lua theme={null}
p:deaths([value])
```

### Аргументы

| # | имя     | тип           |                                       |
| - | ------- | ------------- | ------------------------------------- |
| 1 | `value` | number \| nil | новое значение; без него метод читает |

### Возвращает

| тип      |                                                |
| -------- | ---------------------------------------------- |
| `number` | текущее значение при чтении; при записи ничего |

Запись обновляет строку в таблице счёта.

<Warning>
  Требует ReGameDLL. На ванильном `mp.dll` метод бросает ошибку.
</Warning>

<h2 id="defuser">
  p:defuser
</h2>

Есть ли у игрока дефузер.

```lua theme={null}
p:defuser([value])
```

### Аргументы

| # | имя     | тип            |                                       |
| - | ------- | -------------- | ------------------------------------- |
| 1 | `value` | boolean \| nil | новое значение; без него метод читает |

### Возвращает

| тип       |                                                |
| --------- | ---------------------------------------------- |
| `boolean` | текущее значение при чтении; при записи ничего |

### Пример

```lua theme={null}
p:defuser(true)     -- выдаёт дефузер бесплатно
```

<Warning>
  Требует ReGameDLL. На ванильном `mp.dll` метод бросает ошибку.
</Warning>

<h2 id="give">
  p:give
</h2>

Выдаёт игроку предмет по classname.

```lua theme={null}
p:give(classname)
```

### Аргументы

| # | имя         | тип    |                                                       |
| - | ----------- | ------ | ----------------------------------------------------- |
| 1 | `classname` | string | `weapon_ak47`, `item_assaultsuit`, `weapon_hegrenade` |

### Возвращает

Ничего.

### Пример

```lua theme={null}
p:give("weapon_ak47")
```

<Warning>
  Требует ReGameDLL. На ванильном `mp.dll` метод бросает ошибку.
</Warning>

<h2 id="strip">
  p:strip
</h2>

Забирает у игрока всё оружие.

```lua theme={null}
p:strip([suit])
```

### Аргументы

| # | имя    | тип            |                                |
| - | ------ | -------------- | ------------------------------ |
| 1 | `suit` | boolean \| nil | `true` — вместе с бронежилетом |

### Возвращает

Ничего.

<Warning>
  Требует ReGameDLL. На ванильном `mp.dll` метод бросает ошибку.
</Warning>

<h2 id="weapon">
  p:weapon
</h2>

Classname оружия в руках.

```lua theme={null}
p:weapon()
```

### Возвращает

| тип             |                          |
| --------------- | ------------------------ |
| `string \| nil` | classname оружия в руках |

<Warning>
  Требует ReGameDLL. На ванильном `mp.dll` метод бросает ошибку.
</Warning>

<h2 id="weapons">
  p:weapons
</h2>

Массив classname всего, что несёт игрок.

```lua theme={null}
p:weapons()
```

### Возвращает

| тип     |                                         |
| ------- | --------------------------------------- |
| `table` | массив classname всего, что несёт игрок |

<Warning>
  Требует ReGameDLL. На ванильном `mp.dll` метод бросает ошибку.
</Warning>

<h2 id="ammo">
  p:ammo
</h2>

Читает или задаёт патроны в запасе.

```lua theme={null}
p:ammo([weapon][, value])
```

### Аргументы

| # | имя      | тип           |                                      |
| - | -------- | ------------- | ------------------------------------ |
| 1 | `weapon` | string \| nil | classname; без него — оружие в руках |
| 2 | `value`  | number \| nil | новое количество                     |

### Возвращает

| тип      |                   |
| -------- | ----------------- |
| `number` | патронов в запасе |

### Пример

```lua theme={null}
p:ammo()                     -- запас для оружия в руках
p:ammo("weapon_ak47", 90)
```

Запас ключуется оружием, а не типом патрона: оружие одного калибра делит запас. Запись ограничена потолком игры.

<Warning>
  Требует ReGameDLL. На ванильном `mp.dll` метод бросает ошибку.
</Warning>

<h2 id="clip">
  p:clip
</h2>

Читает или задаёт патроны в магазине.

```lua theme={null}
p:clip([weapon][, value])
```

### Аргументы

| # | имя      | тип           |                                      |
| - | -------- | ------------- | ------------------------------------ |
| 1 | `weapon` | string \| nil | classname; без него — оружие в руках |
| 2 | `value`  | number \| nil | новое количество                     |

### Возвращает

| тип             |                                            |
| --------------- | ------------------------------------------ |
| `number \| nil` | `nil` у ножа и гранат — магазина у них нет |

Цифра доходит до HUD только для оружия в руках; при переключении она встаёт правильная.

<Warning>
  Требует ReGameDLL. На ванильном `mp.dll` метод бросает ошибку.
</Warning>

<h2 id="drop">
  p:drop
</h2>

Выбрасывает оружие на пол.

```lua theme={null}
p:drop([weapon])
```

### Аргументы

| # | имя      | тип           |                                       |
| - | -------- | ------------- | ------------------------------------- |
| 1 | `weapon` | string \| nil | classname; без него — то, что в руках |

### Возвращает

Ничего.

<Warning>
  Требует ReGameDLL. На ванильном `mp.dll` метод бросает ошибку.
</Warning>