[TUTO][GBA] Scripts : Le giga tuto des CS et des attaques hors combat.

Bonjour, bonsoir chers amis. Aujourd'hui, je suis de retour pour vous présenter mes recherches sur tout le système de CS des versions GBA de pokémon. Nous allons tout de suite entrer dans le vif du sujet car c'est quelque chose de long qui nous attend.

Connaissances à avoir :
- Savoir scripter
- C'est tout

---

Premièrement, voici une explication du fonctionnement des CS.
Pour fonctionner, lorsque l'on agit avec certains éléments du décor, un script modifiable simplement avec XSE est appelé. Vous trouverez la liste des offsets des scritps à la fin de ce tutoriel.
Décortiquons-en un ensemble. Voici le script appelé lorsque l'on veut utiliser Coupe :

Bon, c'est vrai, ça paraît gros. Mais nous allons voir tout ça ensemble.

#org 0x1BC8A8
special 0x187
compare LASTRESULT 0x2
if 0x1 goto 0x81A6509

Bon, on commence avec quelque chose qui est assez étrange. D'après pokecommunity, ce special ci met une valeur particulière dans LASTRESULT, qui semble être un check d'erreur. Si il est égal à 0x2, le script est renvoyé sur un autre morceau qui lui donne fin. Bref, ça, on le laisse.

lockall
checkflag 0x821
if 0x0 goto 0x81BC91C

Ça, facile, si vous connaissez la base. Le checkflag vérifie si le joueur possède un badge. Si ce n'est pas le cas, le script redirige vers ceci :

#org 0x1BC91C
msgbox 0x81BC979 MSG_SIGN '"Cet arbre semble pouvoir être\nCOU..."
releaseall
end

Il affiche juste le fameux message « Cet arbre semble pouvoir être coupé. ». Passons à la suite :

checkattack 0xF
compare LASTRESULT 0x6
if 0x1 goto 0x81BC91C

Ici, des morceaux de code assez spécifiques. Le checkattack vérifie si l'un des pokémons de notre équipe possède l'attaque 0xF dans l'index (que vous pourrez trouver en fin de tutoriel), dans notre cas l'attaque coupe. Si c'est le premier pokémon de l'équipe, alors la variable LASTRESULT sera fixée à 0x0, si c'est le second, à 0x1... etc. Donc, si aucun pokémon n'a coupe dans notre équipe, LASTRESULT vaudra donc 0x6. Dans ce cas, on renvoie vers le même morceau que tout à l'heure et on affiche le message. Sinon, on continue :

setanimation 0x0 LASTRESULT
bufferpartypokemon 0x0 LASTRESULT
bufferattack 0x1 0xF
msgbox 0x81BC929 MSG_YESNO '"Cet arbre semble pouvoir être\nCOU..."
compare LASTRESULT 0x0
if 0x1 goto 0x81BC926

Ici, on a quelque chose de très spécifique, mais d'assez simple. On a comme valeur dans la variable LASTRESULT le numéro du pokémon dans notre équipe possédant l'attaque coupe. On demande donc au jeu de préparer une animation de type 0x0 avec notre n^ième pokémon. Je ne suis pas sûr à 100% de ce que je dis mais si je ne me trompe pas, cette ligne gère l'animation de la bande noire avec le pokémon par-dessus. Quant-à la ligne suivante, bufferpartypokemon permet au jeu de charger le nom du pokémon du slot numéro LASTRESULT, soit le pokémon ayant coupe, dans le bufferslot 0x0. Cela permettra d'afficher le nom ou surnom du pokémon dans le message. Ensuite, le bufferattack stocke le nom de l'attaque 0xF dans l'emplacement 0x1 afin de l'afficher en tant que [buffer2] dans le message.
Concrètement, ça veut simplement dire que [buffer1] et [buffer2] seront transformés en « Nom du pokémon » et « Nom de l'attaque » (ici, coupe) quand ils seront utilisés dans un msgbox.
Ensuite, on a une simple boite de question Oui/Non, et si on répond non, le script est redirigé pour qu'il s'arrête.

Ensuite :
msgbox 0x81BC96A MSG_KEEPOPEN '"[buffer1] utilise [buffer2]."
closeonkeypress
doanimation 0x2
waitstate
goto 0x81BC90B

Les fameux buffers, que j'ai expliqués juste avant. Vous connaissez closeonkeypress. La commande doanimation 0x2 permet de jouer le son de coupe. Par exemple, dans le code des rochers à casser, on trouve doanimation 0x25, qui joue un son différent.
La commande waitstate permet d'attendre la fin du son pour continuer le script. Enfin, le goto ramène au code suivant :

applymovement LASTTALKED 0x81BC91A
waitmovement 0x0
hidesprite LASTTALKED
releaseall
end

'-----------
' Movements
'-----------
#org 0x1BC91A
#raw 0x69 'mov69
#raw 0xFE 'End of Movements

Bon, les applymovements, vous connaissez maintenant. Le #raw 0x69 correspond à l'animation de coupe. Le hidesprite cache l'arbuste une fois détruit, puis le releaseall termine notre script. Pfiou, enfin.

Que pouvons nous comprendre et conclure ? Eh bien, dans ce script, nous avons deux grandes parties importantes :
- Les vérifications : On vérifie que le joueur a le bon badge et qu'il a bien l'attaque que l'on veut utiliser. Ensuite, on lui demande si il veut effectuer son action : surfer, couper un arbre, utiliser force... Si oui, on passe à la suite.
- Les animations : On joue le son pour notre animation, puis on affiche notre message de validation, et l'animation de notre pokémon qui utilise son attaque. Puis, on effectue les actions spécifiques, c'est à dire à peu près tout ce que l'on veut faire dans un script. C'est ici que dans notre seconde partie, vous laisserez place à votre imagination.

