Anexo:Comandos para Scripts (Decompilación)

Los Script permiten programar eventos de forma rápida y sencilla, haciendo uso de una lista de comandos pre-programados dentro del juego. En decompilación de GBA (ruby, firered y emerald) se tienen los siguientes comandos:

Lista de Comandos para Scripts

ID	Comando	Parámetros	Descripción	Plataforma
0x00	nop	-	Comando vacío. No hace nada.	R-FR-E
0x01	nop1	-	Comando vacío. No hace nada.	R-FR-E
0x02	end	-	Finaliza la ejecución del script.	R-FR-E
0x03	return	-	Vuelve a la línea siguiente al último comando 'call' ejecutado.	R-FR-E
0x04	call	[script]	Ejecuta el script pasado como argumento. Permite la vuelta mediante 'return'	R-FR-E
0x05	goto	[script]	Continua la ejecución en el script pasado como argumento	R-FR-E
0x06	goto_if	[condición] [script]	Continua la ejecución en el script pasado como argumento, siempre que se cumpla la condición.	R-FR-E
0x07	call_if	[condición] [script]	Similar a 'goto_if', pero permite la vuelta al script original usando 'return'.	R-FR-E
0x08	gotostd	[función standard]	Permite ejecutar una de las funciones standard del juego. Uso anecdótico.	R-FR-E
0x09	callstd	[función standard]	Similar a 'gotostd', pero permite volver desde un 'return'. Uso anecdótico.	R-FR-E
0x0A	gotostd_if	[condicion] [función standard]	Ejecuta una de las funciones standard, siempre que se cumpla la condición. Uso anecdótico.	R-FR-E
0x0B	callstd_if	[condición] [función standard]	Similar a gotostd_if, pero permite volver desde un 'return'. Uso anecdótico.	R-FR-E
0x0C	returnram	-	Ejecuta el script cuyo puntero esté almacenado dinámicamente en gUnknown_020375C0. Uso anecdótico.	E
0x0C	gotoram	-	Es igual a returnram, pero en pokefirered y pokeruby.	R-FR
0x0D	killscript	-	Finaliza la ejecución del script reseteando completamente la RAM de scripts.	R-FR-E
0x0E	setmysteryeventstatus	[estado]	Modifica un valor relacionado con el evento misterioso. Utilizado únicamente en Ruby, y como herramienta de Debug.	R-FR-E
0x0F	loadword	[buffer_id] [2 bytes]	Almacena un valor de 2 bytes (u16) en el buffer de scripts especificado	R-FR-E
0x10	loadbyte	[buffer_id] [byte]	Almacena un valor de 1 byte (u8) en el buffer de scripts especificado.	R-FR-E
0x11	writebytetoaddr	[byte] [dirección RAM]	Almacena un valor de 1 byte (u8) en la dirección RAM especificada.	R-FR-E
0x12	loadbytefromaddr	[buffer_id] [dirección RAM]	Almacena en el buffer seleccionado el valor contenido en la dirección RAM especificada (1 byte).	R-FR-E
0x13	setptrbyte	[buffer_id] [dirección RAM]	Almacena en la dirección RAM especificada el valor (1 byte) del buffer seleccionado.	R-FR-E
0x14	copylocal	[buffer_id destino] [buffer_id origen]	Copia el valor del buffer seleccionado como origen en el buffer seleccionado como destino.	R-FR-E
0x15	copybyte	[RAM destino] [RAM origen]	Copia el valor (1 byte) de la dirección RAM marcada como origen en la dirección RAM de destino.	R-FR-E
0x16	setvar	[var_id] [valor]	Establece el valor indicado para la variable seleccionada.	R-FR-E
0x17	addvar	[var_id] [valor]	Añade el valor indicado al valor actual de la variable seleccionada.	R-FR-E
0x18	subvar	[var_id] [valor]	Resta el valor indicado al valor actual de la variable seleccionada.	R-FR-E
0x19	copyvar	[var_id destino] [var_id origen]	Copia el valor de la variable origen en la variable destino.	R-FR-E
0x1A	setorcopyvar	[var_id destino] [origen]	Si el origen es una variable, actuará como 'copyvar'. En caso contrario será como 'setvar'.	R-FR-E
0x1B	compare_local_to_local	[buffer_id1] [buffer_id2]	Compara el valor de dos buffers de scripts.	R-FR-E
0x1C	compare_local_to_value	[buffer_id] [byte]	Compara el valor de un buffer con el valor indicado.	R-FR-E
0x1D	compare_local_to_addr	[buffer_id] [dirección RAM]	Compara el valor de un buffer con el valor almacenado en la dirección RAM indicada.	R-FR-E
0x1E	compare_addr_to_local	[dirección RAM] [buffer_id]	Compara el valor almacenado en una dirección RAM con el valor del buffer indicado.	R-FR-E
0x1F	compare_addr_to_value	[dirección RAM] [byte]	Compara el valor almacenado en una dirección RAM con el valor indicado.	R-FR-E
0x20	compare_addr_to_addr	[dirección RAM 1] [dirección RAM 2]	Compara el valor almacenado en una dirección RAM con el de otra dirección RAM.	R-FR-E
0x21	compare_var_to_value	[var_id] [byte]	Compara el valor de una variable con el valor indicado.	R-FR-E
0x22	compare_var_to_var	[var_id1] [var_id2]	Compara el valor de una variable con el de otra variable.	R-FR-E
0x23	callnative	[función]	Ejecuta una función nativa en C/ASM, continua con la ejecución del script al terminar la función.	R-FR-E
0x24	gotonative	[función]	Ejecuta una función nativa en C/ASM, termina la ejecución del script.	R-FR-E
0x25	special	[special_id]	Ejecuta la función special indicada.	R-FR-E
0x26	specialvar	[var_id] [special_id]	Ejecuta la función special indicada. Si la función devuelve algún valor, lo almacena en la variable especificada.	R-FR-E
0x27	waitstate	-	Bloquea la ejecución del escript hasta que una función nativa o una función special lo desbloqueen explícitamente.	R-FR-E
0x28	delay	[cantidad (4 bytes)]	Pausa la ejecución del script durante el número indicado de ciclos (~60 ciclos/s)	R-FR-E
0x29	setflag	[flag_id]	Establece el valor del flag indicado en 1 (activado).	R-FR-E
0x2A	clearflag	[flag_id]	Establece el valor del flag indicado en 0 (desactivado).	R-FR-E
0x2B	checkflag	[flag_id]	Comprueba el valor del flag indicado.	R-FR-E
0x2C	initclock	[hora] [minuto]	Inicializa el reloj local del juego en la hora y el minuto marcados.	R-E
0x2D	dotimebasedevents	-	Ejecuta los eventos diarios.	R-E
0x2E	gettime	-	Escribe en las variables 0x8000, 0x8001 y 0x8002 el tiempo del reloj en horas, minutos y segundos.	R-E
0x2F	playse	[sonido_id]	Reproduce el sonido indicado. Solo uno de forma simultánea.	R-FR-E
0x30	waitse	-	Pausa la ejecución del script hasta que termina la reproducción del efecto sonoro.	R-FR-E
0x31	playfanfare	[melodía_id]	Reproduce la melodía indicada.	R-FR-E
0x32	waitfanfare	-	Detiene la ejecución del script hasta que finaliza la melodía.	R-FR-E
0x33	playbgm	[canción_id] [0x00]	Reproduce la canción indicada. Segundo parámetro desconocido, siempre es 0x00.	R-FR-E
0x34	savebgm	[canción_id]	Guarda el id de la canción indicada para reproducirla más tarde.	R-FR-E
0x35	fadedefaultbgm	-	Desvanece la canción que se reproduce actualmente hasta la canción por defecto del mapa.	R-FR-E
0x36	fadenewbgm	[canción_id]	Desvanece la canción que se reproduce actualmente hasta la canción indicada.	R-FR-E
0x37	fadeoutbgm	[velocidad]	Desvanece la canción que se reproduce hasta que desaparece.	R-FR-E
0x38	fadeinbgm	[velocidad]	Hace sonar gradualmente la canción que se reproduce actualmente (desde mute a volúmen completo)	R-FR-E
0x39	warp	[mapa] [warp_id] [pos_x] [pos_y]	Transporta al jugador al mapa y warp escogidos. Si el warp_id es 0xFF, el jugador será transportado a las coordenadas X e Y dadas.	R-FR-E
0x3A	warpsilent	[mapa] [warp_id] [pos_x] [pos_y]	Exactamente igual a warp. No aplica el sonido del warp.	R-FR-E
0x3B	warpdoor	[mapa] [warp_id] [pos_x] [pos_y]	Exactamente igual a warp. Reproduce el sonido y la animación de una puerta.	R-FR-E
0x3C	warphole	[mapa]	Teletransporta al jugador al mapa indicado con la animación de un agujero.	R-FR-E
0x3D	warpteleport	[mapa] [warp_id] [pos_x] [pos_y]	Exactamente igual a warp. Aplica una animación de teletransporte.	R-FR-E
0x3E	setwarp	[mapa] [warp_id] [pos_x] [pos_y]	Guarda un destino de teletransporte para ser usado más tarde.	R-FR-E
0x3F	setdynamicwarp	[mapa] [warp_id] [pos_x] [pos_y]	Establece el destino del warp dinámico del mapa. (Para hacer un warp dinámico, este debe ir al warp 127 del mapa 127.127).	R-FR-E
0x40	setdivewarp	[mapa] [warp_id] [pos_x] [pos_y]	Establece el lugar de salida del buceo.	R-FR-E
0x41	setholewarp	[mapa] [warp_id] [pos_x] [pos_y]	Establece el destino del jugador cuando sufra un 'warphole'.	R-FR-E
0x42	getplayerxy	[variable_id1] [variable_id2]	Guarda en las variables indicadas las posiciones X e Y del jugador dentro del mapa actual.	R-FR-E
0x43	getpartysize	-	Guarda el número de Pokémon en el equipo del jugador en la variable 0x800D (LASTRESULT).	R-FR-E
0x44	giveitem	[item_id] [cantidad]	Intenta añadir la cantidad del objeto indicado a la mochila. Si lo consigue LASTRESULT será 1, en caso contrario LASTRESULT será 0.	R-FR-E
0x45	takeitem	[item_id] [cantidad]	Elimina la cantidad del objeto indicado de la mochila del jugador.	R-FR-E
0x46	checkitemspace	[item_id] [cantidad]	Comprueba si hay espacio suficiente en la mochila para los objetos indicados. Si hay espacio (LASTRESULT = 1), si no lo hay (LASTRESULT = 0)	R-FR-E
0x47	checkitem	[item_id] [cantidad]	Comprueba si en la mochila hay la cantidad indicada (o más) del objeto escogido. En caso afirmativo (LASTRESULT = 1), si no (LASTRESULT = 0)	R-FR-E
0x48	checkitemtype	[item_id]	Almacena el tipo de objeto (curativo, ball, etc) del objeto indicado en LASTRESULT. Es usado internamente al dar objetos con 'callstd Std_ObtainItem'	R-FR-E
0x49	givepcitem	[item_id] [cantidad]	Almacena en el pc la cantidad y el objeto indicados. En este caso los parámetros pueden ser variables.	R-FR-E
0x4A	checkpcitem	[item_id] [cantidad]	Similar a 'checkitem', pero hace las comprobaciones dentro del pc en lugar de en la mochila.	R-FR-E
0x4B	givedecoration	[decoración_id]	Añade el objeto decorativo indicado al pc del jugador.	R-E
0x4C	takedecoration	[decoración_id]	Elimina el objeto decorativo indicado del pc del jugador.	R-E
0x4D	checkdecor	[decoración_id]	Comprueba si el jugador posee el objeto decorativo indicado.	R-E
0x4E	checkdecorspace	-	Comprueba si el jugador posee espacio suficiente en el pc para más objetos decorativos. En caso afirmativo (LASTRESULT = 1), si no (LASTRESULT = 0).	R-E
0x4F	applymovement	[objeto_id] [movimientos]	Aplica los movimientos indicados en el objeto (overworld) deseado.	R-FR-E
0xFF				R-FR-E

