TESCS2 : Les scripts

De Wiwiki
Sauter à la navigation Sauter à la recherche


Sur le forum quelqu'un demandait qu'on lui fasse un script alors que celui ci semblait n'avoir rien de compliqué. J'encourage donc tous les nouveaux TESCSeurs à apprendre à scripter pour faire eux même leurs scripts et donc permettre aux scripteurs fous d'aider ceux qui sont sur des scripts qu'ils ne pourront vraiment pas faire seuls. :)


Je mets donc ici un tutorial sur les bases du scripting. J'en ferais un mieux présenté et plus complet plus tard mais vous pouvez déjà comencer à scripter avec ça.

N'oubliez pas : 'Il y a pire que de ne pas y arriver, c'est de ne pas essayer & persévérer !'


Il ne faut pas voir les scripts comme quelque chose de compliqué, il s'agit d'un langage tout comme l'anglais ou le français, mais en BEAUCOUP BEAUCOUP plus simple. Donc si tu sais parler français tu sauras scripter. D'autant que le language du TESCS est vraiment très simple (ce qui le rend compliqué lorsque l'on veut faire des trucs un peu tordus ^^, car il manque de trop de possibilités). Ainsi tu as juste à connaitre 7 règles de grammaires (alors qu'en français y'en a des centaines !). A savoir :


- La règle du "script" : un script commence toujours par :

CODE
scriptname nomDuScript

Le "ScriptName" peut également être remplacé par son équivalent raccourci, "Scn" :

CODE
Scn nomDuScript

- La règle des "blocs de script" : une partie de script est toujours comprise entre un Begin et un End.

CODE
Begin condition

Les instructions du Script

End

Mais comme toutes les règles, il y a des exceptions : le "ScriptName" et les déclarations de variables locales (voir ci dessous) DOIVENT être en dehors du bloc Begin/End ! ;)

- La règle des blocs de condition : un bloc de condition (si, sinon si, sinon) commence toujours par :

CODE
if (condition)

  instructions

endif

Entre deux tu mets toutes les instructions qui doivent s'effectuer SI la condition du if est remplie. S'il y a plusieurs conditions différentes on peut utiliser les "sinonsi" (elseif) et "sinon" (else), donc par exemple :

CODE
if ( Condition 1 )

  Afficher On est dans la condition 1

elseif ( Condition 2 )

  Afficher On est dans la condition 1

elseif ( Condition 3 )

  Afficher On est dans la condition 3

else

  Afficher On est ni dans condition 1 ni dans condition 2 ni dans condition 3

endif

- La règle des objets : Le TESCS2 repose sur une logique objet, ainsi pour qu'un objet (un PNJ, un coffre, une créature etc.) exécute la fonction il suffit de faire : ObjetID.LaFonction. Donc pour que ce soit le joueur par exemple qui meurt, et bien il faut mettre : player.kill


- La règle des variables : il faut déclarer les variables avant de les utiliser. Soit elles sont déclarées en tant que variables globales dans le jeu (créées dans le menu "Gameplay"->"Globals..." du TESC2), soit elles sont déclarées uniquement dans le script en tant que variables locales (déclaration du genre : "TYPE variable"). On n'a pas grand chose comme types possibles :

CODE
short : valeur entre -32 768 et 32 767 (entier court)

long : valeur entre -2 147 483 648 et 2 147 483 647 (entier long)

float : valeur entre 1,18E-38 et 3,40E38 (precision = 7 digits) (nombre à virgule)

ref : un ObjetID (reférence sur un objet, comme un PNJ, un coffre etc.)

- La règle des commentaires : tout ce qui est précédé par ";" est un commentaire. Donc :

CODE
; blablabla tout ça c'est du comment
; if (condition1) est aussi un comment

if (condition2)

; mais le if (condition2) ci dessus ne l'est pas

- Enfin, la règle d'exécution des scripts : ils sont exécutés en boucle : à chaque frame, le script est éxécuté une fois (si les conditons d'éxécutions sont rempliers). Donc si tu fais :

CODE
scriptname un_test

Begin GameMode

messageBox "Mwaha tu peux plus jouer !", "Ok"

end

Celà va afficher la messageBox tout le temps et le joueur devra appuyer sur OK tout le temps sans avoir la possibilité de jouer.


