[Scripting] Tutorial sobre Script : Movimientos de Npc

Esto es muy sencillo, solo abre tu rom con Advance Map y ya cuando esté abierto ve a la barra de herramientas, ubica Options > Choose
Script Editor. Te abrirá el explorador de windows, luego ve a la carpeta donde tengas el XSE y haz doble click en "XSE.exe". Te aparecerá un cuadro de texto en inglés, clickea en "Yes" (o "Sí"), y listo, ya has enlazado Advance map a XSE.

Para abrir un evento en XSE solo debes de dirigirte en Amap al minisprite, poste, script de gatillo o de nivel y buscar la opción "Open Script" al hacer eso XSE debería de descompilar el script por completo.

Truco: Para los npc's, postes o scripts de gatillo solo basta con darle doble click al evento para descompilarlo.

Todo script que vayas a hacer debe empezar de la siguiente manera:
Esto se traduce a:
#dynamic 0x800000: Indicar que usaremos etiquetas dinámicas y que XSE va asignar las offsets de cada comando a partir de 0x800000 a modo que no se sobrepongan una con otra, podemos poner cualquier offset unicamente si esta tiene suficiente espacio libre, de lo contrario XSE no compilará nada.
#org @inicio: esta etiqueta indica el comienzo del subscript principal, el @inicio es la etiqueta dinámica, cuya offset la asignará automáticamente XSE cuando hayamos compilado correctamente el script.

Ahora voy a empezar con el script de habla más básico de todos, osea este:

Ese script es de los más fáciles de hacer y comprender, pero te haré el favor de explicarte cada comando que he usado en el script:
lock: Este comando nos permitirá bloquear cualquier acción del resto de npc's del mapa actual, es importante que pongamos este comando en los scripts de habla.
Faceplayer: Este comando hace que el npc al que le hemos hablado nos voltee a ver, este comando es importante para darle estética y realismo al script
Nota: El comando faceplayer debe utilizarse únicamente antes de iniciar un diálogo con un npc, no debe usar en scripts donde no hay npc's de por medio, como algunos scripts de gatillo y nivel.
msgbox 0x6: Comando que abre la caja de texto, los parámetros los explicaré más abajo.
release: Este comando se encarga de liberar los npc's que fueron bloqueados por el comando lock, por lo cual está totalmente ligado a este comando, si al inicio hay un lock es obligatorio que al final haya un release.
end: Comando corto pero importantísimo, sirve para terminar con un script y/o subscript, si este comando no está al final nuestro script simplemente va a crashear el juego cuando este llegue al final.

Bueno, ya he explicado los comandos más sencillos, ahora voy a explicar los tipos de msgbox que hay y sus diferentes aplicaciones.

Msgbox 0x2
Esta es una textbox sencilla, esta sirve para ahorrar comandos ya que incluye los comandos lock, faceplayer y release, solo nos sirve para npc's normales ya que no podemos usar más comandos en esta msgbox.

Ejemplo de script:
Msgbox 0x3
Este msgbox sirve únicamente para los carteles, ya que está destinada para los tiles con comportamiento 0x84, Nunca deben usarse los comandos lock, faceplayer y release en esta msgbox

Ejemplo de aplicación:
Msgbox 0x4
Esta msgbox es una caja de texto normal, mas esta no se cierra nunca, para cerrarla debe ponrse el comando closeonkeypress, de lo contrario seguirá abierta aunque el script haya terminado.

Ejemplo de aplicación:
Msgbox 0x5
Esta es una msgbox muy importante ya que sirve para que al terminar el texto se muestre una caja de pregunta si/no, dependiendo de la opción que eligamos esta nos llevará a distintos subscripts, se explicará a fondo este comando más adelante.

Ejemplo de aplicación:
Msgbox 0x6
Esta es la msgbox más común y usada en scripts, ya que abre una caja de texto totalmente normal y no tiene ningún tipo de comando resteingido.

Ejemplo de aplicación:
Msgbox 0xA (Solo Emerald)
Nos servirá unicamente para abrir cajas de texto que simulan las llamadas del Pokenav, mostrandonos el gráfico del Pokenav girando a la izquierda de la caja de texto.

Ejemplo de aplicación:
Bonus: Preparemsg
Es un extraño comando el cual es como la msgbox 0x4, pero esta no requiere de psrámetros, unicamente el puntero del texto, ah, y después de esta es obligatorio poner los comandos waitmsg y closeonkeypress, usualmente se usa cuando un npc no visible en la pantalla habla. Ejemplo
La textbox de los juegos de GBA se limitan únicamente a mostrar 35 carácteres por linea, es por eso que existen carácteres especiales para los distintos cambios de lineas, además de eso estos carácteres pueden ser usados para otras cosas. Dichos carácteres son:

\p: Sirve para hacer saltos de página. Ejemplo:

El resultado sería
\n: Sirve para hacer saltos de línea, esta debe usarse únicamente si está precedida de un salto de página (\p). Tambien suele usarse al inicio de una textbox. Ejemplo:

El resultado sería:
Nota: Este comando nunca puede ir junto dos veces a el mismo, ya que provocará un feo y poco profesional efecto al leer el texto, por ejemplo:

\l: Sirve para hacer cambios de línea sin abrir una nueva página, estos siempre van precedidos de un salto de linea (\n). Aunque nunca pueden ir después de un salto de página (\p), si pueden ir muchos de estos juntos. Ejemplo:

El resultado sería:
\h: Este comando sirve para señalar un carácter por su pocisión hexadecimal en el ROM, es útil para esos caracteres los cuales no poseen nuestros teclados. Ejemplo:

Como podrán ver, he puesto un \h24, lo cual será interpretado como el caracter en la pocisión 0x24 de la tabla de carácteres, lo cual in game se verá asi:
Nota: Pueden consultar la tabla thingy de valores para más información.

\c: Sirve para indicar un cambio de color en el texto, hay un total de 15 colores para usar, la estructura es muy complicada, mas o menos así:

Lo cual aparecerá así:

Pancho:Creo que tengo una
serpiente en mi bota.

Pero como ese proceso es muy dificil de aplicar usaremos el método de los corchetes, los cuales son:

Fire Red/Leaf Green

Emerald

Nota: Los colores de la fuente dependen de los colores de la textbox, si la cambiaste obviamente los colores van a ser distintos

Ahora sí, un ejemplo de uso simplificado con corchetes:

Lo cual in-game quedará asi:

Taichi: Soy el mejor digielegido
del digimundo digimundial.

\v: Sirve para mostrar textos guardados en los distintos búfers del juego, en total hay 6 búfers capaces de almacenar textos de hasta 10 caracteres, mas solo 4 están libres ya que dos de ellos siempre están siendo usados por el nombre del jugador y el nombre del rival, son los búfers 01 y 06. Ejemplo de uso:

Si mi jugador se llama Hugo y mi rival Paco:

El resultado in-game sería:
Nota: Los búfers 01 y 06 tambien pueden mostrarse usando los corchetes [Player] y [Rival] respectivamente, ejemplo:

Bien, nos hemos dado cuenta que en los ejemplos anteriores al compilarlos pasa que los eventos al interactuar con dichos npc estos se repiten cada vez que les hablamos, imagina que vas a poner que un npc te dé un item raro, cada vez que hables con el, este te dirá el mismo item, ¿Como podemos hacer que no nos dé el item cada vez que le hablemos no nos dé el item? pues fácil, usamos flags y variables.

Flag

Una flag es una especie de "interruptor" que usa el engine para comprobar diversos eventos basados en su estado, las flags son relativamente pequeñas, siendo representadas por bits, por lo que cads flag pesa 1 bit, por lo que 8 flags equivalen a 1 byte.

Las Flags al ser "interruptores" solo poseen dos estados, encendidas (0x1) y apagadas (0x0), por lo tanto podemos hacer que el juego compruebe el estado de uns flag y a partir de esto ejecutar diferentes acciones basadas en esto.

Hay tres comandos relacionados a las flags y su estado, estos son setflag, clearflag y checkflag, ahora explicaré la definición de estos:

Setflag:
Este comando sirve para encender o fijar a 0x1 una flag.

Clearflag:
Comando que sirve para apagar o fijar a 0x0 una flag.

Checkflag:
Es el más complejo de los tres, sirve para comprobar el estado de una flag, dependiendo de su estado puede hacernos llevar a otro script o continuar el mismo script.

¿Que Flags debería usar?
No hay flags ilimitadas, ni todas las flags del juego son usables, solo un número reducido son aptas para usarse, y según DavidJJcob, las flags usables son las que van desde 0x200 hasta 0x2FF, en resumen, puedes usar FF flags (Osea, 256 flags). Aqui un ejemplo.
Vamos a explicar unicamente los comandos que vamos a necesitar, los otros los explico después.

Checkflag 0x207: Checkea el estado de la flag número 207
If 0x1 goto @snippet1: Basado en el estado de la flag decide que acción tomar, en este caso el 0x1 se traduce como encendido, if significa en español si[/b], goto significa ir, entonces ese comando se traduce "si está encendido ir a @snippet1" ¿Queda claro? bueno, por si las dudas recuerda, 0x1 significa encendido, 0x0 significa apagado

Como puedes notar en la estructura, si la flag no está encendida el script continúa de manera normal, al final de este la flag 0x207 se enciende, si volvemos a hablar con este npc, el script comprobará que la flag está encendida, al ya estarlo, el script "saltará" al puntero @snippet1, en el cual solo hay una caja de texto, evitando así que nos vuelva a dar el mismo item.