---

Voici maintenant la partie qui va intéresser le plus de monde. Tout d'abord, listons ce que nous pouvons faire, par niveau de difficulté :

- Supprimer le check de badges ou modifier le badge nécessaire pour utiliser une certaine CT.
- Modifier les flags pour demander de nouvelles conditions, un objet spécifique, etc.
- Créer une nouvelle interaction avec le décor en créant un script inspiré de ceux ci.

Commençons donc dans l'ordre. Pour supprimer la necessité d'utiliser un badge, rien de plus simple : dans votre script, il y a toujours un checkflag demandant un badge. Il suffit de supprimer cette condition, et hop, vos pokémons pourront utiliser vos CS sans badge spécifique.
Pour rester dans ce qui est facile, voyons maintenant comment faire pour devoir utiliser un objet à la place d'une CS. Tout d'abord, il faudra supprimer cette partie :
checkattack 0x[index de l'attaque]
compare LASTRESULT 0x6
if 0x1 goto 0x8[offset]
setanimation 0x0 LASTRESULT
bufferpartypokemon 0x0 LASTRESULT
bufferattack 0x1 0x[index de l'attaque]

Ensuite, il faudra changer les textes, en particulier les [buffer1] et [buffer2], car si les buffer n'ont pas été définis, le jeu ne va pas apprécier et faire de violents bugs.
Enfin, on pourra ajouter ces deux commandes pour vérifier si le joueur possède un objet spécifique :
checkitem 0x[index de l'item]
compare LASTRESULT  0x0
if 0x1 goto 0x[fin du script]
Et s'il ne s'agit pas d'un objet rare mais d'un objet consommable, on peut même ajouter :
checkitem 0x[index de l'item]
compare LASTRESULT  0x0
if 0x1 goto 0x[fin du script]
removeitem 0x[index de l'item] 0x1 (0x1 étant la quantité à supprimer)

N'oubliez pas de repointer, pour  être sûr que votre script n'interfère pas avec les autres déjà présents ici.


Enfin, nous allons voir comment créer notre propre script permettant d'intéragir avec la map. Imaginons par exemple que vous ayez envie de pouvoir rencontrer des pokémons sauvages en utilisant l'attaque coup d'boule sur un arbre, par exemple. Cela pourrait marcher avec n'importe quoi, une attaque eau pour réveiller un Simularbre, un lance flammes pour faire fondre de la glace, couplée avec un setmaptile... Les possibilités sont infinies.

Partons donc sur notre idée de coup d'boule. Tout d'abord, partons de nos connaissances de ce que l'on a découvert en première partie. On part de la base suivante :

special 0x187
compare LASTRESULT 0x2
if 0x1 goto 0x81A6509
lockall
Ça, c'est la base des autres scripts, autant le garder, ça évitera des bugs. On ne souhaite pas vérifier de flag, donc on passe à la suite directement :

checkattack 0x1D (vous pouvez trouver la liste des attaques en hexadécimal à la fin de ce tutoriel.)
compare LASTRESULT 0x6
if 0x1 goto 0x8[offset1]

'----
#org [offset1]
msgbox 0x8[texte1] MSG_SIGN '"Cet arbre semble pouvoir être secoué."
releaseall
Si le joueur n'a pas l'attaque que l'on veut, ici coup d'boule, on le renvoie à un script le prévenant que cet arbre peut être secoué. Bien sûr, après ce texte, on libère le joueur.

On continue ensuite après le if goto :

bufferpartypokemon 0x0 LASTRESULT
bufferattack 0x1 0xF
msgbox 0x8[texte2] MSG_YESNO '"Cet arbre semble pouvoir être secoué. Le cogner avec coup d'boul ?"
compare LASTRESULT 0x0
if 0x1 goto 0x81BC926

On met dans le [buffer0] le nom du pokémon  ayant l'attaque, et dans le [buffer1] l'attaque. Si le joueur ne souhaite pas cogner l'arbre, alors on le redirige vers une partie qui met fin au script. Ensuite, on ajoute :
msgbox 0x81BC96A MSG_KEEPOPEN '"[buffer1] utilise [buffer2]."
closeonkeypress

Pas besoin de changer l'offset ici, le texte est déjà très bien. Rien ne vous l'empêche, bien entendu.
Ensuite, c'est la fête. Maintenant, on peut ajouter le code que l'on veut et laisser place à notre imagination. On peut placer un random et lancer un wildbattle selon le résultat du random, beaucoup de choses sont possibles. Mais là, c'est à vous maintenant d'innover, car mon travail s'achève ici. Je vous redirige alors vers les tutos de scripting du site, qui vous permettront de faire ce que vous voulez ensuite.

---

---

Pokecommunity pour la liste des commandes « special »
https://www.pokecommunity.com/showthread.php?t=184273

Snrasha pour les offsets d'émeraude pour les scripts des CS
http://www.pokemontrash.com/club/rom-hacking/(gba)(rom)(fr)-pokemon-without-cs(abondonne-09022016)/

Sphericalice pour les renseignements sur les commandes des scripts
http://sphericalice.com/romhacking/documents/script/#c-9D


Ce tutoriel rend également obsolète celui-ci.
Du coup, si un modo peut lock le sujet ou bien le supprimer, ça serait chouette.

Merci à toi.

Merci à vous pour vos retours

AAAAAAANNNNNNNDD PIN !