Ключи запуска

IMPORTANT

Статус: Поддерживается
Минимальная версия: 1.0

Обзор

Ключи запуска позволяют настраивать поведение движка перед запуском игры. Параметры сгруппированы по функциональным категориям и используются для настройки рендеринга, отладки, производительности и игровых функций

Синтаксис использования

Ключи запуска указываются в командной строке или файле конфигурации в формате:

-<ключ>

или

-<ключ1> -<ключ2> -<ключ3>

Категории параметров

Ядро (Core)

Ключ	Описание
auto_load_arch	Автоматически загружает игровые архивы при старте
nolog	Отключает логирование в файл

Движок (Engine)

Ключ	Описание
xclsx	Отключает отрисовку красного текста в дебаге
no_center_screen	Не центрировать окно при старте
dxdebug	Включает режим отладки DirectX
perfhud_hack	Принудительно активировать все рендеры
noprefetch	Отключить предварительную загрузку данных
demomode	Проигрывание анимации деморекорда
nosound	Полностью отключает звуковую подсистему
r2	Принудительно включить рендерер R2
r4	Принудительно включить рендерер R4

Рендер (Render)

Ключ	Описание
disasm	Включает дизассемблирование шейдеров
nonvs	No nvidia depthstencil (dx9 only)
noshadows	Полностью отключает рендеринг теней
no_occq	Отключает оптимизацию occq
nodistort	Отключает эффекты искажения (тепло, дым)

Игра (Game)

Ключ	Описание
designer	Переводит все алайф объекты в офлайн
debug_ge	Включает режим отладки игровых событий

API

Ключ	Описание
renderdoc	Активирует интеграцию с RenderDoc для захвата кадров

Lua

Ключ	Описание
keep_lua	Не выгружать Lua при смене уровней
use_callstack	Включает вывод callstack при ошибках LUA

Интерфейс

Ключ	Описание
no_debug_panel	Отключает ImGui панель отладки

Примеры использования

Пример 1: Комплексная отладка графики

-dxdebug -disasm -renderdoc

→ Активирует отладку DirectX, дизассемблирование шейдеров и захват в RenderDoc

Пример 2: Отладка скриптов

-use_callstack -keep_lua

→ Сохраняет состояние Lua и показывает стек вызовов при ошибках

Рекомендации

• ⚠ Ограничения:
  Ключи r2 и r4 взаимоисключающие - используйте только один из них
  noprefetch может вызывать подтормаживания при загрузке новых зон
  nonvs работает только в DirectX 9 режиме
  nosound полностью отключает все звуковые эффекты и музыку
  

• ✖ Анти-паттерны:
  Избегайте комбинации nolog + use_callstack при отладке скриптов
  Не активируйте все ключи рендеринга одновременно
  Не используйте demomode в обычном игровом процессе