Document

h1. 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.

h2. 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]] | @mpadvance <nom du joueur> <niveau>@ | Change le niveau d'un joueur. |

| [[#mpapply|mpapply]] | @mpapply <nom du joueur>@ | Passe un joueur en statut "non autorisé, en attente d'autorisation". |

| [[#mpapplyb|mpapplyb]] | @mpapplyb <nom du joueur>@ | Passe un joueur en statut "autorisé à jouer dans l'univers réel". |

| [[#mpasound|mpasound]] | @mpasound <phrase>@ | Envoie un message dans les salles alentour. |

| [[#mpat|mpat]] | @mpat <vnum de la salle> <commande>@ | Exécute la commande dans la salle indiquée. |

| [[#mpdamage|mpdamage]] | @mpdamage <victime> <montant>@ | Inflige des dégâts à la victime. |

| [[#mpdeposit|mpdeposit]] | @mpdeposit <montant>@ | Dépose de l'argent dans la zone du script |

| [[#mpdream|mpdream]] | @mpdream <victime> <phrase>@ | Envoie un message à un joueur qui dort. |

| [[#mpecho|mpecho]] | @mpecho <phrase>@ | Affiche une phrase à la salle dans laquelle se trouve le mobile, objet. |

| [[#mpechoaround|mpecharound]] | @mpechoaround <nom> <phrase>@ | Envoie un message à la salle, SAUF au joueur précisé. |

| [[#mpechoat|mpechoat]] | @mpechoat <nom> <phrase>@ | Envoie un message uniquement à un joueur. |

| [[#mpforce|mpforce]] | @mpforce <victime/all> <commande>@ | Force la victime (ou tous ceux présents dans la salle) à faire une commande. |

| [[#mpgain|mpgain]] | @mpgain <victime> <niveau> <nombre>@ | Donne de l'XP à la victime dans le niveau indiqué (le niveau est un nombre). |

| [[#mpgoto|mpgoto]] | @mpgoto <vnum de salle>@ | Téléporte le mobile du script dans une salle quelconque. |

| [[#mpinvis|mpinvis]] | @mpinvis (niveau)@ | Rend le mobile du script invisible. |

| [[#mpjunk|mpjunk]] | @mpjunk <objets>@ | Détruit un ou plusieurs objets. |

| [[#mpkill|mpkill]] | @mpkill <victime> | Tue un joueur sans utiliser murder. |

| [[#mpmload|mpmload]] | @mpmload <vnum du mobile>@ | Charge un mobile. |

| [[#mpnothing|mpnothing]] | @mpnothing@ | Cette commande ne fait strictement rien (utile pour les conditions vides). |

| [[#mpoload|mpoload]] | @mpoload <vnum de l'objet>@ | Fait apparaître un objet. |

h2. Aide détaillée des commandes

h3. 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 :

<pre>

mpadvance $n 3

</pre>

h3. 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|mpapplyb]]) ou par la commande *authorize*.

Exemple d'utilisation :

<pre>

mpapply $n

</pre>

h3. 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.

<pre>

mpapplyb $n

</pre>

h2. mpasound

Syntaxe : @mpasound <phrase>@

Envoie la phrase passée en paramètre aux salles autour de la salle du programme (la salle dans laquelle se trouve le mobile ou objet, par exemple).

Exemple d'utilisation :

<pre>

mpasound Il commence à faire froid...

</pre>

h3. mpat

Syntaxe : @mpat <vnum de la salle> <commande>@

Cette commande permet d'exécuter une autre commande dans une salle différente. C'est l'équivalent de la commande *at* que les immortels peuvent utiliser : elle peut permettre à un mobile d'exécuter une commande dans une salle distante sans avoir à se déplacer.

Exemple d'utilisation :

<pre>

mpat 2200 drop all

</pre>

(Cette commande, si exécuté dans un programme de mobile, demandra au dit mobile de poser tous eses objets dans la salle de vnum 2200, et ceci sans quitter la salle où il se trouve.

*note importante*: on utilise souvent @mpat@ pour "cacher" certaines actions au joueur. Par exemple, on demande au mobile d'aller dans une salle fermée au joueur pour exécuter des commandes sans que le joueur ne le voit. Il existe cependant la commande [[#silence|silence]] qui reste plus lisible.

h3. mpdamage

Syntaxe : @mpdamage <victime> <montant>@

Cette commande permet d'infliger des dégâts à la victime précisée en premier argument. L'aide iindique que ces dégâts seront influencés par le sanctuaire, mais pas la protection, saving throws ou résistances.

Exemple d'utilisation :

<pre>

mpdamage $n 200

</pre>

Il semble que, si le programme inflige des dég6ats au mobile acteur du programme, et si le nombre de dégâts est suffisamment important pour le tuer, le programme fera planter le MUD.

h3. mpdeposit

Syntaxe : @mpdeposit <montant>@

Cette commande permet de déposer de l'argent dans la zone où se trouve le script (la zone de la salle, du mobile ou de l'objet). Elle prend en unique paramètre le montant à déposer dans la zone. Chaque zone a sa propre économie, et les programmes peuvent être utilisés pour influer sur l'économie de zone (par exemple, donner moins d'argent si la zone a moins dans son trésor).

Exemple d'utilisation :

<pre>

mpdeposit 5000

</pre>

Parmi la plupart des commandes utilisées avec [[#mpat|mpat]], ce..e-ci est peut-être l'une des plus fréquentes. On peut déposer ou retirer de l'argent facilement dans une autre zone :

<pre>

mpat 3311 mpdeposit 5000

</pre>

Voir aussi :

* [[mpwithdraw|mpdwithdraw]] pour retirer de l'argent de la zone actuelle.

h3. mpdream

Syntaxe : @mpdream <victime> <phrase>@

Cette commande envoie un message à un joueur ou mob qui dort. Par défaut, si on utilise [[#mpecho|mpecho]] o]] par exemple, un joueur qui dort ne voit pas le message. @mpdream@ permet d'envoyer spécifiquement un message à un joueur qui dort.

h3. 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 :

<pre>

mpecho La vitrine explose dans un vacarme infernal !

mpecho $n arrive de nullepart.

</pre>

Voir aussi :

* [[#mpechoat|mpechoat]] pour afficher un message uniquement à un joueur ;

* [[#mpechoaround|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 programmes.

h3. mpechoaround

Syntaxe : @mpechoaround <nom> <phrase>@

Cette commande permet d'envoyer un message à la salle du programme, comme [[#mpecho|mpecho]], mais elle permet de ne pas envoyer le message à un joueur précisé en premier paramètre. En combinant [[#mpechoat|mpechoat]] et [[#mpechoaround|mpechoaround]], on peut faire des messages d'ambiance assez personnalisés.

Exemple d'utilisation :

<pre>

mpdamage $n 30

mpechoat $n Vous recevez une fléchette dans la peau, sans doute empoisonnée !

mpechoaround $n $n reçoit une fléchette dans la peau, sans doute empoisonnée !

</pre>

Explications :

# La première ligne inflige 30 de dégâts à @$n@, c'est-à-dire l'acteur du script appelé ;

# La ligne 2 envoie le message seulement à @$n@ ;

# La ligne 3 envoie un message à toute la salle, sauf à @$n@.

h3. mpechoat

Syntaxe : @mpechoat <nom> <phrase>@

Envoie un message uniquement à la cible passée en premier paramètre. Cette commande peut être utile avec [[#mpechoaround|mpechoaround]] (voir [[#mpechoaround|mpechoaround]] pour un exemple).

Exemple d'utilisation :

<pre>

mpechoat $n Le jour se lève.

</pre>

h3. mpforce

Syntaxe : @mpforce <victime/all> <commande>@

Force une victime à faire une commande. Si le premier paramètre est @all@, force tous ceux présents dans la salle du script à faire la commande.

Exemples d'utilisation :

<pre>

mpforce $n remove blaster

mpforce all drop 5000 credit

</pre>

On peut aussi le faire silencieusement, comme toute commande de programme :

<pre>

silent mpforce $n remove all

</pre>

h3. mpgain

Syntaxe : @mpgain <victime> <niveau> <nombre>@

Donne de l'XP à une victime dans le niveau indiqué. Le niveau est à préciser sous la forme d'un nombre entre 0 et 7 (voir le tableau ci-dessous).

| Nombre | Niveau |

| 0 | Combat |

| 1 | Pilotage |

| 2 | Ingénierie |

| 3 | Chasseur de primes |

| 4 | Contrebande |

| 5 | Diplomatie |

| 6 | Commandement |

| 7 | Force |

Exemple d'utilisation :

<pre>

pmgain $n 1 50000

</pre>

Cet exemple donne 50.000 XP à $n dans le niveau pilotage.

h3. mpgoto

Syntaxe : @mpgoto <vnum de la salle<@

Cette commande permet de téléporter le mobile du script dans la salle dont le vnum est passé en paramètre. Cette commande ne marchera pas si la salle dans laquelle on souhaite se déplacer est privée.

h3. mpinvis

Syntaxe : @mpinvis (niveau)@

Cette commande demande au mobile du programme de devenir invisible. On peut passer en paramètre optionnel le niveau qu'il faut avoir pour voir ce mobile. Les mobiles ou joueurs d'un niveau inférieur à celui précisé ne verront pas ce mobile. Si le mobile invisible fait une action visible aux joueurs, ils verront simplement "someone"(quelqu'un) faisant l'action.

La documentation indique qu'une attaque de zone n'inclut pas les mobiles invisibles.

Exemple d'utilisation :

<pre>

mpinvis

mpinvis 3

</pre>

*Note* : utilisez cette commande une nouvelle fois pour lever le flag d'invisibilité du mobile.

h3. mpjunk

Syntaxe : @mpjunk <objets>@

Détruit un ou plusieurs objets dans l'inventaire ou portés par le mobile. Cette commande attend en argument le nom de l'objet. Dans ce cas, détruit un objet. On peut aussi utiliser la syntaxe @all.@ devant le nom de l'objet, pour détruire tous les objets de ce nom dans l'inventaire/l'équipement du mobile.

<pre>

mpjunk clef

mpjunk all.credits

</pre>

h3. mpkill

Syntaxe : @mpkill <victime>@

Cette commande permet de demander au mobile d'attaquer la victime indiquée.

Exemple d'utilisation :

<pre>

mpkill $n

</pre>

h3. mpmload

Syntaxe : @mpmload <vnum du mobile>@

Cette commande charge un mobile. Elle permet donc de faire apparaître un mobile dans la salle où vous vous trouvez. Il peut être utile de l'utiliser avec [[#mpat|mpat]] pour faire apparaître un mobile dans une salle distante:

Exemple d'utilisation :

<pre>

mpmload 500

mpat 230 mpmload 512

</pre>

h3. mpnothing

Syntaxe : @mpnothing@

Cette commande ne fait rien du tout. Elle semble assez inutile au premier abord. En vérité, sa seule utilité est pour les conditions vides : une condition (définie par @if@ ou @else@) ne peut être vide, c'est une limite de la syntaxe. Le @mpnothing@ permet de faire des conditions contraires. L'exemple ci-dessous affiche un message si $n n'est pas un wookiee.

Exemple d'utilisation :

<pre>

if race($n) == wookiee:

mpnothing

else

say Tu n'est pas un Wookiee, tant mieux !

endif

</pre>

Notez cependant que, dans le cas ci-dessus, on a surchargé la syntaxe inutilement. On aurait pu faire comme ceci (et ça aurait été bien plus lisible) :

if race($n) != wookiee:

say Tu n'est pas un Wookiee, tant mieux !

endif

</pre>

Il est possible que @mpnothing@ ait été inventé avant cette liberté dans la syntaxe des conditions contraires. Mais @mpnothing@ peut encore être utile pour les conditions vides imbriquées.

h3. mpoload

Syntaxe : @mpoload <vnum de l'objet>@

Cette commande permet de faire apparaître un objet de vnum indiqué dans l'inventaire du mobile faisant la commande.

Exemple d'utilisation :

<pre>

mpoload 20000

</pre>