Документация Docs/ru/reference/cmake/options.md

Параметры проекта CMake

Сгенерированный справочник. Не редактируйте эту страницу напрямую. Обновите BuildTools/cmake/ProjectInterface.json, затем выполните python BuildTools/docs_cmake.py --write.

Индекс справочника

Каноническая JSON-модель

Контракт генерации

Параметры объявляются из manifest интерфейса во время StartProjectGeneration(). После объявления все значения являются значениями кеша CMake.

Порядок переопределения приведён в индексе справочника.

Стабильный ID	Параметр	Тип / значение	Обязателен	По умолчанию	Допустимые	Категория	Описание
`cmake.option.FO_MAIN_CONFIG`	`FO_MAIN_CONFIG`	`STRING` / `path`	Да	Обязателен	-	`project-identity`	Путь к основному файлу конфигурации .fomain подключающего проекта.
`cmake.option.FO_DEV_NAME`	`FO_DEV_NAME`	`STRING` / `identifier`	Да	Обязателен	-	`project-identity`	Краткий идентификатор проекта, используемый как префикс сгенерированных целей и бинарных файлов.
`cmake.option.FO_NICE_NAME`	`FO_NICE_NAME`	`STRING` / `string`	Да	Обязателен	-	`project-identity`	Читаемое человеком имя проекта для сгенерированных приложений и пакетов.
`cmake.option.FO_GEOMETRY`	`FO_GEOMETRY`	`STRING` / `enum`	Да	Обязателен	`HEXAGONAL`, `SQUARE`	`geometry`	Режим геометрии сетки мира.
`cmake.option.FO_MAP_HEX_WIDTH`	`FO_MAP_HEX_WIDTH`	`STRING` / `integer`	Да	Обязателен	-	`geometry`	Ширина ячейки карты в пикселях.
`cmake.option.FO_MAP_HEX_HEIGHT`	`FO_MAP_HEX_HEIGHT`	`STRING` / `integer`	Да	Обязателен	-	`geometry`	Высота ячейки карты в пикселях.
`cmake.option.FO_MAP_CAMERA_ANGLE`	`FO_MAP_CAMERA_ANGLE`	`STRING` / `number`	Да	Обязателен	-	`geometry`	Угол камеры карты в градусах.
`cmake.option.FO_APP_ICON`	`FO_APP_ICON`	`STRING` / `path`	Да	Обязателен	-	`project-identity`	Исходник значка приложения для сгенерированных платформенных целей.
`cmake.option.FO_OUTPUT_PATH`	`FO_OUTPUT_PATH`	`STRING` / `path`	Да	Обязателен	-	`output`	Общий корень для сгенерированных бинарных файлов, пакетов, данных запекания и результатов проверки.
`cmake.option.FO_CXX_STANDARD`	`FO_CXX_STANDARD`	`STRING` / `integer`	Нет	`20`	-	`toolchain`	Стандарт языка C++ для компиляции проекта; значения ниже 20 не поддерживаются.
`cmake.option.FO_BINARY_OUTPUT_POSTFIX`	`FO_BINARY_OUTPUT_POSTFIX`	`STRING` / `string`	Нет		-	`output`	Необязательный суффикс имён каталогов сгенерированных бинарных файлов.
`cmake.option.FO_EMBEDDED_DATA_CAPACITY`	`FO_EMBEDDED_DATA_CAPACITY`	`STRING` / `integer`	Нет	`200000`	-	`capacity`	Ёмкость, зарезервированная для встроенных данных в сгенерированных бинарных файлах.
`cmake.option.FO_EFFECT_SCRIPT_VALUES`	`FO_EFFECT_SCRIPT_VALUES`	`STRING` / `integer`	Нет	`16`	-	`rendering-shape`	Количество float-слотов в ScriptValueBuf; значение должно быть кратно четырём.
`cmake.option.FO_EFFECT_MAX_PASSES`	`FO_EFFECT_MAX_PASSES`	`STRING` / `integer`	Нет	`6`	-	`rendering-shape`	Максимальное количество проходов одного эффекта.
`cmake.option.FO_MODEL_LAYERS_COUNT`	`FO_MODEL_LAYERS_COUNT`	`STRING` / `integer`	Нет	`30`	-	`model-shape`	Количество слоёв рендеринга модели, скомпилированных в shape-контракт движка.
`cmake.option.FO_MODEL_MAX_TEXTURES`	`FO_MODEL_MAX_TEXTURES`	`STRING` / `integer`	Нет	`8`	-	`model-shape`	Максимальное количество текстур одной 3D-модели.
`cmake.option.FO_MODEL_MAX_BONES`	`FO_MODEL_MAX_BONES`	`STRING` / `integer`	Нет	`54`	-	`model-shape`	Максимальное количество матриц костей одной 3D-модели.
`cmake.option.FO_MODEL_BONES_PER_VERTEX`	`FO_MODEL_BONES_PER_VERTEX`	`STRING` / `integer`	Нет	`4`	-	`model-shape`	Количество влияний костей, скомпилированных в каждую вершину 3D-модели.
`cmake.option.FO_STRING_INLINE_CAPACITY`	`FO_STRING_INLINE_CAPACITY`	`STRING` / `integer`	Нет	`31`	-	`capacity`	Число символов, хранимых внутри строки движка до выделения памяти; значение должно быть на единицу меньше числа, кратного восьми.
`cmake.option.FO_MSAN_LIBCXX_ROOT`	`FO_MSAN_LIBCXX_ROOT`	`STRING` / `path`	Нет		-	`toolchain`	Префикс установки инструментированной MSan библиотеки libc++ для конфигураций San_Memory.
`cmake.option.FO_MSAN_IGNORELIST`	`FO_MSAN_IGNORELIST`	`STRING` / `path`	Нет	`${CMAKE_CURRENT_SOURCE_DIR}/${FO_ENGINE_ROOT}/BuildTools/sanitizers/msan-ignorelist.txt`	-	`toolchain`	Путь к ignorelist MemorySanitizer.
`cmake.option.FO_RESHARPER_SETTINGS`	`FO_RESHARPER_SETTINGS`	`STRING` / `path`	Нет		-	`tooling`	Необязательный файл настроек решения ReSharper, копируемый при финализации.
`cmake.option.FO_ENABLE_3D`	`FO_ENABLE_3D`	`BOOL` / `boolean`	Нет	`OFF`	-	`feature`	Компилирует поддержку 3D-моделей.
`cmake.option.FO_SPARK_PARTICLES`	`FO_SPARK_PARTICLES`	`BOOL` / `boolean`	Нет	`OFF`	-	`feature`	Компилирует baker частиц SPARK, runtime-backend и инструменты создания в Mapper.
`cmake.option.FO_EFFEKSEER_PARTICLES`	`FO_EFFEKSEER_PARTICLES`	`BOOL` / `boolean`	Нет	`OFF`	-	`feature`	Компилирует компилятор проектов Effekseer и runtime-backend.
`cmake.option.FO_NATIVE_SCRIPTING`	`FO_NATIVE_SCRIPTING`	`BOOL` / `boolean`	Нет	`OFF`	-	`scripting`	Резервирует настройку корня исходников Native scripting; в текущем дереве реализованного Native backend нет.
`cmake.option.FO_ANGELSCRIPT_SCRIPTING`	`FO_ANGELSCRIPT_SCRIPTING`	`BOOL` / `boolean`	Нет	`OFF`	-	`scripting`	Компилирует backend скриптов AngelScript.
`cmake.option.FO_MANAGED_SCRIPTING`	`FO_MANAGED_SCRIPTING`	`BOOL` / `boolean`	Нет	`OFF`	-	`scripting`	Компилирует скриптовый backend Managed C# и встроенную среду выполнения Mono.
`cmake.option.FO_MEMORY_DIAGNOSTICS`	`FO_MEMORY_DIAGNOSTICS`	`BOOL` / `boolean`	Нет	`OFF`	-	`profiling`	Включает статистику заполнения rpmalloc в обычных сборках; Debug и Tracy уже включают её при доступном rpmalloc.
`cmake.option.FO_DISABLE_RPMALLOC`	`FO_DISABLE_RPMALLOC`	`BOOL` / `boolean`	Нет	`OFF`	-	`dependency`	Отключает встроенный аллокатор rpmalloc.
`cmake.option.FO_DISABLE_MONGO`	`FO_DISABLE_MONGO`	`BOOL` / `boolean`	Нет	`OFF`	-	`dependency`	Отключает поддержку backend MongoDB.
`cmake.option.FO_DISABLE_SQLITE`	`FO_DISABLE_SQLITE`	`BOOL` / `boolean`	Нет	`OFF`	-	`dependency`	Отключает поддержку backend SQLite.
`cmake.option.FO_DISABLE_ASIO`	`FO_DISABLE_ASIO`	`BOOL` / `boolean`	Нет	`OFF`	-	`dependency`	Отключает сетевой backend Asio.
`cmake.option.FO_DISABLE_WEB_SOCKETS`	`FO_DISABLE_WEB_SOCKETS`	`BOOL` / `boolean`	Нет	`OFF`	-	`dependency`	Отключает поддержку транспорта WebSocket.
`cmake.option.FO_DISABLE_NAMESPACE`	`FO_DISABLE_NAMESPACE`	`BOOL` / `boolean`	Нет	`OFF`	-	`native-interface`	Компилирует нативные символы движка без пространства имён FOnline.
`cmake.option.FO_DISABLE_VULKAN`	`FO_DISABLE_VULKAN`	`BOOL` / `boolean`	Нет	`OFF`	-	`rendering`	Отключает backend рендеринга Vulkan.
`cmake.option.FO_DISABLE_SDL_GPU`	`FO_DISABLE_SDL_GPU`	`BOOL` / `boolean`	Нет	`OFF`	-	`rendering`	Отключает backend рендеринга SDL_GPU.
`cmake.option.FO_VERBOSE_BUILD`	`FO_VERBOSE_BUILD`	`BOOL` / `boolean`	Нет	`OFF`	-	`diagnostics`	Включает подробный status-вывод системы сборки FOnline.
`cmake.option.FO_BUILD_CLIENT`	`FO_BUILD_CLIENT`	`BOOL` / `boolean`	Нет	`OFF`	-	`target`	Создаёт цели клиентских приложений.
`cmake.option.FO_BUILD_SERVER`	`FO_BUILD_SERVER`	`BOOL` / `boolean`	Нет	`OFF`	-	`target`	Создаёт цели серверных приложений.
`cmake.option.FO_BUILD_MAPPER`	`FO_BUILD_MAPPER`	`BOOL` / `boolean`	Нет	`OFF`	-	`target`	Создаёт цели приложения Mapper.
`cmake.option.FO_BUILD_ASCOMPILER`	`FO_BUILD_ASCOMPILER`	`BOOL` / `boolean`	Нет	`OFF`	-	`target`	Создаёт цель приложения-компилятора AngelScript.
`cmake.option.FO_BUILD_BAKER`	`FO_BUILD_BAKER`	`BOOL` / `boolean`	Нет	`OFF`	-	`target`	Создаёт цели приложений baker.
`cmake.option.FO_UNIT_TESTS`	`FO_UNIT_TESTS`	`BOOL` / `boolean`	Нет	`OFF`	-	`quality`	Создаёт цели модульных тестов движка.
`cmake.option.FO_CODE_COVERAGE`	`FO_CODE_COVERAGE`	`BOOL` / `boolean`	Нет	`OFF`	-	`quality`	Создаёт конфигурацию покрытия кода; этот режим нельзя сочетать с режимами сборки приложений или модульных тестов.