love.conf

Введение

Если в папке вашей игры (или файле .love) присутствует файл под названием conf.lua, он выполняется перед загрузкой модулей LÖVE. Вы можете использовать этот файл для перезаписи функции love.conf, которая позднее вызывается скриптом загрузки LÖVE 'boot'. Используя функцию love.conf, вы можете настроить некоторые параметры конфигурации и изменить такие вещи, как размер окна по умолчанию, загружаемые модули и другие параметры.

love.conf

Функция love.conf принимает один аргумент: таблицу, заполненную всеми значениями по умолчанию, которые вы можете переопределить по своему усмотрению. Например, если вы хотите изменить размер окна по умолчанию, сделайте следующее:

function love.conf(t)
    t.window.width = 1024
    t.window.height = 768
end

Если вам не нужны модули физики или джойстика, сделайте следующее.

function love.conf(t)
    t.modules.joystick = false
    t.modules.physics = false
end

Установка ненужных модулей в значение false рекомендуется при релизе вашей игры. Это незначительно сокращает время запуска (особенно если модуль джойстика отключен) и уменьшает использование памяти (незначительно).

Обратите внимание, что вы не можете отключить love.filesystem и love.data; это обязательно. То же самое касается и самого модуля love. Модуль love.graphics нуждается в модуле love.window.

В версиях LÖVE 0.9.2 и более ранних, ошибки в файле конфигурации приведут к тому, что игра не запустится, и не будет отображаться никакого сообщения об ошибке. Если игра не загружается, сначала проверьте файл конфигурации на наличие ошибок. В версии 0.10.2 и более поздних версиях ошибки в конфигурации теперь будут отображаться на синем экране с ошибкой в файле конфигурации.

Текущий файл конфигурации

Вот полный список опций и их значений по умолчанию для LÖVE 11.3:

function love.conf(t)
    t.identity = nil                    -- The name of the save directory (string)
    t.appendidentity = false            -- Search files in source directory before save directory (boolean)
    t.version = "11.3"                  -- The LÖVE version this game was made for (string)
    t.console = false                   -- Attach a console (boolean, Windows only)
    t.accelerometerjoystick = true      -- Enable the accelerometer on iOS and Android by exposing it as a Joystick (boolean)
    t.externalstorage = false           -- True to save files (and read from the save directory) in external storage on Android (boolean) 
    t.gammacorrect = false              -- Enable gamma-correct rendering, when supported by the system (boolean)
 
    t.audio.mic = false                 -- Request and use microphone capabilities in Android (boolean)
    t.audio.mixwithsystem = true        -- Keep background music playing when opening LOVE (boolean, iOS and Android only)
 
    t.window.title = "Untitled"         -- The window title (string)
    t.window.icon = nil                 -- Filepath to an image to use as the window's icon (string)
    t.window.width = 800                -- The window width (number)
    t.window.height = 600               -- The window height (number)
    t.window.borderless = false         -- Remove all border visuals from the window (boolean)
    t.window.resizable = false          -- Let the window be user-resizable (boolean)
    t.window.minwidth = 1               -- Minimum window width if the window is resizable (number)
    t.window.minheight = 1              -- Minimum window height if the window is resizable (number)
    t.window.fullscreen = false         -- Enable fullscreen (boolean)
    t.window.fullscreentype = "desktop" -- Choose between "desktop" fullscreen or "exclusive" fullscreen mode (string)
    t.window.vsync = 1                  -- Vertical sync mode (number)
    t.window.msaa = 0                   -- The number of samples to use with multi-sampled antialiasing (number)
    t.window.depth = nil                -- The number of bits per sample in the depth buffer
    t.window.stencil = nil              -- The number of bits per sample in the stencil buffer
    t.window.display = 1                -- Index of the monitor to show the window in (number)
    t.window.highdpi = false            -- Enable high-dpi mode for the window on a Retina display (boolean)
    t.window.usedpiscale = true         -- Enable automatic DPI scaling when highdpi is set to true as well (boolean)
    t.window.x = nil                    -- The x-coordinate of the window's position in the specified display (number)
    t.window.y = nil                    -- The y-coordinate of the window's position in the specified display (number)
 
    t.modules.audio = true              -- Enable the audio module (boolean)
    t.modules.data = true               -- Enable the data module (boolean)
    t.modules.event = true              -- Enable the event module (boolean)
    t.modules.font = true               -- Enable the font module (boolean)
    t.modules.graphics = true           -- Enable the graphics module (boolean)
    t.modules.image = true              -- Enable the image module (boolean)
    t.modules.joystick = true           -- Enable the joystick module (boolean)
    t.modules.keyboard = true           -- Enable the keyboard module (boolean)
    t.modules.math = true               -- Enable the math module (boolean)
    t.modules.mouse = true              -- Enable the mouse module (boolean)
    t.modules.physics = true            -- Enable the physics module (boolean)
    t.modules.sound = true              -- Enable the sound module (boolean)
    t.modules.system = true             -- Enable the system module (boolean)
    t.modules.thread = true             -- Enable the thread module (boolean)
    t.modules.timer = true              -- Enable the timer module (boolean), Disabling it will result 0 delta time in love.update
    t.modules.touch = true              -- Enable the touch module (boolean)
    t.modules.video = true              -- Enable the video module (boolean)
    t.modules.window = true             -- Enable the window module (boolean)
