• Introduction
  • Spécifications
  • Fonctionnalités
  • Scripts standard
  • Démarrage rapide
• Manuel
  • Commandes LFSLapper
    • !help
  • Fichiers de configurations
    • LFSServers.cfg
    • fichier ".ini"
    • Fichiers ".lpr"
      • Présentation
      • Variables de configurations
      • Evénements
  • GLScript
    • Les variables
    • Les tableaux
• Résultat

Fichier " .lpr "

Les fichiers .lpr sont des fichiers de configuration contenant des scripts, ce sont eux qui donnent la puissance à ce logiciel. En fait, vous pouvez à travers le langage simple de script GLScript créer un serveur LFS qui vous ressemble, ajouter de nouvelles fonctionnalités ou modifier celles qui existent. Le principal fichier de configuration fourni avec votre distribution est le suivant: LFSLapper.lpr

Contenu

Ce fichier contient les paramètres LFSLapper. Il contient des lignes de commentaires, des variables de configuration et des blocs de code GLScript et un ou plusieurs include ( "").

Lignes de commentaires

Toute ligne précédée par # est une ligne de commentaire. C'est une ligne affichée dans votre fichier de configuration, mais qui n'est pas fonctionnelle. Elle ne sert qu'à donner des informations supplémentaires à la personne qui lit le fichier ou de supprimer des portions de code de façon permanente ou temporaire

Variables de paramétrage

Les paramètres sont toujours précédés par le caractère '$', et suivi par un identificateur représenté par un ou plusieurs caractères. Le premier caractère de l'identificateur est toujours un caractère alphabétique suivi d'un ou plusieurs caractères alphabétiques ou numériques. Ces variables sont des paramètres prédéfinis et vous ne pouvez pas en ajouter de nouvelles.


Exemple de variable de configuration
Les variables sont suivies par le symbole '=' puis d'une valeur

Exemple

$DateFormat = "dd/MM/yyyy";
$MessageTime = 5000;

Comme vous pouvez voir les variables peuvent être de deux types: "chaîne entre guillemets" ou nombre.

Bloc de codes

Il existe quatre types de blocs de code que nous détaillerons plus tard. Ces blocs contiennent du code GLScript, c'est à dire une séquence d'action à réaliser.

Bloc Event....EndEvent

Ce type de bloc, contient les actions que LFSLapper exécute quand un événement se produit. Il ya beaucoup d'événements générés par votre serveur de LFS. Par exemple, une tour de circuit est un événement, un arrêt dans le stand est un autre type, un message dans la fenêtre de chat est aussi un événement. De tels événements quand ils se présentent déclenchent du code GLScript contenu dans le bloc correspondant à l'événement

Exemple
Quand un joueur se connecte à votre serveur LFS. L'évènement OnConnect est déclenché et le code dans le bloc "Event OnConnect ($ userName)" s'exécute.

Event OnConnect( $userName ) # Player event
        privMsg( "Hello " . $userName );
EndEvent

Ce bloc, qui dans cet exemple est très simple, affiche dans le chat LFS "Hello, gai-luron" si c'est le joueur Gai-Luron qui se connecte.

Redéfinir un autre bloc avec le même nom remplace le bloc défini précédemment.

Bloc Sub....EndSub

Ce sont des blocs de code qui peuvent être appelés par d'autres blocs de code, ou suite à un clic d'un bouton dans LFS, suite à une demande de commande ou d'action retardée enregistrée. Nous allons voir en détail la puissance de ce mode de fonctionnement plus tard.
Exemple

Sub speedTrap()
        PrivMsg( "Your speed is " , 
                ToPlayerUnit( GetCurrentPlayerVar( "InstantSpeed" ) ),
                GetCurrentPlayerVar("UnitSpeed") ));
EndSub

Redéfinir un autre bloc avec le même nom remplace le bloc défini précédemment.

Bloc CatchEvent....EndCatchEvent

Ce sont des blocs de code contenant du code GLScript qui s'exécute à la suite de l'événement principal.

Exemple
Main Event

Event OnConnect( $userName ) # Player event
        privMsg( "Hello " . $userName );
EndEvent

Secondary Event

CatchEvent OnConnect( $userName ) # Player event
        Code GLScript
EndCatchEvent

Quand un joueur se connecte, LFSLapper exécute le bloc LFSLapper OnConnect , puis l'un après l'autre, tous les blocs CatchEvent OnConnect contenus dans vos fichiers. "Lpr"

Redéfinir un nouveau block catchEvent avec le même nom ajoute un nouveau bloc de code à exécuter après le bloc principal.

Bloc CatchSub....EndCatchSub

Ce bloc est similaire à CatchEvent, mais s'applique à Sub ... EndSub

Redéfinir un nouveau block catchSub avec le même nom ajoute un nouveau bloc de code à exécuter après le bloc principal.

Commande include

La fonction include permet d'ajouter du code d'un autre fichier de configuration dans le fichier contenant cette commande. Cela évite d'avoir un trop gros fichier de configuration. Vous pouvez séparer votre code dans des fichiers plus petits, qui peuvent avoir chacuns des fonctionnalités différentes. Vous pouvez inclure autant de fichiers que vous le souhaitez.

Example

include( "./includes/pitboard.lpr");

Inclusion du fichier d'affichage de pitboard à votre fichier principal

include( "./includes/guiconfig.lpr");

Inclusion du fichier de configuration graphique à votre fichier principal

Ajouter de nouvelles fonctionnalités à LFSLapper est aussi simple que cela, si un utilisateur crée une nouvelle fonctionnalité et fournit à la communauté de LFS le fichier script, il suffit d'inclure le fichier .lpr pour qu'il soit opérationnel pour vous.