Config Files (Français)

Introduction

Si un fichier appelé conf.lua est présent dans votre dossier de jeu (ou fichier .love), il est exécuté avant que les modules LÖVE soient chargés. Vous pouvez utiliser ce fichier pour remplacer la fonction love.conf, appelée plus tard par le script de 'démarrage' de LÖVE. À l'aide de la fonction love.conf, vous pouvez définir certaines options de configuration et modifier des éléments tels que la taille par défaut de la fenêtre, les modules chargés et d'autres éléments.

love.conf

La fonction love.conf prend un argument: une table contenant toutes les valeurs par défaut que vous pouvez écraser à votre guise. Si vous voulez changer la taille de la fenêtre par défaut, par exemple:

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

Si vous n'avez pas besoin du module physique ou du module joystick, procédez comme suit.

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

Définir les modules inutilisés à false est encouragé lorsque vous lancez votre jeu. Il réduit légèrement le temps de démarrage (surtout si le module du joystick est désactivé) et réduit l'utilisation de la mémoire (légèrement).

Notez que vous ne pouvez pas désactiver love.filesystem; il est obligatoire. La même chose vaut pour le module love lui-même. love.graphics à besoin de love.window pour être activé.

Fichier de configuration actuel

Voici une liste complète des options et de leurs valeurs par défaut pour LÖVE 11.0:

function love.conf(t)
    t.identity = nil                    -- Le nom du répertoire de sauvegarde (string)
    t.appendidentity = false            -- Rechercher des fichiers dans le répertoire source avant le répertoire de sauvegarde (booléen)
    t.version = "11.0"                  -- La version de LÖVE pour laquelle ce jeu a été fait (string)
    t.console = false                   -- Ouvrir une console (boolean, Windows seulement)
    t.accelerometerjoystick = true      -- Activer l'accéléromètre sur iOS et Android en l'exposant comme un joystick (boolean)
    t.externalstorage = false           -- True pour enregistrer les fichiers (et lire depuis le répertoire de sauvegarde) dans un stockage externe sur Android (booléen)
    t.gammacorrect = false              -- Activer le rendu de correction gamma, lorsqu'il est pris en charge par le système (booléen)

    t.audio.mixwithsystem = true        -- Continue à jouer la musique de fond lors de l'ouverture de LOVE (booléen, iOS et Android seulement)

    t.window.title = "Untitled"         -- Titre de la fenêtre (string)
    t.window.icon = nil                 -- Chemin du fichier vers une image à utiliser comme icône de la fenêtre (string)
    t.window.width = 800                -- Largeur de la fenêtre (number)
    t.window.height = 600               -- Hauteur de la fenêtre (number)
    t.window.borderless = false         -- Supprime toutes les bordures de la fenêtre (booléen)
    t.window.resizable = false          -- Laissez la fenêtre être redimensionnable par l'utilisateur (booléen)
    t.window.minwidth = 1               -- Largeur minimale de la fenêtre si elle est redimensionnée (number)
    t.window.minheight = 1              -- Hauteur minimale de la fenêtre si elle est redimensionnée (number)
    t.window.fullscreen = false         -- Active le plein écran (booléen)
    t.window.fullscreentype = "desktop" -- Choisissez entre le mode plein écran "bureau" ou le mode plein écran "exclusif" (string)
    t.window.vsync = 1                  -- Mode de synchronisation verticale (number)
    t.window.msaa = 0                   -- Le nombre d'échantillons à utiliser avec l'anti-crénelage multi-échantillonné (number)
    t.window.display = 1                -- Index du moniteur où afficher la fenêtre (number)
    t.window.highdpi = false            -- Activer le mode haute résolution pour la fenêtre sur un écran Retina (booléen)
    t.window.x = nil                    -- La position x de la fenêtre dans l'écran spécifié (number)
    t.window.y = nil                    -- La position y de la fenêtre dans l'écran spécifié (number)
end