AutoConfigs (AMX Mod X Scripting)/fr

Language:	English  • français

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 AutoExecConfig dans scripting/include/amxmodx.inc.

Une fois que tous les fichiers sont exécutés, le forward 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

AutoExecConfig(bool:autoCreate = true, const name[] = "", const folder[] = "")

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

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

Note:C'est possible de créer des répertoires en cascade ; AMX Mod X essaiera de les créer un par un.

Note:Si vous avez de multiples appels de AutoExecConfig avec l'argument autoCreate sur vrai (true), 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.

Forward

OnConfigsExecuted()

Appelé quand la map est chargé et que tous les fichiers de configurations ont finis d'être exécutés.

Cela inclut servercfgfile (server.cfg), amxx.cfg, la configuration de plugins et la configuration par map.

Note:C'est la place idéale pour initialiser les fonctions du plugin qui sont basées sur les données de cvar.

Note:Ce sera toujours appelé une et une seule fois par map, quelques secondes après plugin_cfg().

OnAutoConfigsBuffered()

Appelé quand la map est chargé, juste après plugin_cfg() mais avant OnConfigsExecuted().

C'est appelé après amxx.cfg et toutes les commandes exécutées de AutoExecConfig qui ont été ajoutées au cache des commandes serveur.

Note:Ce sera toujours appelé une et une seule fois par map.

Exemple

#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();
}

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

// 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"