Bueno, ahi está la explicación de las flags, ahora nos iremos a algo más hardcore, pues como sabrás las flags no almacenan ningun dato, solo pueden cambiar su estado. Te has preguntado alguna vez, ¿Como hace el script de Oak para saber cuantos Pokémon llevamos capturados? pues es con eso llamado...

Variables
Las variables, a diferencia de las flags, son como las X de los problemas de álgebra, como tambien una especie de "bodegas" (Alcancías como diría Cheve), en las cuales se pueden añadir, quitar o fijar valores especificos, por lo tanto estas no pueden comprobarse, solo puedes comparar su valor con cierto número, una variable puede almacenar hasta 0xFFFF bytes (65,536) la nomenclatura de estas es similar a la de las flags, siendo el comando para compararlas llamado

Compare, este va seguido del número de variable a comparar y al final el valor a comparar, las acciones tras comparar son las siguientes:

if 0x0= Menor a
if 0x1= Igual a
if 0x2= Mayor a
if 0x3= igual o menor a
if 0x4= igual o mayor a
if 0x5= No exactamente igual a

¿Que variables debo usar?
A diferencia de las flags, las variables son más limitadas aún, pero aún así, podemos usar las variables entre 0x4011 hasta 0x40FF, osea hay EE flags usables (238 para ser especifico) aunque hay algunas de este rango que tienen uso especifico.

Hay varios comandos relacionados a las variables, pero los comandos de scripts más comunes a usar son:

Addvar: Suma una determinada cantidad a una variable, si esta ya poseía algún valor se le sumará al valor existente.

subvar: Resta una determinada cantidad a una variable, si esta ya poseía algún valor se le restará al valor existente.

Setvar: Es el comando más común sobre variables, pues fija una determinada cantidad a una variable, si esta ya poseía algún valor este se ignorará y se le reemplazará por el valor fijado.

Vamos a dar un ejemplo, hice un script de un minijuego, para ganar cierto item en ese minijuego debemos haberlo superado 15 veces, pero ¿Como hago para que cuente cuantas veces hemos ganado? sencillo, en el script del minijuego puse que cada vez que gane se agregará una unidad a una variable, osea un addvar 0x1. Entonces en el script de quien me dará el premio pondré esto. Para explicarme mejor mira este ejemplo.

Código:

#Dynamic 0xFC9020
#org @start
lock
faceplayer
msgbox @text1 0x5
compare LASTRESULT 0x1
if 0x1 goto @snippet1
compare LASTRESULT 0x0
if 0x1 goto @snippet2
release
end

#org @snippet1
compare 0x40F2 0xF
if 0x4 goto @snippet3
msgbox @text2 0x6
release
end

#org @snippet2
msgbox @text3 0x6
release
end

#org @snippet3
msgbox @text4 0x6
giveitem 0x20 0x1 MSG_OBTAIN
msgbox @text5 0x6
release
end

#org @text1
= Hola tio, ¿Ya has ganado 15 veces\nel juego?

#org @text2
= No mientas, aún no lo haces

#org @text3
= Sigue intentandolo, quizás ganes\nalgún día.

#org @text4
= ¡Eres maravilloso! nunca pensé\nque alguien ganaría a\lmi juego, toma esto.

#org @text5
= No te des por vencido, sé que\npuedes seguir ganando

Quedó un poco largo, ¿No? pero en si no es complicado, explicaré los comandos que usé:

compare 0x40F2 0xF: Comparará que la variable 0x40F2 tenga F unidades (osea 15 unidades)
if 0x4 goto @snippet3: comprueba que si el valor de 0x40F2 es igual o mayor a F (15) salte a @snippet3

Este script comprueba perfectamente la cantidad de veces ganadas en el minijuego, en caso de no haberlo hecho nos dirigirá a otra parte del script.

Ahora daré otro ejemplo más sencillo, un script simple que se ejecutará según el valor de la variable.

Código:

#Dynamic 0x79207C
#org @start
lock
faceplayer
compare 0x4077 0x1
if 0x1 goto @snippet
msgbox @text1 0x6
setvar 0x4077 0x1
release
end

#org @snippet1
msgbox @text2
release
end


#org @text1
= Hola, bienvenido a Tepito

#org @text2
= En tepito todos somos amigables

Como pudiste notar, hay un enorme parecido con un script hecho con flags, pero hay diferencias, aunque ese script bien podía hacerse con flags, yo lo hice con variables, aunque para scripts de gatillo y nivel es obligatorio usar variables.

Nota: Si quieres saber más sobre las flags y variables seguras de usar puedes consultar esta guía sobre las flags y variables.

Si 256 flags y 238 variables te parecen pocas puedes consultar este manual para extender las flags y variables seguras de usar