Apprendre le pawn avec Gilux

From SA-MP Wiki

Jump to: navigation, search

Contents

Apprenons le Pawn avec Gilux !

Je vais commencer en douceur, avec les bases du langage...

Partie 1: Les bases

Introduction

Si vous lisez ce tutoriel, c'est que vous avez envie d'apprendre à coder en Pawn, et c'est un bon choix si vous débutez ! En effet, le pawn est un langage de programmation simple, mais puissant (quand il est maîtrisé toutefois)

Sont requis :

  • La patience, l'apprentissage complet du PAWN prend quelques mois si c'est votre premier langage de programmation, et les erreurs vont venir mettre un peu plus vos nerfs à bout  :D De plus, beaucoup de personnes veulent commencer un RP dès qu'ils apprennent, c'est la voie du suicide assurée ! (Bon allez encore passable si vous connaissez le C)
  • Une maîtrise de l'anglais correcte, en effet le langage est 100% en anglais (Pas besoin de doctorat en anglais quand même hein ^^)
  • De l'envie et de la persévérance, les bugs ne doivent pas vous rebuter...
  • GTA San Andreas version 1.0 (Au cas où...) En réalité vous n'avez pas réellement besoin de GTA pour réaliser vos scripts et pour les compiler, mais en revanche pour les tester il vous faudra aller sur SA:MP qui lui nécessite GTA:SA 1.0

Sans plus attendre, débutons le tutoriel. (Je partirai du principe que vous savez ouvrir vos ports si besoin, et les risques que cela entraîne (hack) et que vous savez configurer un serveur)

Découvrir Pawno

Je vais passer tout ce qui est configuration du serveur, vous trouverez sûrement comment configurer le serveur quelque part, ici je ne parlerai que de script.
Il va vous falloir ouvrir Pawno, livré avec l'archive de votre serveur
Vous découvrez l'interface de Pawno :
pawno10.jpg

En plus des boutons classiques "Nouveau" "Ouvrir" etc, il y a 2 boutons : captur10.png

Ils servent à compiler le script, car votre serveur ne fonctionnera pas avec les fichiers .pwn mais avec les fichiers .amx (Compilés)
C'est lors de cette compilation que le logiciel vous retournera des erreurs / avertissements si il doit en retourner.

Info : Pawno est ce qu'on appelle un IDE : Integrated Development Environment. En Français, cela se traduit par Environnement de développement.
Il contient l'éditeur de code, le compilateur, et le débuggeur qui vous retournera les erreurs. Il vous évite donc d'éditer le texte et d'avoir à utiliser un autre logiciel pour compiler.

Cliquez sur "New", un code s'affichera (Comme sur le screen)
C'est la structure de base d'un code, Nous allons l'aborder plus précisément dans le prochain chapitre.

La structure d'un code

Un code a plusieurs parties, nous allons les voir ici.

Les directives de précompilation
Voici quelques exemples :

#include <a_samp>
#include <include_basique>
#define COULEUR_ROUGE 0xFF0000FF
#define GivePlayerWeapon(%0,%1,%2); GiveWeaponToPlayer(%0,%1,%2);

Ces lignes sont en haut de votre script, et sont introduites par un dièse.
Elles permettent d'inclure des includes (fichiers contenant des fonctions supplémentaires), de substituer une fonction par une autre, etc etc.

La fonction main
main()
{
    print("\n----------------------------------");
    print(" Gilux's GM");
    print("----------------------------------\n");
}

Cette fonction main est la fonction principale du script.
Elle permet juste de démarrer le serveur, il est inutile d'y toucher.

Les Callbacks

Les Callbacks sont des sortes d'évènements (OnPlayerConnect = Que faire à la connexion d'un joueur ?)
Elles se concluent toutes par un return 1; ou return 0; , Nous verrons cela plus en détail par la suite.

Les commentaires

C'est pas tellement une partie de code, mais c'est tellement utile que je vais en parler ici.
Un commentaire est une note que vous pouvez laisser, mais qui ne sera pas prise en compte dans la compilation.
C'est donc utile pour noter des crédits, des choses à faire, etc.
Un commentaire sur une ligne se commence comme cela : // et votre texte sur la ligne deviendra tout vert !
Si vous voulez mettre un commentaire sur plusieurs lignes, il faut le commencer comme cela :

/*

Et tout
Votre
Texte mis en commentaire deviendra vert !

*/

