View source for AutoConfigs (AMX Mod X Scripting)/fr

{{Languages|AutoConfigs (AMX Mod X Scripting)}}


== Introduction ==

AMX Mod X fournit un système simple pour générer automatiquement des fichiers de configuration qui seront executés au chargement. C'est possible grâce à la native {{tt|AutoExecConfig}} dans {{tt|[https://github.com/alliedmodders/amxmodx/blob/master/plugins/include/amxmodx.inc#L3266-L3306 scripting/include/amxmodx.inc]}}.

Une fois que tous les fichiers sont exécutés, le forward {{tt|OnConfigsExecuted}} est appelé. Ce forward sera toujours appelé, même si votre plugin n'a pas de fichier de configuration ou a été chargé plus tard.

== Usage ==

=== Native ===

:{{margin|20px 0|{{tt|AutoExecConfig(bool:{{h:title||autoCreate}} <nowiki>=</nowiki> true, const {{h:title||name}}[] <nowiki>=</nowiki> "", const {{h:title||folder}}[] <nowiki>=</nowiki> "")|opt=large}}}}

:Spécifie que le fichier de configuration donné doit être executé après le chargement du plugin.

:{|
|-
| {{tt|autoCreate}} || {{ns}} Si activé ({{tt|true|opt=nobg}}), AMX Mod X va extraire toutes les cvars créées par le plugin dans un fichier de configuration, si ce fichier n'existe pas.
|-
| {{tt|name}}       || {{ns}} (''Facultatif'') Nom du fichier de configuration (sans l'extension {{tt|.cfg|opt=nobg}}). Si l'argument est vide, auquel cas le nom du plugin sera utilisé, avec le suffixe {{tt|plugin-|opt=nobg}}.  Par exemple, {{tt|hat.amxx|opt=nobg}} devient {{tt|plugin-hat.cfg|opt=nobg}}.
|-
| {{tt|folder}}     || {{ns}} (''Facultatif'') Change le répertoire de destination dans le répertoire principale {{tt|/amxmodx/configs|opt=nobg}}. Par défaut, le fichier s'enregistre dans le répertoire {{tt|/amxmodx/configs/plugins|opt=nobg}}.
|}

:{{alert|info|Note:|C'est possible de créer des répertoires en cascade ; AMX Mod X essaiera de les créer un par un.|opt=full-border}}
:{{alert|info|Note:|Si vous avez de multiples appels de {{tt|AutoExecConfig|opt=nobg}} avec l'argument {{tt|autoCreate|opt=nobg}} sur vrai ({{tt|true|opt=nobg}}), le premier fichier qui sera créé empêchera les autres de l'être. En d'autres termes, il n'y a aucun moyen de répartir les cvars sur plusieurs fichiers.|opt=full-border}}

=== Forward ===

:{{margin|20px 0|{{tt|OnConfigsExecuted()|opt=large}}}}

:Appelé quand la map est chargé et que tous les fichiers de configurations ont finis d'être exécutés.
:Cela inclut {{tt|servercfgfile|opt=nobg}} ({{tt|server.cfg|opt=nobg}}), {{tt|amxx.cfg|opt=nobg}}, la configuration de plugins et la configuration par map.

:{{alert|info|Note:|C'est la place idéale pour initialiser les fonctions du plugin qui sont basées sur les données de cvar.|opt=full-border}}
:{{alert|info|Note:|Ce sera toujours appelé une et une seule fois par map, quelques secondes après {{tt|plugin_cfg()|opt=nobg}}.|opt=full-border}}

:{{margin|30px 0 20px 0|{{tt|OnAutoConfigsBuffered()|opt=large}}}}

:Appelé quand la map est chargé, juste après {{tt|plugin_cfg()|opt=nobg}} mais avant {{tt|OnConfigsExecuted()|opt=nobg}}.  
:C'est appelé après {{tt|amxx.cfg|opt=nobg}} et toutes les commandes exécutées de {{tt|AutoExecConfig|opt=nobg}} qui ont été ajoutées au cache des commandes serveur.
:{{alert|info|Note:|Ce sera toujours appelé une et une seule fois par map.|opt=full-border}}

== Exemple ==

<pawn>#include <amxmodx>

public plugin_init()
{
    register_plugin("Hat", "User", "1.0");
    
    create_cvar("mysqlk_database", "", .description = "Base de données MySQL");
    create_cvar("mysqlk_host", "localhost", .description = "Hôte MySQL, utiliser ceci pour configurer diverses choses^n pour votre serveur.");
    
    AutoExecConfig();
}</pawn>

Un aperçu du fichier de configuration généré serait :

<pawn>
// This file was auto-generated by AMX Mod X (v1.9)
// Cvars for plugin "Hat" by "User" (hat.amxx, v1.0)


// Base de données MySQL
// -
// Default: ""
mysqlk_database ""

// Hôte MySQL, utiliser ceci pour configurer diverses choses
// pour votre serveur
// -
// Default: "localhost"
mysqlk_host "localhost"
</pawn>

[[Category:Scripting_(AMX_Mod_X)]]