> ## 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 — Админские действия

> Поиск игроков, рассылка и объект игрока

# Админские действия

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

Отключает игрока от сервера.

```lua theme={null}
p:kick([reason])
```

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

| # | имя      | тип           |                                                 |
| - | -------- | ------------- | ----------------------------------------------- |
| 1 | `reason` | string \| nil | показывается игроку в консоли перед отключением |

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

Ничего.

Идёт через консольную команду движка и адресуется по userid: ник может содержать пробелы и кавычки.

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

Банит игрока.

```lua theme={null}
p:ban(minutes[, reason])
```

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

| # | имя       | тип           |                                |
| - | --------- | ------------- | ------------------------------ |
| 1 | `minutes` | number        | срок в минутах; `0` — навсегда |
| 2 | `reason`  | string \| nil | показывается игроку            |

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

Ничего.

Бан ложится в тот же список, которым управляет админ сервера, и сохраняется через `writeid`.

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

Убивает игрока.

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

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

Ничего.

Через `TakeDamage` от мира, поэтому отрабатывает всё как при обычной смерти: дроп оружия, сообщение, проверка конца раунда.

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

Наносит урон и толкает игрока в случайную сторону.

```lua theme={null}
p:slap([damage])
```

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

| # | имя      | тип           |                                       |
| - | -------- | ------------- | ------------------------------------- |
| 1 | `damage` | number \| nil | по умолчанию `1`; `0` — только толчок |

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

Ничего.

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

Выполняет консольную команду на машине игрока.

```lua theme={null}
p:exec(command)
```

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

| # | имя       | тип    |                 |
| - | --------- | ------ | --------------- |
| 1 | `command` | string | до 120 символов |

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

Ничего.
