Документация 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`	Да	Yes	Обязателен	-	`project-identity`	Путь к основному файлу конфигурации .fomain подключающего проекта.
`cmake.option.FO_DEV_NAME`	`FO_DEV_NAME`	`STRING` / `identifier`	Да	Yes	Обязателен	-	`project-identity`	Краткий идентификатор проекта, используемый как префикс сгенерированных целей и бинарных файлов.
`cmake.option.FO_NICE_NAME`	`FO_NICE_NAME`	`STRING` / `string`	Да	Yes	Обязателен	-	`project-identity`	Читаемое человеком имя проекта для сгенерированных приложений и пакетов.
`cmake.option.FO_GEOMETRY`	`FO_GEOMETRY`	`STRING` / `enum`	Да	Yes	Обязателен	`HEXAGONAL`, `SQUARE`	`geometry`	Режим геометрии сетки мира.
`cmake.option.FO_MAP_HEX_WIDTH`	`FO_MAP_HEX_WIDTH`	`STRING` / `integer`	Да	Yes	Обязателен	-	`geometry`	Ширина ячейки карты в пикселях.
`cmake.option.FO_MAP_HEX_HEIGHT`	`FO_MAP_HEX_HEIGHT`	`STRING` / `integer`	Да	Yes	Обязателен	-	`geometry`	Высота ячейки карты в пикселях.
`cmake.option.FO_MAP_CAMERA_ANGLE`	`FO_MAP_CAMERA_ANGLE`	`STRING` / `number`	Да	Yes	Обязателен	-	`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`	Нет	No	`20`	-	`toolchain`	Стандарт языка C++ для компиляции проекта; значения ниже 20 не поддерживаются.
`cmake.option.FO_BINARY_OUTPUT_POSTFIX`	`FO_BINARY_OUTPUT_POSTFIX`	`STRING` / `string`	Нет	No		-	`output`	Необязательный суффикс имён каталогов сгенерированных бинарных файлов.
`cmake.option.FO_EMBEDDED_DATA_CAPACITY`	`FO_EMBEDDED_DATA_CAPACITY`	`STRING` / `integer`	Нет	No	`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`	Нет	No	`31`	-	`capacity`	Число символов, хранимых внутри строки движка до выделения памяти; значение должно быть на единицу меньше числа, кратного восьми.
`cmake.option.FO_TRACE_CATEGORIES`	`FO_TRACE_CATEGORIES`	`STRING` / `string`	Нет	No		-	`profiling`	Выбирает категории профилирования Tracy, компилируемые в конфигурациях профилирования.
`cmake.option.FO_MSAN_LIBCXX_ROOT`	`FO_MSAN_LIBCXX_ROOT`	`STRING` / `path`	Нет	No		-	`toolchain`	Префикс установки инструментированной MSan библиотеки libc++ для конфигураций San_Memory.
`cmake.option.FO_MSAN_IGNORELIST`	`FO_MSAN_IGNORELIST`	`STRING` / `path`	Нет	No	`${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`	Нет	No		-	`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`	Нет	No	`OFF`	-	`profiling`	Включает статистику заполнения rpmalloc в обычных сборках; Debug и Tracy уже включают её при доступном rpmalloc.
`cmake.option.FO_DISABLE_RPMALLOC`	`FO_DISABLE_RPMALLOC`	`BOOL` / `boolean`	Нет	No	`OFF`	-	`dependency`	Отключает встроенный аллокатор rpmalloc.
`cmake.option.FO_DATA_SOURCE_DAT`	`FO_DATA_SOURCE_DAT`	`BOOL` / `boolean`	Нет	Да	`OFF`	-	`dependency`	Включает ресурсные архивы DAT 2.0 и 2.1.
`cmake.option.FO_DATA_SOURCE_ZIP`	`FO_DATA_SOURCE_ZIP`	`BOOL` / `boolean`	Нет	Да	`OFF`	-	`dependency`	Включает внешние ресурсные архивы ZIP и BOS.
`cmake.option.FO_DATABASE_JSON`	`FO_DATABASE_JSON`	`BOOL` / `boolean`	Нет	No	`OFF`	-	`dependency`	Включает файловый провайдер базы данных JSON.
`cmake.option.FO_DATABASE_SQLITE`	`FO_DATABASE_SQLITE`	`BOOL` / `boolean`	Нет	No	`OFF`	-	`dependency`	Включает провайдер SQLite с документами CBOR.
`cmake.option.FO_DATABASE_MONGO`	`FO_DATABASE_MONGO`	`BOOL` / `boolean`	Нет	No	`OFF`	-	`dependency`	Включает провайдер MongoDB и его зависимости libbson/mongoc.
`cmake.option.FO_IMAGE_FRM`	`FO_IMAGE_FRM`	`BOOL` / `boolean`	Нет	Да	`OFF`	-	`dependency`	Включает загрузчик изображений FRM.
`cmake.option.FO_IMAGE_RIX`	`FO_IMAGE_RIX`	`BOOL` / `boolean`	Нет	Да	`OFF`	-	`dependency`	Включает загрузчик изображений RIX.
`cmake.option.FO_IMAGE_ART`	`FO_IMAGE_ART`	`BOOL` / `boolean`	Нет	Да	`OFF`	-	`dependency`	Включает загрузчик изображений ART.
`cmake.option.FO_IMAGE_SPR`	`FO_IMAGE_SPR`	`BOOL` / `boolean`	Нет	Да	`OFF`	-	`dependency`	Включает загрузчик изображений SPR.
`cmake.option.FO_IMAGE_ZAR`	`FO_IMAGE_ZAR`	`BOOL` / `boolean`	Нет	Да	`OFF`	-	`dependency`	Включает загрузчик изображений ZAR.
`cmake.option.FO_IMAGE_TIL`	`FO_IMAGE_TIL`	`BOOL` / `boolean`	Нет	Да	`OFF`	-	`dependency`	Включает загрузчик изображений TIL.
`cmake.option.FO_IMAGE_MOS`	`FO_IMAGE_MOS`	`BOOL` / `boolean`	Нет	Да	`OFF`	-	`dependency`	Включает загрузчик изображений MOS.
`cmake.option.FO_IMAGE_BAM`	`FO_IMAGE_BAM`	`BOOL` / `boolean`	Нет	Да	`OFF`	-	`dependency`	Включает загрузчик изображений BAM.
`cmake.option.FO_AUDIO_ACM`	`FO_AUDIO_ACM`	`BOOL` / `boolean`	Нет	Да	`OFF`	-	`dependency`	Включить импортёр аудио ACM.
`cmake.option.FO_DISABLE_ASIO`	`FO_DISABLE_ASIO`	`BOOL` / `boolean`	Нет	No	`OFF`	-	`dependency`	Отключает сетевой backend Asio.
`cmake.option.FO_DISABLE_WEB_SOCKETS`	`FO_DISABLE_WEB_SOCKETS`	`BOOL` / `boolean`	Нет	No	`OFF`	-	`dependency`	Отключает поддержку транспорта WebSocket.
`cmake.option.FO_DISABLE_NAMESPACE`	`FO_DISABLE_NAMESPACE`	`BOOL` / `boolean`	Нет	No	`OFF`	-	`native-interface`	Компилирует нативные символы движка без пространства имён FOnline.
`cmake.option.FO_DISABLE_VULKAN`	`FO_DISABLE_VULKAN`	`BOOL` / `boolean`	Нет	No	`OFF`	-	`rendering`	Отключает backend рендеринга Vulkan.
`cmake.option.FO_DISABLE_SDL_GPU`	`FO_DISABLE_SDL_GPU`	`BOOL` / `boolean`	Нет	No	`OFF`	-	`rendering`	Отключает backend рендеринга SDL_GPU.
`cmake.option.FO_VERBOSE_BUILD`	`FO_VERBOSE_BUILD`	`BOOL` / `boolean`	Нет	No	`OFF`	-	`diagnostics`	Включает подробный status-вывод системы сборки FOnline.
`cmake.option.FO_BUILD_CLIENT`	`FO_BUILD_CLIENT`	`BOOL` / `boolean`	Нет	No	`OFF`	-	`target`	Создаёт цели клиентских приложений.
`cmake.option.FO_BUILD_SERVER`	`FO_BUILD_SERVER`	`BOOL` / `boolean`	Нет	No	`OFF`	-	`target`	Создаёт цели серверных приложений.
`cmake.option.FO_BUILD_MAPPER`	`FO_BUILD_MAPPER`	`BOOL` / `boolean`	Нет	No	`OFF`	-	`target`	Создаёт цели приложения Mapper.
`cmake.option.FO_BUILD_ASCOMPILER`	`FO_BUILD_ASCOMPILER`	`BOOL` / `boolean`	Нет	No	`OFF`	-	`target`	Создаёт цель приложения-компилятора AngelScript.
`cmake.option.FO_BUILD_BAKER`	`FO_BUILD_BAKER`	`BOOL` / `boolean`	Нет	No	`OFF`	-	`target`	Создаёт цели приложений baker.
`cmake.option.FO_UNIT_TESTS`	`FO_UNIT_TESTS`	`BOOL` / `boolean`	Нет	No	`OFF`	-	`quality`	Создаёт цели модульных тестов движка.
`cmake.option.FO_CODE_COVERAGE`	`FO_CODE_COVERAGE`	`BOOL` / `boolean`	Нет	No	`OFF`	-	`quality`	Создаёт конфигурацию покрытия кода; этот режим нельзя сочетать с режимами сборки приложений или модульных тестов.