> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wing.cat/llms.txt
> Use this file to discover all available pages before exploring further.

# Повороты

> Справочник по всем командам поворота в Vzmax: rotate-player, rotate-relative, rotate-pos, rotate-set, rotate-save, rotate-load и rotate.

<Note>
  **Что объединяет эти команды**

  Все команды из этой главы работают вокруг yaw/pitch и помогают либо быстро повернуть камеру, либо
  сохранить удобные углы и потом возвращаться к ним одной командой.
</Note>

## `.rotate-player <игрок>`

Поворачивает камеру на выбранного игрока. Цель берётся не просто по точному совпадению имени: клиент умеет
искать по scoreboard-имени, по обычному имени, по частичному совпадению, а также понимает ближайшую цель по
алиасам вроде `nearest` и `%nearest%`.

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

```text title="Примеры" theme={null}
.rotate-player Steve
.rotate-player nearest
```

## `.rotate-relative <+-yaw> <+-pitch>`

Делает относительный поворот от текущего угла, а не ставит абсолютное значение.

Если проще, команда отвечает на вопрос: "повернись ещё на столько-то градусов от текущего положения".
Это удобно в макро- и тестовых сценариях, где важен именно дельта-сдвиг.

```text title="Команда" theme={null}
.rotate-relative 90 0
```

## `.rotate-pos <x> <y> <z>`

Поворачивает игрока к указанной точке в мире.

Клиент берёт координаты, считает нужные yaw/pitch и применяет результат. Команда хороша для точного наведения на блок, точку маршрута или фиксированное место на сцене.
Тяжело придумать ей реальное применение, однако добавить её следовало.

```text title="Команда" theme={null}
.rotate-pos 100 64 -20
```

## `.rotate-set <yaw> <pitch>`

Устанавливает точный угол поворота вручную. Вместо одного из значений можно передать `x`, чтобы оставить
текущий yaw или pitch без изменений.

Это самая прямолинейная команда главы: она не ищет цель и не считает поворот сама, а просто ставит нужный
угол.

```text title="Примеры" theme={null}
.rotate-set 180 0
.rotate-set x 20
.rotate-set 90 x
```

## `.rotate-save <name>`

Сохраняет текущий yaw/pitch под именем, чтобы потом быстро вернуть этот угол.

Нюанс здесь важный: сохранение идёт в `RotateCommandManager.savedRotations`, то есть в runtime-память
текущего запуска клиента. Это не полноценный постоянный preset.

```text title="Команда" theme={null}
.rotate-save bridge
```

## `.rotate-load <name>`

Загружает ранее сохранённый угол поворота по имени.

Если запись найдена, камера вернётся к сохранённому yaw/pitch. Если имени нет, клиент печатает ошибку.

```text title="Команда" theme={null}
.rotate-load bridge
```

## `.rotate list`

Показывает все сохранённые повороты, которые сейчас лежат в памяти клиента.

Полезно, если ты уже забыл, как именно назвал сохранённые точки.

```text title="Команда" theme={null}
.rotate list
```

## `.rotate delete <name>`

Удаляет сохранённый поворот по имени.

Это сервисная команда для чистки списка, когда временные сохранения больше не нужны.

```text title="Команда" theme={null}
.rotate delete bridge
```