Vous l'avez remarqué, un commentaire multiligne se termine comme ça : */

Votre première instruction

Avant de commencer à scripter, il faut que je vous explique la différence entre un GameMode (GM) et FilterScript (FS) (Et include en même temps tiens !)

Un GM, c'est le script principal de votre serveur, alors qu'un FS est un script additionnel qui peut être chargé / déchargé à tout instant.
Quand j'ai un test dont je ne suis pas sûr, je le met en FS pour le tester, après je le met en GM si il marche.

Une include est un fichier avec l'extension .inc qui permet d'ajouter des fonctions au serveur.

Rappel : Les FS s'ajoutent au server.cfg sur la ligne filterscripts ! Vous pouvez aussi les charger / décharger IG avec la commande /rcon loadfs [Nom] et /rcon unloadfs [Nom]

Si vous voulez faire un GM, laissez tel quel ou utilisez ce début de code (Supprimez les #define, #if defined, OnFilterScriptInit et Exit qui correspondent aux initialisations et déchargement de FS, ce qui ne nous servira pas) :

#include <a_samp>
 
 
main()
{
    print("\n----------------------------------");
    print(" Gilux's GM");
    print("----------------------------------\n");
}
 
 
public OnGameModeInit()
{
    // Don't use these lines if it's a filterscript
    SetGameModeText("Blank Script");
    AddPlayerClass(0, 1958.3783, 1343.1572, 15.3746, 269.1425, 0, 0, 0, 0, 0, 0);
    return 1;
}
 
public OnGameModeExit()
{
    return 1;
}

(On se débarasse des conditions inutiles)

Nous allons commencer par un GM, histoire de pas trop nous embrouiller ^^

Que diriez-vous de créer une commande /handsup, qui permettra au joueur de se retrouver les mains en l'air ?

Pour cela, vous devez trouver la callback "OnPlayerCommandText" => Callback appelée quand un joueur tape une commande (/commande)

NOTE : Je m'habituerai à mettre des flèches orange autour des Callbacks et des instructions pour vous en donner le sens.

Voici le code à copier dans la callback (Entre les accolades d'ouverture et de fermeture)

if(strcmp(cmdtext, "/handsup", true) == 0)
{
    SetPlayerSpecialAction(playerid,SPECIAL_ACTION_HANDSUP);
    return 1;
}

En voici une autre, qui donnera une bouteille de bière au joueur :

if(strcmp(cmdtext, "/beer", true) == 0)
{
    SetPlayerSpecialAction(playerid,SPECIAL_ACTION_DRINK_BEER);
    return 1;
}

Ce qui donne au final :

public OnPlayerCommandText(playerid, cmdtext[]) // La callback
{ // On ouvre la callback 
if(strcmp(cmdtext, "/handsup", true) == 0) // On compare la commande et la chaîne de caractères /handsup
    { // Si la commande est /handsup, on ouvre une condition
    SetPlayerSpecialAction(playerid,SPECIAL_ACTION_HANDSUP); // On utilise une instruction
    return 1; // On retourne 1 au compilateur, ce qui veut dire que l'action a été effectuée sans problèmes.
    } // On ferme la condition car elle est finie
if(strcmp(cmdtext, "/beer", true) == 0) // Si le joueur n'a pas tapé /handsup, on va vérifier si la commande est "/beer", sinon on ne procèdera pas à la vérification et on sortira de la "boucle" 
    { // On ouvre les accolades si la commande est correcte, sinon on retourne 0 (commande invalide)
    SetPlayerSpecialAction(playerid,SPECIAL_ACTION_DRINK_BEER); // On donne une bouteille au joueur (instruction)
    return 1; // On retourne 1, le boulot est fait, et on sort de la "boucle"
    } // on ferme la condition
return 0; // On retourne 0 si la commande tapée ne correspond à aucune commande listée.
} // On referme la callback

Dans ce code, on va comparer la commande à plusieurs "propositions" : La 1ère étant "Si le joueur a tapé /handsup". C'est une condition (Je vous en reparlerai plus précisément dans une prochaine partie du tutoriel). Si la condition est fausse, on passe à la suivante, etc. jusqu'à ce qu'on arrive au return 0; , ce qui signifiera que la commande ne correspond à rien (Le joueur aura un SERVER:UNKNOWN COMMAND qui s'affichera)

Dans les commentaires, j'ai parlé de "boucle". Ce terme n'est pas très approprié car il existe les "vraies" boucles qui n'ont pas du tout ce sens (quoique...) Bref, nous verrons les boucles plus tard ^^
Compilez le code, et lancez le serveur : Connectez-vous et tapez /beer et /handsup, cela devrait marcher sans problème si le compilateur n'a pas renvoyé d'erreur.
N'oubliez pas de sauvegarder le script dans "Gamemodes" et non dans "filterscripts" bien entendu ::)

Je vais maintenant revenir sur les instructions : Qu'est-ce qui caractérise une instruction ?
Une instruction (Ou fonction) effectue une action, les instructions se chiffrent à un peu plus de 200 avec l'include a_samp.
UNE INSTRUCTION SE TERMINE TOUJOURS PAR ";" (A ne pas oublier !)
Une instruction reçoit des paramètres, donc on peut constater ici qu'elle en a reçu 2 : playerid et SPECIAL_ACTION_HANDSUP
Et maintenant, je vous donne un petit lien vers la page du wiki samp consacrée à cette instruction : SetPlayerSpecialAction
On voit 2 paramètres : playerid (Ce paramètre on a pas besoin d'y toucher, il définit tout simplement l'ID du joueur qui a tapé la commande, et par conséquent, à qui va être affectée l'action, et actionid (en cliquant sur le lien vous trouverez différentes actions, comme sortir un portable, etc etc)
Vous pouvez donc commencer à créer des commandes avec les différentes instructions (Elles sont presque toutes disponibles ici: )
Mais avant, nous allons voir comment envoyer du texte au joueur ("client")
C'est THE instruction à retenir, elle s'appelle : SendClientMessage(playerid,color,text);

Les paramètres montrent : playerid (comme j'ai dit plus haut on touche pas), color ( la couleur en héxadécimal, utilisez SA:MP Color Picker) et le texte à afficher au joueur.

Essayons une commande :

if(strcmp(cmdtext, "/bonjour", true) == 0)
    { 
    SendClientMessage(playerid,0x00FFFFFF,Au revoir !);
    return 1;
    }

Votre compilateur devrait vous renvoyer :
Undefined symbol "Au"
Undefined symbol "Revoir"

Ce qui veut dire en gros, que Au et Revoir ne sont ni des instructions, ni des variables...
Pour résoudre ce problème, il faut savoir que Au revoir est une chaine de caractères (phrase pour les incultes, string pour les anglophones)

Et toute chaine de caractères doit être entourée de guillemets doubles !

Reprenons le code :

if(strcmp(cmdtext, "/bonjour", true) == 0)
    { 
    SendClientMessage(playerid,0x00FFFFFF,"Au revoir !");
    return 1;
    }

Cela marchera sans problème !

Conclusion

Ainsi se termine ce 1er tutoriel qui, je pense, aidera beaucoup de monde pour débuter.
J'ai volontairement omis la configuration (server.cfg) pour la raison que des tutos existent déjà à ce propos (Tapez créer son serveur SA:MP sur Google)
Vous pouvez aussi, par exemple, à la mort d'un joueur (OnPlayerDeath) lui retirer de l'argent (GivePlayerMoney) et lui afficher un message !
Ou vous pouvez créer des commandes pour vous remettre la vie au maximum (SetPlayerHealth) et de l'armure tant qu'on y est ! (SetPlayerArmour)

++ et bon script à tous !

Partie 2 :Structures utiles

Salut, et bienvenue dans la 2e partie de mon tutoriel PAWN.
Dans le 1er tuto, vous avez pu voir comment bien débuter en scripting, et créer vos premières commandes.

Maintenant, nous allons voir comment gérer les structures avancées

Les variables

Une variable est une information (32 bits) qui va aller se loger dans la mémoire vive de votre machine. Elle permet de contenir une information comme le nom du joueur, la couleur de son pseudo et bien d'autres choses.
Il existe 2 catégories de variables : Les variables globales et les variables locales
Contrairement à une variable locale qui fonctionne uniquement entre les accolades où elle est placée, une variable globale sera utilisé dans tout le script, elle pourra être modifiée dans tous les callbacks.
Une variable se déclare avec le terme new, qui peut être complété par un des tags suivants, en fonction du type de variable qu'il doit retenir :

  • bool : Booléen
  • Float: Nombre à virgule
  • File : Fichier
  • text : Textdraw
  • Menu : Menu

(Il n'est pas obligé d'en mettre)

new Float:PositionX;
new Menu:tuning;
new File:Listeban;

J'ai donc ici créé 3 variables, la 1ère stockera un nombre à virgule, le second un menu, et le dernier un fichier.
Note : Ne pas oublier le ; !

On peut aussi déclarer une variable comme ça :

new vie = 40;

(Donner une valeur à la variable dès sa déclaration)

new vie, armure, argent;

(Déclarer plusieurs variables d'un seul coup (Mais on ne peut pas leur attribuer de valeur)

Modifier une variable

Si dans votre script, vous avez le besoin de modifier une variable, voici la syntaxe :

MaVariable = 10;

Des variables spéciales : Les arrays

Les tableaux simples

Les arrays sont des tableaux de variables. Ils vous permettent de stocker des variables sans être obligé d'en créer un nombre énorme.
Dans un tableau, une valeur est associée à un index. Cet index commence toujours à 0. C'est à dire qu'un tableau avec 25 index se terminera par l'index 24.

Si cela vous est flou, voici une représentation de ces tableaux :
arrays10.png
Pour créer un array, on procède de la même manière qu'une variable, c'est à dire avec new. Voici comment créer le tableau ci-dessus :

new monTableau[8];

Ce code va faire (à peu près) la même chose en une ligne que ceci :

new var0;
new var1;
new var2;
new var3;
new var4;
new var5;
new var6;
new var7;

Pour assigner une variable à un index particulier du tableau, on procède comme ceci :

nomDuTableau[index] = valeur;

Ainsi, pour modifier la case avec l'index 4, qui est donc la 5e case, on fera :

nomDuTableau[4] = valeur;

Les chaînes de caractères sont aussi des arrays ! Chaque caractère occupe une case. Si l'on veut stocker le mot "Salut !" dans un tableau, il faudra 7 cases (5 lettres, 1 symbole et 1 espace) + 1 pour le nullbyte (\0) qui termine la chaîne de caractères.
Il faut donc déclarer un tableau de 8 cases.

new string[8] = "Salut !"; // 
printf("Valeur de la 5e case (Et donc l'index 4) de mon tableau : %c",monTableau[4]); // La fonction printf envoie un texte formaté dans la console : Il peut changer en fonction de la valeur d'une variable. Ici, %c représente un caractère.

Ici, la console affichera : Valeur de la 5e case (Et donc l'index 4) de mon tableau : t
Il existe d'autres symboles pour printf : %i pour un entier, %s pour une chaîne entière, et %f pour un flottant.

Nous allons maintenant apprendre à utiliser ces variables, avec l'ajout de conditions.

Les conditions

Les conditions vont permettre d'adapter le script en fonction de certains paramètres donnés.

if

La condition basique est introduite avec le mot-clé "if" qui signifie "si", et "else" qui signifie "sinon".
Voici un bout de code :

if(GetPlayerMoney(playerid) >= 25000)
{
SendClientMessage(playerid,0xFFFFFF,"Tu as beaucoup d'argent !");
}
else
{
SendClientMessage(playerid,0xFFFFFF,"Tu es pauvre toi :p");
}

(Ce code dira "Tu as beaucoup d'argent !" si le joueur à plus de 25000 $)

Donc on peut remarquer que :

  • Toute ce qui suit une condition doit être entre accolades
  • Une condition ne prend jamais de point-virgule
  • Si la 1ère condition n'est pas remplie, on fait ce qui correspond à "else"
  • On utilise des signes comme >=
Ces signes sont des opérateurs, en voici une liste
Signe Signification

==

Egal à

!=

Différent de

>

Strictement plus grand que

<

Strictement plus petit que

>=

Plus grand ou égal à

<=

Plus petit ou égal à

Cette structure à un défaut : elle ne permet que de tester qu'une condition, mais cela va être corrigé maintenant :


else if

"else if" signifie "sinon, si". Si une première condition n'est pas validée, on va continuer et chercher si la 2e est vraie, etc.... jusqu'au "else" final si aucune condition n'est validée.

Voici un exemple commenté :

if(GetPlayerMoney(playerid) >= 25000) // Si le joueur possède plus de 25 000 $
{
SendClientMessage(playerid,0xFFFFFF,"Tu as beaucoup d'argent !"); // On envoie le message et le script ignorera les conditions suivantes.
}
else if (GetPlayerMoney(playerid) >= 10000) // Si il ne possède pas plus de 25 000$, mais si il en possède plus de 10 000
{
SendClientMessage(playerid,0xFFFFFF,"C'est pas encore ça, mais tu as de quoi vivre ;)"); // Même chose, on envoie le message et on continue
}
else // Si il possède moins de 10000
{
SendClientMessage(playerid,0xFFFFFF,"Tu es pauvre toi :p"); // Si les 2 premières conditions sont fausses (Il n'a pas plus de 25000, ni plus de 10000), on envoie ce message.
}

Les conditions multiples

Il peut vous arriver de vouloir tester 2 ou plusieurs conditions ensemble.

Pour cela, il existe 2 signes : && et || (Alt Gr + 6). Le 1er signifie "ET" et le second signifie "OU"
Exemple:

if (GetPlayerMoney(playerid) >= 25000) && GetPlayerScore(playerid) >= 100)

signifiera "Si le joueur a 25000$ ou plus ET si il a 100 points ou plus"
alors que:

if (GetPlayerMoney(playerid) >= 25000) || GetPlayerScore(playerid) >= 100)

signifiera "Si le joueur a 25000$ ou plus OU si il a 100 points ou plus"

Inverse

Il existe un symbole pour indiquer l'inverse : ce symbole est "!"
Exemple :

if (!GetPlayerMoney(playerid) > 25000)

Revient à dire : "Si le joueur n'a pas plus de 25000 $" et équivaut à : if (GetPlayerMoney(playerid) < 25000)


Retour direct

Pourquoi garder 3 lignes alors qu'on peut en utiliser qu'une ?

En effet,

if (!IsPlayerAdmin(playerid)) // Si le joueur n'EST PAS admin
{
SendClientMessage(playerid,color,"Cette commande est réservée aux admins !");
}

Peut s'écrire :

if (!IsPlayerAdmin(playerid)) return SendClientMessage(playerid,color,"Cette commande est réservée aux admins !");

Tout se joue après le return, vous pouvez utiliser la même chose pour varier du SERVER:UNKNOWN COMMAND.
Dans OnPlayerCommandText, remplacez "return 0;" par "return SendClientMessage(playerid,color,"Cette commande est réservée aux admins !");"
Cela remplacera le message pas beau à voir

Passons à la suite, les boucles !

Les boucles

Les boucles permettent de faire automatiquement des actions répétitives.
Ainsi, si vous voulez vous faire flooder pour le fun, au lieu de taper ceci :

if(strcmp(cmdtext, "/floodemoi", true) == 0)
{
    SendClientMessage(playerid,0xFFFFFFFF, "Haha je te flood !!!");
    SendClientMessage(playerid,0xFFFFFFFF, "Haha je te flood !!!"); 
    SendClientMessage(playerid,0xFFFFFFFF, "Haha je te flood !!!"); 
    SendClientMessage(playerid,0xFFFFFFFF, "Haha je te flood !!!");
    SendClientMessage(playerid,0xFFFFFFFF, "Haha je te flood !!!");
    SendClientMessage(playerid,0xFFFFFFFF, "Haha je te flood !!!");
 
// Et ceci 50 fois...
    return 1;
}

Il existe des boucles, qui tourneront tant qu'une condition sera vraie.

Nous allons commencer avec "While", la plus basique.

While

La boucle While reçoit un paramètre, c'est une condition. Tant que celle-ci sera vraie, la boucle tournera indéfiniment.

Voici un code qui fait la même chose que la commande précédente.

new Flood;
if(strcmp(cmdtext, "/floodemoi", true) == 0)
{
while(Flood < 200)
{
    SendClientMessage(playerid,0xFFFFFFFF,"Haha je te flood !!!");
    Flood++;
}
}

Je résume : Tant que "Flood" sera inférieur à 200, on envoie un message au joueur, et on incrémente Flood (Très important, sinon la boucle tournera indéfiniment, faisant crasher votre serveur)

Do.....While

Il existe une autre forme de boucle : do.....while. Celle-ci, contrairement à while, effectuera une fois l'action, même si la condition est fausse !. La syntaxe est quasiment identique, excepté une petite différence : la condition se met sous la boucle.

Exemple :

new test = 10; // On crée une variable et on lui met 10 comme valeur.
do // Initialisation de la boucle
{
        test++; // Incrémentation de la variable
        print("Boucle Do...while effectuee"); // Envoie un message dans la console du serveur.
}
while (test < 10); // Tant que test est plus petit que 10

Dans ce premier code, on crée une variable égale à 10.
La condition à beau être fausse (10 n'est pas plus petit que 10), l'action sera effectuée une fois, la variable vaudra 11, et on sortira de cette boucle.

Maintenant, nous allons décrémenter la variable.

new test = 10; // On crée une variable et on lui met 10 comme valeur.
do // Initialisation de la boucle
{
        test--; // Incrémentation de la variable
        print("Boucle Do...while effectuee"); // Envoie un message dans la console du serveur.
}
while (test < 10); // Tant que test est plus petit que 10

La condition à l'entrée de la boucle est fausse, cependant elle sera effectuée une fois, et la variable sera décrémentée (-1)
La condition deviendra vraie (9 < 10) et la boucle continuera indéfiniment jusqu'à l'irrémédiable crash !

For

For fait la même action que While, mais elle regroupe la création de la variable, la condition et l'incrémentation directement.
Exemple :

for (new player = 0; player <= MAX_PLAYERS; player++) // Ligne où tout se passe, je vais la décrire après
{
        GivePlayerMoney(player,20000); // Attention ! Remplacer "playerid" par le nom de votre variable !
}

Ce code donnera 20000$ à tous les joueurs connectés.

Revoyons la 1ère ligne :

new player = 0;
Déclaration de la variable.
player <= MAX_PLAYERS
La condition (MAX_PLAYERS est une valeur automatique, elle signifie "L'ID le plus grand d'un joueur" : Cela revient à dire : Tant que tous les joueurs ne se sont pas servis ^^)
player++
L'incrémentation de la variable.

A vous de voir quelle boucle vous souhaitez utiliser, sachant qu'elles sont quasiment identiques, "for" prend juste moins de place :)

Conclusion

Voila, c'est la fin de cette 2e partie !
Vous avez appris beaucoup de choses, avec ce que vous avez appris là vous avez ce qu'il faut pour commencer à avoir un serveur correct, néanmoins il vous faudra être curieux (parcourir le wiki, télécharger un GM de base pour voir sa constitution, etc.)
Une 3e partie viendra prochainement conclure ce tutoriel.

Sur ce, bon courage à tous ;)

Partie 3: Conclusion

Salut, et bienvenue dans la 3e partie de ce tutoriel PAWN qui sera assez courte !
Dans celle-ci, je vais vous apprendre à créer des fonctions, puis je vous donnerai quelques conseils pour l'hébergement.
Il y aura aussi une introduction rapide à la notion d'intérieur et de monde virtuel.

Notion d'intérieur

Un intérieur est comme son nom l'indique, un intérieur de bâtiment. Si vous faites un téléport 10 unités de Z au dessus de la normale(lorsque vous êtes dans un bâtiment), vous pourrez admirer "l'underworld". Chaque intérieur possède quelques bâtiments et a un ID spécifique que vous pouvez retrouver ici ou encore InteriorIDs
Pour téléporter un joueur dans un intérieur, il faudra donc utiliser :

SetPlayerInterior(playerid,Interiorid);

(sans oublier de téléporter le joueur à la position de l'intérieur)
Vous trouverez les IDs et positions des intérieurs sur le lien ci-dessus.

Notion de monde virtuel

Il existe quelques millions (ou milliards ??) de monde virtuels, ou "VirtualWorld" ou encore "VW". Ils permettent de séparer les joueurs tout en partageant la même map.
L'utilisation de mondes virtuels autres que le 0 (défaut) semble donc évidente si vous voulez créer un DM, pour éviter que les joueurs en DM ne puissent tuer les autres.
Pour lier un joueur à un monde virtuel, utilisez :

SetPlayerVirtualWorld
Image:32px-Circle-style-warning.png

Note
Importante

ATTENTION : Un véhicule placé normalement ne sera visible que dans l'intérieur 0 et le monde virtuel 0, il faut utiliser SetVehicleVirtualWorld et LinkVehicleToInterior pour y remédier.


Créez vos fonctions

Quelquefois, vous aurez des commandes répétitives à créer (je pense aux téléports), il serait donc plus judicieux de créer une seule fois tous les effets (Téléporter, téléporter le véhicule si besoin, ajuster l'angle, etc) et de résumer un téléport à une instruction du genre Teleport(playerid,Float:X,Float:Y,Float:Z,Interior,VirtualWorld);
Je vais reprendre et ajuster honteusement l'exemple de Syg (http://www.gtaonline.fr/forums/index.php/topic,6250.0.html)

if (strcmp ("/stade", cmdtext, true) == 0)
{
   new vehicleid;
 
   if (IsPlayerInAnyVehicle (playerid))
   {
      vehicleid = GetPlayerVehicleId (playerid);
      SetPlayerPos (playerid, 1.0, 2.0, 3.0);
      SetPlayerVirtualWorld(playerid,5);
      SetPlayerInterior(playerid,2);
      SetVehicleVirtualWorld(vehicleid,5);
      LinkVehicleToInterior(vehicleid,2);
      SetVehiclePos (vehicleid, 1.0, 2.0, 3.0);
      SetVehicleZAngle (vehicleid, 4.0);
      PutPlayerInVehicle (playerid, vehicleid, 0);
      SetCameraBehindPlayer (playerid);
   }
   else
   {
      SetPlayerPos (playerid, 1.0, 2.0, 3.0);
      SetPlayerInterior(playerid,2);
      SetPlayerVirtualWorld(playerid,5);
      SetCameraBehindPlayer (playerid);
   }
}

Rien qu'à la vue de ce code, vous pouvez vous rendre compte qu'il s'agit d'un code lourd pour pas grand chose.
Cependant il peut être simplifié, nous allons créer une nouvelle instruction qui regroupera le tout :

Teleport (playerid, Float:X, Float:Y, Float:Z, Float:Angle, Interior, VirtualWorld)
{
   new vehicleid;
   if (IsPlayerInAnyVehicle(playerid))
   {
      vehicleid = GetPlayerVehicleId (playerid);
      SetPlayerPos (playerid, X, Y, Z);
      SetVehiclePos (vehicleid, X, Y, Z);
      SetVehicleZAngle (vehicleid, Angle);
      SetPlayerInterior(playerid,Interior);
      LinkVehicleToInterior(vehicleid,Interior);
      SetPlayerVirtualWorld(playerid,VirtualWorld);
      SetVehicleVirtualWorld(vehicleid, VirtualWorld);
      PutPlayerInVehicle (playerid, vehicleid, 0);
      SetCameraBehindPlayer (playerid);
   }
   else
   {
      SetPlayerPos (playerid, X, Y, Z);
      SetPlayerInterior(playerid,Interior);
      SetPlayerVirtualWorld(playerid,VirtualWorld);
      SetCameraBehindPlayer (playerid);
   }
}

Maintenant, vous n'avez plus qu'a taper (dîtes non à la violence!):

if (strcmp ("/stade", cmdtext, true) == 0)
{
   Teleport(playerid, 1.0, 2.0, 3.0, 4.0,15,5);
   return 1;
}

Le joueur sera conduit aux positions (1;2;3), avec un angle de 4°, dans l'intérieur 15 et le monde virtuel 5.

Conseils d'hébergement

Les hébergeurs se font nombreux, mais certains ne sont pas toujours honnêtes... Attention donc aux vols de scripts !
Pour éviter cela au maximum, voici 2 conseils :

  • Méfiez-vous des hébergeurs gratuits, très peu sont honnêtes. Si vous avez un réel projet, il vaut mieux chercher un hébergement certes payant, mais de qualité.
  • Ne mettez que le .amx (version compilée) sur votre session. (Les .pwn contiennent le code source en clair et sont inutiles au fonctionnement du serveur)

Attention aussi à la compatibilité Linux / Windows ! La majorité des hébergements se font sous linux, mais il existe quelques différences, notamment au niveau des plugins (.dll à ajouter à votre serveur pour disposer de fonctions supplémentaires.)
Par exemple, ici vous ne devrez pas mettre le .dll, mais le .so (Version Linux).

Voilà, c'est la fin de cette 3e partie et de ce tutoriel, vous avez maintenant les capacités pour faire un bon GM, bonne chance !
++

Information sur ce tutoriel

Ce tutoriel a été réalisé par Gilux sur le forum GtaOnline

Moi, Kilou, sous le compte de Connor Mead, qui n'a fait que transporter et éditer ce tutoriel (pour que la syntaxe soit conforme et lisible sur ce wiki), ne m'en attribue en aucun cas la réalisation.

Personal tools
Navigation
Toolbox