Funciones Standard

Las funciones standard, son una serie de funcionalidades básicas utilizadas por los scripts de los juegos de tercera generación. En total son 11, y están contenidos dentro de gStdScripts en "./data/event_scripts.s".

Función Standard	Descripción
Std_ObtainItem	Mensaje de texto por defecto la obtener un objeto.
Std_FindItem	Mensaje de texto por defecto al encontrar un objeto.
Std_MsgboxNPC	Cuadro de texto mostrado al hablar con un npc.
Std_MsgboxSign	Cuadro de texto mostrado al hablar con un poste.
Std_MsgboxDefault	Cuadro de texto mostrado por defecto.
Std_MsgboxYesNo	Cuadro de texto con opciones "Sí/No"
Std_MsgboxAutoclose	Cuadro de texto que se cierra automáticamente
Std_ObtainDecoration	Mensaje de texto mostrado por defecto al obtener una decoración de la base secreta.
Std_RegisteredInMatchCall	Mensaje de texto mostrado por defecto al registrar alguien en el pokenav (solo ruby y emerald)
Std_MsgboxGetPoints	Mensaje por defecto mostrado al recibir puntos de la torre batalla.
Std_10	Mensaje relacionado con el Pokenav.

Funciones Special

Las funciones special, son una serie de "funciones especiales" que pueden ser llamadas en los scripts. Existen cerca de 500 special diferentes, contenidos en gSpecials, situado en './data/specials.inc'. Las funciones son diferentes dependiendo de la plataforma.