Что такое Console (консоль) в Unreal Engine (UE4, UE5)?

Console (консоль) в Unreal Engine

Console (консоль) в Unreal Engine (UE4, UE5) — это встроенный интерфейс командной строки, который позволяет взаимодействовать с движком в режиме реального времени во время работы редактора или запущенной игры. С её помощью разработчик может выполнять команды, изменять внутренние параметры движка, анализировать производительность, тестировать игровые механики и использовать инструменты отладки без необходимости пересобирать проект.

Одним из главных преимуществ консоли является то, что большинство изменений применяется мгновенно. Это значительно ускоряет процесс разработки и тестирования. Например, одной командой можно изменить параметры освещения, включить или отключить графические эффекты, вывести статистику производительности, визуализировать коллизии, изменить скорость течения игрового времени или временно ограничить частоту кадров.

По умолчанию консоль открывается клавишей ~ (тильда) или ` (в зависимости от раскладки клавиатуры и региональных настроек). При первом нажатии появляется строка ввода команд (компактная строка ввода внизу экрана), а повторное нажатие разворачивает полноэкранный интерфейс консоли с историей логов (Output Log), в котором отображаются результаты выполнения команд, сообщения движка, предупреждения и ошибки. Такой вид консоли крайне полезен, когда нужно прочитать длинный ответ на команду. Выход из консоли производится либо повторным нажатием тильды, либо клавишей Esc.

Если клавиша вызова консоли не работает, её можно изменить в Project Settings → Engine → Input → Console Keys.

Консоль доступна:

• в самом редакторе Unreal Editor (при этом отдельно консоль вызывать не нужно, по умолчанию в редакторе строка ввода консольных команд всегда доступна ниже окна Viewport);
• в режиме Simulate (по умолчанию консоль также доступна ниже окна Viewport);
• в режиме Play In Editor (PIE);
• в сборках игры Debug и Development.

В сборке игры Shipping консоль по умолчанию отключена, поскольку конечный пользователь не должен иметь доступ к инструментам разработки, отладки и внутренним настройкам игры. Но при необходимости её все же можно включить вручную через системные файлы, однако делать это рекомендуется только в исключительных случаях.

Также в особых случаях консольные команды можно вызывать и из кода, например, в Blueprint для этого можно использовать узел Execute Console Command.

Практически все возможности консоли можно разделить на две большие категории: Console Commands — консольные команды и Console Variables (CVars) — консольные переменные.

Console Commands (консольные команды)

Console Commands представляют собой команды, которые выполняют некоторое действие один раз. Они не сохраняют состояние и сразу завершают работу после выполнения. Например, такие команды используются для вывода информации на экран о текущем состоянии тех или иных систем движка (FPS, статистика GPU и прочее). Чтобы прекратить вывод такой информации на экран, нужно вызвать данную команду повторно еще раз.

Наиболее распространённые Console Commands:

• Stat FPS — отображает текущий FPS (обычно справа вверху экрана Viewport);
• Stat UNIT — выводит время работы циклов основных подсистем движка (Game, Draw, GPU);
• Stat GPU — показывает подробную статистику загрузки GPU;
• Slomo 0.5 — замедляет игровое время в два раза;
• HighResShot 3840x2160 — сохраняет скриншот в высоком разрешении (в папке проекта Saved\Screenshots);
• ToggleDebugCamera — включает режим свободной камеры;
• Show Collision — отображает коллизии объектов;
• RestartLevel — перезапускает текущий уровень.

После выполнения команды движок возвращается к обычной работе, если сама команда не включает какой-либо постоянный режим отображения или отладки.

Console Variables (CVars, консольные переменные)

Console Variables (CVars) — это специальные переменные, управляющие состоянием различных подсистем Unreal Engine. Именно через CVars настраивается большинство современных технологий движка, поэтому они являются одним из важнейших инструментов для разработчиков, технических художников и специалистов по оптимизации.

С помощью CVars можно управлять параметрами рендеринга, освещением и тенями, технологиями Lumen и Nanite, трассировкой лучей, качеством постобработки, использованием памяти, многопоточностью, физикой, системой стриминга ресурсов, сетевой подсистемой, поведением редактора.

Например:

• r.ScreenPercentage 100 — изменяет внутреннее разрешение рендера, позволяя отрисовывать 3D-сцену в более низком или высоком разрешении. При значении 100 - рендеринг идет в нативном разрешении, при значении меньше 100 - качество рендера снижается, что дает огромный прирост FPS, но картинка становится менее четкой, при значении болше 100 - движок рисует картинку в избыточном разрешении, что заметно сказывается на FPS;
• r.Nanite 1 — включает (1) или отключает (0) систему Nanite;
• t.MaxFPS 60 — ограничивает максимальную частоту кадров в 60 кадров в секунду

В отличие от обычных команд, CVars хранят некоторое состояние. После изменения их значения соответствующая подсистема движка сразу начинает работать с новыми параметрами.

Чтобы изменить значение консольной переменной, необходимо ввести её имя, затем через пробел указать новое значение. Например: t.MaxFPS 60 - временно ограничит максимальную частоту кадров значением 60 FPS. А t.MaxFPS 30 - ограничит частоту кадров до 30 FPS.

Изменение применяется сразу после выполнения команды — перезапуск редактора или игры не требуется.

---------------------

Следует учитывать, что большинство изменений, внесённых через консоль, являются временными. Они действуют только до завершения текущего сеанса работы редактора или игры. Если необходимо сделать параметр постоянным, его обычно задают в конфигурационных файлах либо изменяют соответствующие настройки проекта.

Также консоль Unreal Engine поддерживает автодополнение команд и переменных. Достаточно начать вводить имя команды или CVar, после чего консоль предложит список подходящих вариантов. Для многих команд и переменных отображается краткое описание, что позволяет быстро узнать их назначение без обращения к документации.

В целом количество доступных Console Commands и CVars исчисляется тысячами. Они охватывают практически все подсистемы Unreal Engine — от рендеринга и физики до работы с памятью, потоками процессора, сетью, анимацией, аудио и системой логирования. Поэтому умение пользоваться консолью может существенно ускорить процесс разработки, тестирования и оптимизации проекта.

===============

Как в Unreal Engine выполнить несколько команд в консоли (console)?

Справочник консольных переменных (категория Rendering)

Справочник консольных переменных (категория Physics)

Справочник консольных переменных (остальные категории)

Справочник консольных команд

Зарегистрироваться в ЛК и скачать книгу по Blueprint: [Blueprint. Взгляд с высоты «птичьего полёта»]