Programmes et scripts de Star Wars MUD FR¶

Scripter dans un MUD permet aux bâtisseurs de rajouter des fonctionnalités personnalisées à l'univers. Ces scripts, ou programmes (le terme est utilisé indifféremment dans ce document) sont reliés à des évènements précis, souvent déclenchés par les actions des joueurs.

Par exemple, on peut scripter un mobile de l'univers pour qu'il réagisse si un joueur dit quelque chose de précis dans la salle où il se trouve. Des quêtes relativement complexes, des zones un peu particulières, d'autres moyens de déplacement, tout ceci peut être scripté avec plus ou moins de temps. Ce document est fait pour servir de tutoriel au scripting sur Star Wars MUD FR, ainsi que d'index pour retrouver rapidement une fonctionnalité ou une syntaxe.

Index des commandes de scripting¶

Un programme peut ne contenir que des commandes. Ces commandes sont sous la forme que les joueurs connaissent, comme say ou emote, mais il y a des commandes particulières que seuls les mobiles, objes ou salles peuvent faire dans leur script.

Le tableau ci-dessous décrit la liste des commandes spécifiques au scripting. La première colonne contient le nom de la commande, la seconde sa syntaxe, la troisième une description très courte de son utilisation. Le nom de la commande est un lien, vous pouvez cliquer dessus pour avoir une explication plus détaillée, ainsi qu'un exemple de sa syntaxe.

Commande	Syntaxe	Utilité
mpadvance	mpadvance <nom du joueur> <niveau>	Change le niveau d'un joueur.
mpapply	mpapply <nom du joueur>	Passe un joueur en statut "non autorisé, en attente d'autorisation".
mpapplyb	mpapplyb <nom du joueur>	Passe un joueur en statut "autorisé à jouer dans l'univers réel".
mpecho	mpecho <phrase>	Affiche une phrase à la salle dans laquelle se trouve le mobile, objet.

Aide détaillée des commandes¶

mpadvance¶

Syntaxe : mpadvance <nom du joueur> <numéro du niveau>

Cette commande fait passer le joueur précisé à un niveau indiqué. Cette commande ne marchera pas si le programme est dans un mobile prototype.

Exemple d'utilisation :

mpadvance $n 3

mpapply¶

Syntaxe : mpapply <nom du joueur>

Cette commande passe un joueur en statut "non autorisé". Il devra être autorisé pour rentrer dans l'univers réel, ce qui peut se faire par script (voir mpapplyb) ou par la commande authorize.

Exemple d'utilisation :

mpapply $n

mpapplyb¶

Syntaxe : mpapplyb <nom du joueur>

Cette commande autorise un joueur, lui permettant d'entrer dans l'univers réel, au-delà de la zone de départ.

mpapplyb $n

mpecho¶

Syntaxe : mpecho <phrase>

Cette commande prend en argument une phrase, et affiche cette phrase dans la salle dans laquelle se trouve le programme (la salle du mobile, la salle de l'objet ou la salle-même, pour les programmes de salle). Le message est envoyé sans aucun préfixe, et le joueur n'a pas le moyen de savoir d'où vient le message.

Exemples d'utilisation :

mpecho La vitrine explose dans un vacarme infernal !
mpecho $n arrive de nullepart.

Voir aussi :

• mpechoat pour afficher un message dans une autre salle ;
• mpechoaround pour afficher un message pour la salle, à l'exception d'un joueur ;
• N'oubliez pas, vous pouvez utiliser les commandes say et emote pour faire dire à un mobile quelque chose, ou le faire agir. Ce sera plus clair qu'utiliser mpecho si c'est tout ce que vous voulez faire ;
• Cette commande est identique à la commande d'immortel recho que vous ne pouvez pas utiliser dans vos scripts.