end

Флаги

identity

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

t.identity = "gabe_HL3" -- Correct
t.identity = "c:/Users/gabe/HL3" -- Incorrect

В качестве альтернативы можно использовать love.filesystem.setIdentity для установки каталога сохранения вне файла конфигурации.

appendidentity

Доступно начиная с LÖVE 11.0
Этот флаг не поддерживается в более ранних версиях.

Этот флаг определяет, должен ли сначала проверяться каталог игры, а затем каталог сохранения (true) или иначе (false)

version

Доступно начиная с LÖVE 0.8.0
Этот флаг не поддерживается в более ранних версиях.

t.version должен быть строкой, представляющей версию LÖVE, для которой была создана ваша игра.

До версии 11.0, он должен быть отформатирован как "X.Y.Z", где X — номер основной версии, Y — номер дополнительной версии, а Z — номер исправления. Начиная с версии 11.0, он должен быть отформатирован как "X.Y", где X и Y — соответственно номер основной и дополнительной версии.

Если этот параметр задан в файле конфигурации игры, LÖVE отобразит предупреждение, если игра несовместима с текущей версией LÖVE, используемой для запуска игры. Значение по умолчанию — версия используемого LÖVE.

console

Определяет, открывать ли консоль вместе с окном игры (только Windows) или нет. Примечание: в OSX вы можете получить вывод консоли, запустив LÖVE через терминал, или в Windows с LÖVE 0.10.2, запустив lovec.exe вместо love.exe.

accelerometerjoystick

Доступно начиная с LÖVE 0.10.0
Этот флаг не поддерживается в более ранних версиях.

Устанавливает, следует ли устройству акселерометра на iOS и Android экспонировать его как 3-осевой джойстик. Отключение акселерометра, когда он не используется, может снизить использование ЦП.

externalstorage

Доступно начиная с LÖVE 0.10.1
Этот флаг не поддерживается в более ранних версиях.

Устанавливает, сохраняются ли файлы во внешнем хранилище (true) или внутреннем хранилище (false) на Android.

gammacorrect

Доступно начиная с LÖVE 0.10.0
Этот флаг не поддерживается в более ранних версиях.

Определяет, включено ли гамма-корректное рендерирование, если система его поддерживает.

audio.mic

Доступно начиная с LÖVE 11.3
Этот флаг не поддерживается в более ранних версиях.

Запрашивает разрешение на использование микрофона у пользователя. Когда пользователь разрешит, love.audio.getRecordingDevices выведет список доступных устройств записи. В противном случае love.audio.getRecordingDevices вернет пустую таблицу, а пользователю будет показано сообщение, информирующее его об этом при вызове.

audio.mixwithsystem

Доступно начиная с LÖVE 11.0
Этот флаг не поддерживается в более ранних версиях.

Устанавливает, воспроизводится ли фоновая аудио/музыка из других приложений, пока открыт LÖVE. Подробнее см. love.system.hasBackgroundMusic.

window

Доступно начиная с LÖVE 0.9.0
Эти флаги не поддерживаются в более ранних версиях.

Можно отложить создание окна до первого вызова love.window.setMode в вашем коде. Для этого установите t.window = nil в love.conf (или t.screen = nil в более старых версиях.) Если это сделано, LÖVE может завершиться ошибкой, если любая функция из love.graphics вызывается до первого вызова love.window.setMode в вашем коде.

Таблица t.window называлась t.screen в версиях до 0.9.0. Таблица t.screen не существует в love.conf в версии 0.9.0, а таблица t.window не существует в love.conf в версии 0.8.0. Это означает, что love.conf не выполнится (поэтому он вернется к значениям по умолчанию), если не позаботиться о правильном использовании таблицы для используемой версии LÖVE.