Ensuite il suffit de trouver les fonctions qui réalisent ce que tu veux faire (ajouter de la vie, renommer une cell etc.) ou d'en créer une toi même (calcul de modulo, opérations de trigo etc.) si elles ne sont pas déjà implémentées.


Donc en résumé voici un script à mettre sur l'anneau qui sert à rien :

CODE

scriptname mon_script_test

short dayExec; idem

short monthExec; idem

short yearExec; idem

float hourExec; l'heure qui est un float dans le jeu

short doOnce; déclaration d'une variable de type entier court car elle ne prendra que -1 (ou 0) ou 1

Begin OnActivate; ce qui est compris entre ce Begin et le End ne sera exécuté que si on active l'anneau (on le ramasse)

  if ( doOnce != 1 ); Si doOnce est différente de 1 (elle est à 0 ou -1 par défaut à sa création.)

    MessageBox "C'est la première et dernière fois que cette partie s'éxécute", "ok"; on affiche ça

    set doOnce to 1; on affecte la valeur 1 à doOnce

    set hourExec to GameHour; hourExec récupère l'heure actuelle dans le jeu)

    set dayExec to GameDay; récupère le jour

    set monthExec to GameMonth;idem pour le mois

    set yearExec to GameYear;idem pour l'année

  endif


  Activate; on active l'anneau car le OnActivate annule l'activation donc si on ne mettait pas Activate ici on ne pourrait jamais le prendre

End


Begin OnDeath player; ce qui suit ne sera exécuté qu'à la mort du player

  MessageBox "Haha vous êtes morts ! Vous aviez pris l'anneau pour la première fois le %.0f %.0f %.0f à %.2f", dayExec, monthExec, yearExec, hourExec, "Snif"

; va afficher une boite de message avec le texte où les %.0f et %.2f seront remplacés dans l'ordre par les variables qui suivent le message. Le seul bouton sur lequel on pourra cliquer sera le bouton "snif"

End

Voilà tu as toutes les bases du scripting tu vois ce n'est pas du tout compliqué.

D'ailleurs si tu veux essayer d'apprendre à scripter autrement qu'avec le TESCS2 (qui oblige à lancer Oblivion pour voir si le script fonctionne...) tu peux essayer d'apprendre le JavaScript ou le PHP. Ce sont deux langages très simples qui s'aprennent facilement. http://www.phpdebutant.org est très bien pour commencer. Sinon : http://developpez.com a de très bon tutos sur un peu tous les langages.


En conclusion, il faut donc lire et écrire un script comme si tu parlais. Par exemple pour toi c'est : (la personne qui voulait le script voulait ce qui suit)


Si le joueur a le signe "MachinChose" alors il doit avoir 0 de magie. Mais s'il a plus de X point d'intelligence, alors on lui accorde Y points de magie en fonction de ce qu'il a et de X (par exemple Y = ("Pts Int Joeurs" - X ) * 3 + ("Level Joueur" * 2)


Ce qui se traduit en script par quelquechode de ce genre (pas testé je peux pas faire touner Obliv là ou je suis) :


CODE
Scriptname Exemple

short int

short will

short level

short permit

Begin GameMode


  if ( GetIsPlayerBirthsign "MachinChose" == 1 )

    set int to player.GetActorValue intelligence

    set will to player.GetActorValue WillPower

    set level to player.getLevel    


    if ( int  > X )

      if ( will > permit )

         player.SetActorValue WillPower permit

      endif

    else

      player.SetActorValue WillPower 0

    endif

  endif

end


Tu as tout pour en faire toi même maintenant. Evite de compter sur les autres pour les scripts pas trop compliqués et ce pour plusieurs raisons :

- personne ne pourra faire le script exactement comme tu l'imagines (bon sauf si c'est pour afficher un texte...)

- tu vas perdre un peu de temps au début en les faisant toi même car tu devras apprendre mais après ce sera beaucoup plus rapide que de trouver quelqu'un, lui expliquer, verifier ce qu'il a fait, lui dire ce qu'il ne va pas, lui réexpliquer etc.

Le site du wiki officiel sur le cs : http://cs.elderscrolls.com/constwiki/index.php/Category:Scripting