LUA Basico para Blitzkrieg 1

por ElGotele, mayo 2007 traduccin del documento Basic Lessons in Writing Scripts for Blitzkrieg 1 by hitandrun, June 2006

Introduccin Cuando el juego Blitzkrieg se lanz al mercado, el Editor de Mapas y Recursos fueron incluidos como caractersticas extras en el juego. La Ayuda del Editor era limitada y no haba ninguna instruccin para escribir el cdigo que controla las acciones en las misiones personalizadas. Por tanto sacar provecho, del Editor, solo fue posible a traves de los conocimientos compartidos por los jugadores en los diversos foros. Igualmente desentraar el leguaje de programacin, LUA, se consiguio a base de analizar el codigo, prueba y error, y compartir los descubrimientos. Muchas de las personas que han desarrollado la tarea de desentraar LUA, han tenido la costumbre de crear un manual detallado, haciendo mucho ms facil para todos su aprendizaje. Aunque muchos de estos pioneros ya no estn activos en BK1, todo aquel que juega un mapa personalizado o intenta crearlo, deben la posibilidad de hacerlo, al trabajo duro de unos cuantos aficionados que fueron lo suficientemente generosos para compartir sus conocimientos con el resto de la comunidad. Uno de los acontecimientos ms importantes para poner en claro el cdigo de LUA fue la publicacin de Calvin's Blitzkrieg Guide to Programming Lua Function. Esto hizo posible que todo el mundo dispusiera de una lista de los comandos de BK1 y una gua de como usarlos. Como esta guia es necesaria para cualquiera que escriba programas de BK1, DEBE descargarse. La Guia es como un diccionario de LUA, pero eso no proporciona instrucciones precisas de como los comandos se combinan en un programa (Calvin incluye un ejemplo que apenas puede ser definido como introductorio y es mejor no tenerlo en cuenta para cualquier nuevo programador. Calvin's Blitzkrieg Guide to Programming Lua Function puede descargarse desde el portal de Blitzkrieg. Wespex fu el primero en escribir un manual de instrucciones integrado para hacer un mapa, escribir el programa y crear un juego que podra ser compartido con otros jugadores. Este tutorial (reeditado varias veces y en combinacin con la Guia de Calvin) es una buena primera introduccin para cualquiera que quiera hacer mapas personalizados. Despues de la publicacin del tutorial, Wespex edit una serie muy completa de respuestas razonadas paras las preguntas que hacen, quienes escriben programas, en el foro de BK1. La caracterstica ms valiosa, del Tutorial y Repuestas, son las notas explicativas, acompaadas de ejemplos de codigo que no solo proporcionan una plantilla del codigo sino que clarifican como opera el programa. Probablemente es acertado decir que para la inmensa mayoria de las personas que escriben programas, de BK1, han aprendido siguiendo el Tutorial. Estas Lecciones Basicas han sido escritas en respuesta a numeroso comentarios en los foros del portal de Blitzkrieg y a las dificultades, que aparentemente, experimetan muchos creadores de mapas cuando empiezan a escribir sus programas. Las Lecciones Basicas intentan demostrar los principios ms simples de LUA y mostrar como construir un programa dando las bases para construir un mapa personalizado. Intentan hacer esto, al tiempo que desmitifican algunos terminos tecnicos.

Puntos a considerar Como alguien que lleva poco tiempo escribiendo en LUA, estoy familiarizado con el obstaculo que supone empezar y la frustacin que se siente cuando el codigo no funciona correctamente. Sin embargo hay que tener en cuenta algunos puntos: LUA es un lenguaje y es necesario conocer el significado de las palabras y como utilizarlas. Esto no quiere decir que haga falta un trabajo arduo para aprender el vocabulario y la gramatica. Al contrario que en los lenguajes humanos, un pequeo error puede hace que el programa sea completamente inentiligible para el ordenador. La mayor frustacin, cuando se empieza a programar, es cuando despues de escribir un programa, este no funcione. La reaccin ms normal es pensar que el programa no es correcto o que el ordenador no funcionas. En el 99% o 100% de los casos el problema es que hay un error mecanografico o gramatical. Crear un mapa y ver como el programa lo hace empezar a funcionar es muy divertido. Hacer operativo un programa no siempre es divertido. Los mejores programadores de la comunidad BK1 admiten que gastan mucho tiempo poniendo a punto sus creaciones. No todo el mundo tiene la paciencia para escribir un programa, linea a linea, buscar un letra fuera de su sitio, un corchete que falta o un punto y coma de ms. Quien quiera programa tiene que aceptar esto como algo necesario y nadie puede hacer que sea ms facil. Una vez que se ha asimilado lo basico de LUA, la mejor forma de aprender es acceder a una misin con el Editor e ir linea por linea (con una copia de la Guia de Calvin al lado) working out what is going on Cuando se quiera probar alguna funcin nueva prestada de otro progamador, no hay que probarlo en la mitad del gran mapa de 26x 26. Es mejor hacer una prueba creando un mapa de 4x4, con un nmero minimo de unidades y escribiendo un nico bloque de programa con el nuevo codigo. De esta forma si no surte el efecto deseado se puede revisar rpidamente sin tener que comprobar otro codigo, ni creando interferencias con el resto del programa. Este es el metodo que se sigue en las lecciones que siguen. En las ocasiones en que realmente se est en un atasco (despues de utlizar el BKP's Debugging Notes, que acompaa a ests lecciones) se puede buscar en el Foro, muchos de los problemas que se presenten habrn sido reportados anterioremente. Si no se encuentra lo que se busca, se puede realizar una pregunta en Map Making Questions and Answers. Si la pregunta es concreta (acompaada de una copia del codigo afectado) es probable que se obtenga una rapida respuesta de uno de los dioses de las programacin que ayudar, generosamente, a los meros mortales.

Como se trabaja con las Lecciones Basicas Cada una de las lecciones tiene un fichero .bzm con el mapa y un fichero .lua con el codigo del programa, ambos con el mismo nombre. Todos ellos se incluyen con este documento. Tanto los fichros .bzm como los ficheros .lua debe copiarse en la carpeta Blitzkrieg \ Run \ Data \ Maps del ordenador. Es la misma carpeta donde se salvan los mapas y programas personalizados. Para seguir las lecciones es necesario abrir los ficheros .bzm con el Editor y los .lua con el programa SciTe. Una vez que se han repasado las lecciones y revisado el codigo y el mapa, se debe pulsar el botn Run Blitzkrieg en la barra de herramientas del Editor para ver como se ejecuta el programa. Cada uno de las primeras cinco lecciones se fundamenta en lo dicho previamente con el fin de mostrar el desarrollo del mapa y el programa. Las ltimas dos lecciones estn separadas y cubren los temas que a menudo surgen en el Foro de BKP. Estas lecciones se presentan asumiendo que se trabaja con el editor de Blitzkrieg SciTe. La versin actual de este editor es gratuita y su tamao permite descargarlo facilmente desde las paginas de BKP, por lo que no hay ninguna razon para no usarlo. No escribira el programa solo, no encontrar errores en el codigo y no descubrir cuando un programa no va a funcionar correctamente, pero es muy util para escribir y verificar el codigo. Puede descargarse ahora desde este enlace. Blitzkrieg SciTE Editor Nota.- al trabajar con el editor SciTE hay que aadir el sufijo .lua al nombre del fichero, de lo contrario se guardar como .xml.

Principios Basicos El programa se escribe en un fichero .lua. Este fichero se enlaza con el mapa utilizando el botn con una llave inglesa y una letra A en el men general del editor. Un programa contiene una serie de instrucciones, llamadas funciones, las cuales hacen que ocurran cosas cuando se est ejecutando el mapa. Las funciones pueden ser muy simple, haciendo que pase algo concreto en un momento determinado, o mas complejas, probando que se den ciertas condiciones y luego haciendo cosas distintas de acuerdo con el resultado de la prueba. Nota.- Una lista de las funciones especificas de Blitzkrieg se encuentra en el Apendice A Para que las funciones interacten con las unidades del mapa, soldados, vehiculos, edificios.., hay que asignarles un ScriptID en el editor del mapa. Con la pestaa de Objetos seleccionada, se hace doble click en una unidad y aparece la ventana de propiedades (Property), se vuelve a hacer doble click sobre la etiqueta ScriptID y se edita el valor actual (Value) para la unidad. Se escribe directamente el codigo que se quiere asignar a la unidad, cerrando a continuacin la ventana de propiedades. Recomendacin.- Hacer listas de las unidades con sus ScriptID. Algunos creadores de mapas incluyen estas listas como comentarios al principio del programa. Recomendacin.- Es de gran ayuda diferenciar claramente con series distitnas (p.e 1nn jugador y 2nn IA) los nmeros asignados a las unidades del jugador humano de las unidades controladas por la IA. Muchas funciones utilizan ScriptAreas. Estos elementos se definen en el Editor de Mapas utlizando la pestaa Map Tools. Activar el control Script Area Tool y a continuacion arrastrar el cursor sobre el mapa marcando la zona deseada, a continuacin introducir el nombre del area. Al escribir el programa se ha de utilizar el nombre del mapa tal y como se ha escrito en el Editor, respetando mayusculas y espacios. Recomendacin.- Dar a las ScriptAreas nombres significativos a fin de que no se confundan con el texto del programa (p.e Granja y Ciudad no Area1 y Area2). Lenguaje LUA La sintaxis para LUA es simple y consistente. Debe ser respetada exactamente. Cualquier error de ortografia, espaciado o acentuacin tendr como resultado que el programa no funcione correctamente. La mayor parte de los problemas en los programas responden a errores de tecleo o sintaxis. Las palabras siguientes tienen un significado especial en LUA, son conocidas como palabras clave: and if in repeat break end local return do false nil then else for not true elseif function or until

while

No tiene relevancia lo que significan estas palabras en el mundo real, en LUA tienen un uso determinado, enlazando las funciones del lenguaje y solo pueden ser utilizadas de esta forma. El uso de algunas de estas palabras se clarifica en estas Lecciones Basicas. Por convencin las palabras clave se escriben siempre en minuscula. Hay tambien algunas palabras clave como RunScript, LandReinforcement, Win y Loose. Estas hay que escribirlas con la inicial en mayusculas y el resto de la palabra en minusculas, sin separacin entre las palabras cuando van ms de dos juntas. La Guia de Calvin es el diccionario para aprender la forma correcta de escribirlas. Recomendacin.- Si se utiliza el editor SciTE todas las palabras clave aparecern en azul sobre un fondo azul claro cuando hayan sido escritas correctamente.

Los nombre de las cosas (funciones) que define el programador son denominados nombres (names). Pueden componerse con nmeros y letras, aunque no pueden empezar con un nmero. Por conveccin la primera letra debe ir en mayuscula. Por ejemplo en la leccin 1 se escribe la function MoveCar(). Donde function es la palabra clave y MoveCar es el nombre. Recomendacin.- Si se utliza el editor SciTE los nombres (names) aparecern en negrita. Una vez que un nombre (name) ha sido definido como funcin, puede ser llamado a lo largo del programa, pero cuando se escriba esa llamada el nombre (name) debe ir entre comillas. Por ejemplo en la leccin 1 cuando se hace la llamada a la funcin MoveCar se escribe RunScript(MoveCar, 3000), donde RunScript es una palabra clave de BK1 y MoveCar es una cadena de caracteres (string) que se aplica a una funcin que ha sido definida en otra parte del programa. Es esencial que las cadenas de caracteres (string) sean escrito tal y como se escribieron al definir la funcin, en caso contrario el programa no los reconocer. Por eso puede ser conveniente utilizar las funciones de copia y pegar, evitando asi los errores mecanograficos. No puede haber espacios entre las comillas y el nombre (name). Recomendacin.- Si se utliza el editor SciTE las cadenas de caracteres (string) aparecern en color purpura cuando las comillas estn correctamente situadas. Si el color purpura se extiende mas alla de la cadena de caracteres indica que falta una de las comillas. SciTE no controla si la cadena de caracteres se ha escrito correctamente. Las funciones y palabras claves estn calificadas por parmetros. Para entender la idea de parametro de la funcin o palabra clave hay que pensar en alguien diciendo a otro Haz. Pero hacer que?, por si sola la expresin Haz no tiene sentido si no se acompaa de otra condicin que determine que es lo que hay que hacer. Estas condiciones calificativas son los parmetros. En LUA los parmetros se especifican siempre entre parentesis y separados por comas, marcar esta separacin es muy importantes y el programa no funcionar si esta no se escribe. En el ejemplo RunScript(MoveCar, 3000), la palabra clave RunScript necesita saber cual es la funcin a ejecutar y cuando debe hacerlo. Por tanto los parmetros son la cadena de caracteres MoveCar y el valor 3000, el significado de este ltimo se explica ms adelante. Recomendacin.- Si se utliza el editor SciTE los parmetros que corresponden a valores se visualizan en color azul. Algunas palabras clave y funciones no necesitan de parmetros, son autoexplicativa para el programa y no han de calificarse. En este caso sigue siendo necesario escribir los parentesis, aunque sin nada entre ellos. p.e., suicide(). La falta de uno o de los dos parentesis har que el programa no funcione correctamente. Las sangrias son muy utilizadas por los programadores pero no son necesarias y no tienen ningn efecto sobre el programa. Es una forma muy util de organizar el codigo y hacer ms clara su lectura. Cada programador tiene, o puede tener su propio estilo de identar (sangrar) el texto. Por convencin cada linea de texto finaliza con un punto y coma, excepto cuando una palabra clave opera en la/s linea/s siguientes a la que est escrita como en well covered en la leccin 3. Los comentarios son incluidos en el texto del programa para anotar aclaraciones y documentar el codigo. Un comentario comienza y finaliza con dos guiones seguidos (--comentario--). Los comentarios no son leidos por el programa. Por consiguiente anotando dos guiones al principio y final de una linea de programa hace que esta sea desactivada lo que puede ser muy util para hacer pruebas. Recomendacin.- Si se utliza el editor SciTE los comentarios se visualizan en color verde.

Leccin 1.- Escribiendo una funcin y ejecutandola Esta leccin hara que una unidad se mueva desde el punto donde se encuentra a otro determinado. Leccin 1 .- Mapa (.bzm) Hay un coche con el ScriptID=100 (doble click sobre la unidad para ver el valor del ScriptID) y un edificio hacia el cual se mover el coche. Leccin 1 .- Programa (.lua)
function MoveCar() Cmd(0, 100, 916, 1516); Suicide(); end; function Init() RunScript("MoveCar", 3000); end;

Nota.- El codigo ejecutable est empaquetado en los archivos .lua y se puede copiar y pegar en los programas que se estn realizando. Nunca deben escribirse programas en Word ya que llevan codigos embebidos que pueden hacer inoperativo el codigo a la hora de ejecutarlo. Explicacin
function MoveCar()

Establece el nombre de la funcin MoveCar, que posteriormente ser llamada por el programa.
Cmd(0, 100, 916, 1516);

Da la orden de movimiento (0) a la unidad (ID 100), hasta la posicin x, y (916 este, 1516 norte).
Suicide();

Dice al programa que la funcin debe interrumpirse y no continuar ejecutandose.

end;

Finaliza una parte del programa, en este caso la funcin MoveCar.

function Init()

Esta el la funcin INICIAL del programa, todos deben tener una funcin Init o el programa no arrancar.
RunScript("MoveCar", 3000);

Hace que se ejecute una parte del programa, en este caso la funcin MoveCar y adems dice cuando debe ejecutarse (3000 milisegundos, 3 segundos, despues de arrancar el programa.
end;

Finaliza una parte del programa, en este caso la funcin Init. Nota.- Una lista de los comandos que pueden utilizarse y la forma de usarlos est descrita en la Guia Calvin.

Leccin 2.- Adicionando una segunda funcin con multiples comandos Esta leccin har que una segunda unidad realize una serie de movimientos en momentos distintos a los de la primera unidad. Leccin 2 .- Mapa (.bzm) Hay un coche con ScriptID=100, el de la leccin anterior, un camin con ScriptID=101, y un arbol y un monumento hacia el que el camin se dirigir pasando alrededor del edificio. Leccin 2 .- Programa (.lua)
function MoveCar() Cmd(0, 100, 916, 1516); Suicide(); end; function MoveTruck() Cmd(0, 101, 1583, 223); QCmd(0, 101, 1890, 1570); QCmd(0, 101, 1100, 1890); Suicide(); end; function Init() RunScript("MoveCar", 3000); RunScript("MoveTruck", 7000); end;

Explicacin
function MoveCar() Cmd(0, 100, 916, 1516); Suicide(); end; function MoveTruck()

Una nueva funcin definida de la misma forma que la anterior pero con un nuevo nombre.
Cmd(0, 101, 1583, 223);

La orden de movimiento (0) es la misma que para el coche pero con el ScriptID de el camin (101), tambien son diferentes las coordenadas que indican el destino.
QCmd(0, 101, 1890, 1570);

QCmd es un comando similar a Cmd pero con la particularidad de que solo se ejecuta una vez finalice el comando previo. Esta orden tambien se dirige al camin (101) y lo envia al nuevo destino que marcan coordenadas.
QCmd(0, 101, 1100, 1890); Suicide(); end; function Init() RunScript("MoveCar", 3000); RunScript("MoveTruck", 7000);

La instruccin para ejecutar la nueva funcin se aade a la funcin de inicio (Init), pero esta vez se ejecutar 7 segundos despues de que arranque el programa.
end;

Nota.- La segunda funcin tambien podra comenzar en la primera como se muestra a continuacin. Esta tecnica se usa a menudo cuando se quiere que la segunda funcin no comience antes de que llame desde la primera. Es mejor no tener multiples funciones ejecutandose (utilizando potencia del procesador) y solo se arrancan cuando sean necesarias.

.lua Script
function MoveCar() Cmd(0, 100, 916, 1516); RunScript("MoveTruck", 4000); Suicide(); end; function MoveTruck() Cmd(0, 101, 1583, 223); QCmd(0, 101, 1890, 1570); QCmd(0, 101, 1100, 1890); Suicide(); end; function Init() RunScript("MoveCar", 3000); end;

Explicacin
function MoveCar() Cmd(0, 100, 916, 1516); RunScript("MoveTruck", 4000);

La segunda funcin se llama ahora desde aqu. Para hacer que el movimiento del camin se produzca 7 segundos despues de que el juego arranque es necesario cambiar el parametro de tiempo a 4000 porque la funcin MoveCar ya arranca 3 segundos depues del inicio del juego.
Suicide(); end; function MoveTruck() Cmd(0, 101, 1583, 223); QCmd(0, 101, 1890, 1570); QCmd(0, 101, 1100, 1890); Suicide(); end; function Init() RunScript("MoveCar", 3000);

El comando para arrancar la funcin MoveTruck no debe figurar ahora en la funcin Init.
end;

Leccin 3.- Comprobando una condicin En esta leccin se comprueba si una condicin se ha cumplido y se arranca una accin nueva dependiendo de la respuesta. Este es un proceso muy til y muy utilizado en los mapas de Blitzkrieg. Leccin 3 .- Mapa (.bzm) Este es el mismo mapa de la leccin 2 con un ScriptArea llamado Farm, marcado alrededor del edificio y dos pelotones de refuerzos con los ScriptID 103 y 104. Ambos forman parte del grupo de refuerzo (reinforcement group) 103. Pulsando en el Editor en la pestaa Reinforcement Groups y seleccionado la etiqueta GroupN103, se visualiza en la ventana Group Property los ScriptID de las dos unidades. Esta disposicin permite dar ordenes diferentes a cada una de las unidades o bien al grupo completo. El edificio ahora tiene el ScriptID 10. Leccin 3 .- Programa (.lua)
function MoveCar() Cmd(0, 100, 916, 1516); RunScript("MoveTruck", 4000); Suicide(); end; function MoveTruck() Cmd(0, 101, 1583, 223); QCmd(0, 101, 1890, 1570); QCmd(0, 101, 1100, 1890); Suicide(); end; function FarmCheck() if GetNUnitsInArea(0, "Farm") == 2 then RunScript("SquadArrive", 1000); Suicide(); end; end; function SquadArrive() LandReinforcement(103); RunScript("SquadMove", 2000); Suicide(); end; function SquadMove() Cmd(0, 103, 1530, 1320); Cmd(6, 104, 10); Suicide(); end; function Init() RunScript("MoveCar", 3000); RunScript("FarmCheck", 2000); end;

Explicacin Unicamente los nuevos elementos del programa sern presentados y explicado a partir de ahora.
function FarmCheck() if GetNUnitsInArea(0, "Farm") == 2 then

if es una palabra clave que se utiliza para comprobar una condicin y devuelve uno de las dos posibles respuestas: Verdadero (True) o Falso (False). En este caso la condicin comprobada es el nmero de unidades en el area. GetNUnitInArea es el parmetro para saber cuantas unidades (0 es el codigo del jugador al que pertenecen las unidades) y el segundo parmetro especifica cual es el area a comprobar (Farm, no deben olvidarse las comillas). La condicin es ==2, es decir que se pregunta si el nmero de unidades en el area es igual a 2 (ver la Nota al final de

esta leccin para conocer los simbolos que pueden utilizarse). then es una palabra clave que indica que la respuesta obtenida es verdadera (true), es decir la condicin se cumple. Como then opera en la/s proxima/s linea/s del codigo no es necesario finalizarla con punto y coma (;).
RunScript("SquadArrive", 1000);

La consecuencia de que se cumpla la condicin es el arranque de otra funcin (ScuadArrive). Si la respuesa no fuese verdadera (False) esta funcin no arrancara ni tampoco se ejecutara la palabra clave Suicide(), aunque el programa seguira ejecuatandose.
Suicide(); end;

Este end finaliza el if. Como regla es necesario un end para cada if, ms uno para la finalizar la funcin.
end;

Este end finaliza la funcin.

function SquadArrive() LandReinforcement(103);

Este comando llama al grupo de refuerzo 103, para que aparezca en el mapa.
RunScript("SquadMove", 2000); Suicide(); end; function SquadMove() Cmd(0, 103, 1530, 1320);

Este comando hace que la unidad 103 se mueva (0), a la posicin de las coordenada 1530, 1320.
Cmd(6, 104, 10);

Este comnado hace que la unidad 104 entre (6) en el edificio 10.
Suicide(); end; function Init() RunScript("MoveCar", 3000); RunScript("FarmCheck", 2000);

Este comnado ejecuta la funcin FarmCheck 2 segundos despues del inicio del juego. Debido a que en esta funcin hay una condicin al inicio de la misma, hasta que no se cumpla la condicin no tendrn efecto las acciones que dependen de la condicin. Recomendacin.- Si se utliza el editor SciTe, este coloca un guin a la izquierda de cualquier linea que requiera una sentencia end;. En los ejemplos se emplazan todos los end a la izquierda para facilitar el que se escriban todos. Nota.- En las funciones condicionales los simbolos que se pueden utilizar son los siguientes: a == b a>b a<b a >= b a <= b a ~= b a es igual que b a es mayor que b a es menor que b a es mayor o igual que b a es menor o igual que b a no es igual que b

Nota.- Esta funcin es muy util ya que representa una gran ayuda para las pruebas
function DebugView Password("Panzerklein"); DisplayTrace("any text you like"); ShowActiveScripts(); -- God(0, 2); Suicide(); end;

function Init() Runscript(DebugView, 1000); end; Explicacin function DebugView Password("Panzerklein");

Este comando hace que las otras sentencias se ejecuten. Nota.- Si se ejecuta Blitzkrieg con el fichero ailogic.dll de Stalingrad (la unidades se han modificado para que puedan hacer fuego a travs de los edificios) se debe utilizar el comando Password(www.dtf.ru).
DisplayTrace("cualquier texto");

Visualiza, durante el juego, el texto que est entre las comillas. Se utiliza aqu porque esta funcin arrancar al inicio del juego, por tanto si no se visualiza es que el progrma no arranca.
ShowActiveScripts();

En el modo consola, durante el juego, se visualizar el texto de las sentencias del programa que se estn ejecutando. Para activar el modo consola cuando Blitzkrieg est activo pulsar el tabulador.
-- God(0, 2);

Este comando es un truco. El parametro 0 indica el jugador sobre el que tendr efecto y el parmetro 2 especifica que sus fuerzas pueden matar al contrario de un golpe y que no pueden ser daadas por las fuerzas del otro jugador. Se requiere una contrasea para ejecutarse. Los dos guiones delante indican que actualmente la sentencia es inactiva y ser considerada un comentario por el programa. Para hacerla operativa (en pruebas) eliminar los dos guiones y salvar el fichero.
Suicide(); end; function Init() Runscript(DebugView, 1000); end;

DebugView debe ser arrancada desde la funcin Init sin que esta contenga ninguna otra funcin. Nota.- Al utilizar DisplayTrace el mensaje a visualizar debe ir entre comillas doble (), por tanto no deben incluirse dobles comillas en el contenido del mensaje. Para resaltar alguna palabra deben utilizarse simples comillas (').

Leccin 4.- Utilizando los Objetivos Esta leccin trata del uso de los Objetivos y Variables. Objectives are the triggered to appear by the script pero el texto que nombra el objetivo y la colocacin de la flecha que lo sealan en el minimapa son gestionados por el Editor de Recursos. Como definir y salvar objetivos se explica en otro momento, esta leccin se centra en sealar los objetivos y en presentar el mensaje de Objetivos Completados. Las Variables Globales guardan los datos que posteriormente pueden ser utilizados. En esta leccin solo utilizaremos las Variables Globales, otros tipos de variables se detallan en la Guia de Calvin. Leccin 4 .- Mapa (.bzm) Est basado en el mapa de la Leccin 3 con las escuadras enemigas de la IA (jugador 1) en una trinchera, y una nueva ScriptArea llamada Trench. Leccin 4 .- Programa (.lua) En este programa se han sealado las nuevas funciones y comandos con una nota (--NEW--). function DebugView() -- NEW -Password("Panzerklein"); DisplayTrace("Amazing! This really works"); ShowActiveScripts(); --God(0, 2); Suicide(); end; function MoveCar() Cmd(0, 100, 916, 1516); RunScript("MoveTruck", 4000); Suicide(); end; function MoveTruck() Cmd(0, 101, 1583, 223); QCmd(0, 101, 1890, 1570); QCmd(0, 101, 1100, 1890); RunScript("ReavealObjective0", 10000); -- NEW -Suicide(); end; function ReavealObjective0() -- NEW -ObjectiveChanged(0, 0); DisplayTrace("Off we go"); RunScript("Objective0Check", 2000); -- NEW -RunScript("Objective0Complete", 3000); -- NEW -Suicide() end; function FarmCheck() if GetNUnitsInArea(0, "Farm") == 2 then RunScript("SquadArrive", 1000); Suicide(); end; end; function SquadArrive() LandReinforcement(103); RunScript("SquadMove", 2000); Suicide(); end; function SquadMove() Cmd(3, 103, 2530, 2850); Cmd(6, 104, 10);

Suicide(); end; function Objective0Check() -- NEW -if GetNScriptUnitsInArea(130, "Trench") >=1 then SetIGlobalVar("Mission0", 1); Suicide(); end; end; function Objective0Complete() -- NEW -if GetIGlobalVar("Mission0", 0) == 1 then ObjectiveChanged(0, 1); Suicide() end; end; function Init() RunScript("DebugView", 1000); RunScript("MoveCar", 3000); RunScript("FarmCheck", 2000); end;

Explicacin
function ReavealObjective0() -- NEW -ObjectiveChanged(0, 0);

Los parametros especifican cual es el objetivo (0), y cual es el cambio, en este caso mostrarlo (0).
DisplayTrace("Vamos");

Se visualiza un mensaje con el texto entrecomillado. Puede omitirse.

RunScript("Objective0Check", 2000); -- NEW

Ejecuta la funcin que comprueba una condicin. En este caso si hay unidades con ScriptID=130 en el area Trench.
RunScript("Objective0Complete", 3000); -- NEW

Arranca la funcin que comprueba si el objetivo ha sido completado y si es asi muestra un mensaje.
Suicide() end; function Objective0Check() -- NEW -if GetNScriptUnitsInArea(130, "Trench") >=1 then

Funcin distinta a GetNUnitsInArea, con esta se comprueba si algn miembro de una unidad especifica (ScriptID =130) est dentro del area Trench.
SetIGlobalVar("Mission0", 1);

Cuando se utiliza esta palabra clave se crea y salva una variable con el nombre y el valor especificados en los parmetros, en este caso el nombre = Mission0 y el valor = 1. Tel valor puede ser cualquier nmero entero.
Suicide(); end; end;

Dos end debido a que esta funcin contiene un if.

function Objective0Complete() -- NEW -if GetIGlobalVar("Mission0", 0) == 1 then

Esta palabra clave devuelve los parmetros previamente salvados por SetIGlobalVar. El primer parmetro es el nombre de la variable global salvada y el segundo es siempre cero (0). En resumen esta lnea evoca el valor de la variable que llamada Mission0 y comprueba si su valor corresponde a 1. Si la respuesta es cierta (true) la siguiente sentencia de la rutina se ejecutar. Si la respuesta no es cierta (false) el programa saltar hasta la linea siguiente al

end que corresponde a este if y continuar la ejecucin del programa.

ObjectiveChanged(0, 1);

Los parametros (0, 1) indican, el primero el nmero del objetivo 0 y el segundo establece que ha sido completado 1.
Suicide() end; end;

Nota.- No es necesario utilizar Variables Globarles para lanzar el mensaje de Objetivo Completado, pero se utilizan, a menudo, para comprobar si todos los objetivos de la misin han sido completados de la forma que se ver ms adelante. Una posible alternativa para comprobar si el objetivo ha sido alcanzado sera:
function Objective0Check() -- NEW -if GetNScriptUnitsInArea(130, "Trench") >=1 then ObjectiveChanged(0, 1); Suicide(); end; end;

Leccin 5.- Uniendo todas las piezas Esta leccin pone en prctica las lecciones previas con condiciones para los objetivos, diferentes tipos de pruebas y multiples refuerzos. Se explica el uso de if ... else y if... elseif. Se aaden las condiciones Win y Loose y las llamadas a Variables Globales para probar si se cumplen las condiciones esperadas. Puede ser la base para muchas misiones con la utilizacin repetida de las pruebas en las diferentes ScriptAreas y con los distintos ScriptIDs. Leccin 5 .- Mapa (.bzm) Basado en el mapa de la Leccin 4 Leccin 5 .- Programa (.lua)
function DebugView() Password("Panzerklein"); DisplayTrace("Lua realmente no da ningn miedo!"); ShowActiveScripts(); --God(0, 2); Suicide(); end; function MoveCar() Cmd(0, 100, 916, 1516); RunScript("MoveTruck", 4000); Suicide(); end; function MoveTruck() Cmd(0, 101, 1583, 223); QCmd(0, 101, 1890, 1570); QCmd(0, 101, 1100, 1890); RunScript("ReavealObjective0", 10000); Suicide(); end; function ReavealObjective0() ObjectiveChanged(0, 0); DisplayTrace("Vamos"); RunScript("Objective0Check", 2000); RunScript("Objective0Complete", 3000); Suicide() end; function FarmCheck() if GetNUnitsInArea(0, "Farm") == 2 then RunScript("SquadArrive", 1000); Suicide(); end; end; function SquadArrive() LandReinforcement(103); RunScript("SquadMove", 2000); Suicide(); end; function SquadMove() Cmd(3, 103, 2530, 2850); Cmd(6, 104, 10); Suicide(); end; function Objective0Check() if GetNScriptUnitsInArea(103, "Trench") >= 1 then SetIGlobalVar("Mission0", 1); Suicide();

end; end; function Objective0Complete() if GetIGlobalVar("Mission0", 0) == 1 then ObjectiveChanged(0, 1); RunScript("Objective1", 2000); -- NEW -Suicide(); end; end; function Objective1() -- NEW -ObjectiveChanged(1, 0); RunScript("Objective1Complete", 3000); DisplayTrace("Eliminar a todos los americanos del area"); LandReinforcement(105); Cmd(3, 105,2335, 3015); RunScript("HeavyArmourDeploy", 30000); Suicide(); end; function Objective1Complete() -- NEW -if GetNUnitsInParty(1) <= 3 then ObjectiveChanged(1, 1); SetIGlobalVar("Mission1", 1); Suicide(); end; end; function HeavyArmourDeploy() -- NEW -LandReinforcement(106); RunScript("HeavyArmourMove", 2000); Suicide(); end; function HeavyArmourMove() -- NEW -if GetNUnitsInArea(1, "Trench") > 0 then Cmd(3, 106, GetScriptAreaParams(Trench)); else Cmd(3, 106, 393, 3777); Suicide(); end; end; function USCounterattack() -- NEW -if GetNUnitsInArea(1, "Trench") <= 20 then RunScript("USTanks", 3000); Suicide(); end; end; function USTanks() -- NEW -LandReinforcement(200); Suicide(); end; function WinLoose() -- NEW -if GetIGlobalVar("Mission0", 0) * GetIGlobalVar("Mission1", 0) == 1 then Win(0); elseif GetNUnitsInScriptGroup(103) + GetNUnitsInScriptGroup(105) +GetNUnitsInScriptGroup(106) == 0 and GetIGlobalVar("Mission0", 0) == 1 then Loose(0); Suicide();

end; end; function Init() RunScript("DebugView", 1000); RunScript("MoveCar", 3000); RunScript("FarmCheck", 2000); RunScript("USCounterattack", 2000); --NEW-RunScript("WinLoose", 3000); --NEW-end;

Explicacin
function Objective1() -- NEW -ObjectiveChanged(1, 0);

Como pasaba con el Objetivo 0 explicado en Leccin 4, esta palabra clave provoca que aparezca el mensaje de objetivo 1 y la flecha que lo seala en el minimapa.
RunScript("Objective1Complete", 3000);

Arranca la funcin (a los 3 segundos de iniciar el juego) que comprueba si el objetivo 1 ha sido completado.
DisplayTrace("Eliminar a todos los americanos del area");

Visualiza el mensaje con el texto entrecomillado. Podra omitirse si la funcin anterior determinara que el juego ha terminado.
LandReinforcement(105);

Funcin que hace entrar los refuerzos de AFVs ligeros (ScriptGroup=105).

Cmd(3, 105, 2335, 3015);

Mueve, de forma agresiva (3), el grupo de refuerzo (105) a la nuevas coordenadas x, y.

RunScript("HeavyArmourDeploy", 30000);

Arranca la funcin HeavyArmourDeploy despues de 30 segundos (30000 milisegundos).

Suicide(); end; function Objective1Complete() -- NEW -if GetNUnitsInParty(1) <= 3 then

Comprueba si el nmero de unidades enemigas, manejadas por la IA (1) es menor o igual a 3.

ObjectiveChanged(1, 1);

Si la condicin comprobada es cierta (True) el objetivo 1 est ha sido completado.

SetIGlobalVar("Mission1", 1);

Adems, al cumplirse la condicin, este comando crea y salva una variable con el nombre y el valor especificados en los parmetros, en este caso el nombre es Mission1 y el valor es 1.
Suicide(); end; end; function HeavyArmourDeploy() -- NEW -LandReinforcement(106);

Esta funcin hace entrar en el juego a los tanques (ScriptGroup=106).

RunScript("HeavyArmourMove", 2000);

A los 2 segundos de juego arranca la funcin que hace moverse a los tanques.
Suicide(); end; function HeavyArmourMove() -- NEW -if GetNUnitsInArea(1, "Trench") > 0 then

Comprueba si quedan unidades de la IA en el area Trench.

Cmd(3, 106, GetScriptAreaParams(Trench));

Si la respuesta de la condicin es verdadera, los tanuqes (ScriptGroup 106) se mueven en formacin de ataque (3) a las coordenadas del ScriptArea Trench.
else Cmd(3, 106, 393, 3777);

else por el contrario si la respuesta de la condicin anterior no es verdadera, (a menudo no existe la posibilidad de preguntar para obtener directamente una respuesta falsa por lo que hay que utilizar else), en este caso los tanques se movern a las coordenadas x, y (393, 3777).
Suicide(); end; end; function USCounterattack() -- NEW -if GetNUnitsInArea(1, "Trench") <= 20 then RunScript("USTanks", 3000); Suicide(); end; end; function USTanks() -- NEW -LandReinforcement(200); Suicide(); end; function WinLoose() -- NEW if GetIGlobalVar("Mission0", 0) * GetIGlobalVar("Mission1", 0) == 1 then

En esta condicin se comprueban si las dos misiones han sido completadas (1 multiplicado por 1 debe es igual a 1) Las variables globales Mission0 y Mission 1 habrn actualizados sus valores a 1 al completarse.
Win(0);

Si la respuesta a la condicin es verdaedera (True) el jugador 0 gana y el mensaje You Win es visualizado.
elseif GetNUnitsInScriptGroup(103) + GetNUnitsInScriptGroup(105) +GetNUnitsInScriptGroup(106) == 0 and

Si la respuesta a la primera condicin no es verdadera (False) entonces elseif se plantea una segunda condicin que comprueba si todas las unidades del jugador humano han sido eliminadas. La utilizacin de la palabra clave and une esta condicin con otra y ambas deben ser ciertas (True) para que el resulatado de la condicin sea verdadero.
GetIGlobalVar("Mission0", 0) == 1 then

Comprueba si el primer objetivo ha sido completado. Esta comprobacin es necesaria debido a que al funcin WinLoose() se est ejecutando durante todo el juego (arranca en la funcin Init) y los refuerzos de los jugadores no deben llegar hasta que el primer objetivo est completo. Por tanto sin esta comprobacin adicional la funcin se ejecutara 3 segundos despues de empezar el juego, su objetivo es que los refuerzos pendientes de llegar sean igual a 0 antes de ejecutar la siguiente linea.
Loose(0);

Si la respuesta de la segunda condicin es verdadera (True) el jugador humano pierde y el mensaje You Lost se visualiza.
Suicide(); end; end;

Dos end debido a que esta funcin contiene un if, pero solamente dos ya que elsif no supone una nueva condicin logica, es unicamente la respuesa falsa (False) a un if.
function Init() RunScript("DebugView", 1000); RunScript("MoveCar", 3000); RunScript("FarmCheck", 2000); RunScript("USCounterattack", 2000); --NEW-RunScript("WinLoose", 3000); --NEW-end;

Nota.- La funcin WinLoose podra haber sido escrita tambien de la siguiente forma:
function WinLoose() -- NEW -if GetIGlobalVar("Mission0", 0) * GetIGlobalVar("Mission1", 0) == 1 then Win(0); if GetNUnitsInScriptGroup(103) + GetNUnitsInScriptGroup(105) +GetNUnitsInScriptGroup(106) == 0 and GetIGlobalVar("Mission0", 0) == 1 then Loose(0); Suicide();

end; end; end;

Tres end, uno por cada condicin if ms otro por la funcin.

Leccin Aviones Esta leccin muestra como utilizar la programacin para llamar a la aviacin en respuesta a un evento del mapa. Leccin Aviones .- Mapa (.bzm) Esta es una posicin defensiva rodeada por el MapArea llamada Bunker. La aviacin ha sido asignada al jugador humano utilizando la opcin Edit Units Creation del Editor de Mapas (parece que adecuadamente no estoy seguro un tipo de hongo cabeza abajo). Hacer clic en el botn del avin para desplegar el men, clic de nuevo en el simbolo + del Player [0], clic en el simbolo + de Aviation. Seleccionar el tipo de avin y cuantos aviones de cada tipo seleccionado, de esta forma se definen las unidades que sern utilizadas. Lo ms importante es seleccionar el Punto de aparicin, debe ser establecido para poder utilizar la aviacion. Hacer doble clic en la linea Appear points y seleccionar Add. A continuacin deben introducirse los valores de las coordenadas x, y donde los aviones deben aparecer. Notese que estos valores se introducen como coordenadas VIS y no como coordenada Script (en la parte inferior de la pantalla, del editor, se visualizan los valores de ambos sistemas de coordenadas). Una vez seleccionado el punto de aparicin, cerrar el menu desplegable. Leccin Aviacin .- Programa (.lua)
function DebugView() Password("Panzerklein"); DisplayTrace("Here come the planes"); ShowActiveScripts(); --God(0, 2); Suicide(); end; function PlaneTrigger() if GetNUnitsInArea(1, "Bunker") >= 1 then Cmd(36, 999, 0, 1100, 2070); -- Cmd(36, 999, 0, GetScriptAreaParams("Bunker")); Suicide(); end; end; function Init() RunScript("DebugView", 1000); RunScript("PlaneTrigger", 3000); end;

Explicacin
function PlaneTrigger() if GetNUnitsInArea(1, "Bunker") >= 1 then

Esta condicin comprueba si el nmero de unidades de la IA, en el area Bunker es igual o mayor que 1.
Cmd(36, 999, 0, 1100, 2070);

Este comando llama a la aviacin (36) con el codigo de ataque a tierra (ver la Guia Calvin para una lista completa), la ID 999 es una identificacin temporal para la aviacin (podra ser cualquier nmero pero por convencin los creadores de mapas reservan los nmeros 99, 999, 9999 para la aviacin), 0 es el codigo que identifica al jugador, 1100, 2070 son las coordenadas del punto del mapa por donde aparecern los aviones (en coordenadas Script)
-- Cmd(36, 999, 0, GetScriptAreaParams("Bunker"));

Esta linea no se utiliza por tener dos guiones al principio. Es una alternativa para llamar a los aviones, en lugar de enviarlos a las coordenadas x,y determinadas, se envian a las coordenadas que corresponden al ScriptArea Bunker.
Suicide(); end; end;

Dos end, uno por el if y el otro por la funcin.

Leccin Patrulla Esta leccin muestra como crear una ruta de patrulla. En el ejemplo solamente una unidad compone la patrulla, pero pueden incluirse cualquier nmero de unidades. Si la/s unidad/es que componen la patrulla tienen capacidad de ataque, se enfrentarn a las unidades enemigas que encuentren y una vez finalizado el combate continuarn con la patrulla (si sobreviven). Leccin Patrulla .- Mapa (.bzm) En el mapa hay una tanqueta de reconocimiento con ScriptID 100, dentro del ScriptArea Starting Point. Leccin Patrulla .- Programa (.lua) Nota.- Este programa fue creado por Wespex en respuesta a un pregunta den los foros del Portal Blitzkrieg, adems se incluye una forma alternativa de conseguir el mismo objetivo.
function PatrolArea() if GetNScriptUnitsInArea(100, "Starting Point") > 0 then Cmd (3, 100, 765, 681); QCmd (3, 100, 288, 356); QCmd (3, 100, 545, 1145); QCmd (3, 100, 299, 1807); QCmd (3, 100, 1631, 1479); QCmd (3, 100, 1351, 647); RunScript("PatrolArea", 2000); Suicide(); end; end; function Init() RunScript("PatrolArea", 5000); end;

Explicacin
function PatrolArea() if GetNScriptUnitsInArea(100, "Starting Point") > 0 then

Se comprueba que la unidad de patrulla (ScriptID 100), existe y se encuentra en su posicin inicial (ScriptArea Starting Point).
Cmd (3, 100, 765, 681);

Orden de movimiento en modo de ataque (3) para la unidad (100) hasta las coordenadas (x=765, y=681).
QCmd (3, 100, 288, 356);

Orden de movimiento en modo de ataque (3) para la unidad (100) hasta las coordenadas (x=288, y=356) una vez que se ha completado la orden de anterior (QCmd).
QCmd (3, 100, 545, 1145);

Igual que la anterior. Igual que la anterior.

QCmd (3, 100, 299, 1807); QCmd (3, 100, 1631, 1479);

Igual que la anterior.

QCmd (3, 100, 1351, 647);

Igual que la anterior pero como este es la ltima orden de movimiento las coordenadas de destino debe estar en el interior del ScriptArea Starting Point.
RunScript("PatrolArea", 2000);

Vuelve a ejecutar de nuevo la funcin. Suicide(); end; end; Dos end, uno por el if y el otro por la funcin. Nota.- Una patrulla puede tener cualquier nmero de movimientos en cada circuito, simplemente aadiendo o quitando lineas Qcmd(3, ScriptID, x, y). Lo importante es que el ltimo movimiento deje a la unidad de patrulla dentro del ScriptArea que es comprobada en la primera lnea de la funcin.

Depurando el programa Depurar es el proceso de encontrar y eliminar errores en el codigo. En el mundo de la programacin los pasos a realizar para depurar un programa son: Reconocer que existe un error. Aislar la fuente (las lineas de codigo) del error. Identificar la causa del error. Determinar un arreglo para el error. Aplicar el arreglo del error. Los programas necesitan ser depurados si tienen cualquier imperfeccin, esto es, si no se comporta como se espera. Un programa tendr problemas cuando cualquiera de los objetivos planteados en el codigo no se cumpla como se espera en ejecucin del juego. Es aconsejable incluir alguna sentencia DisplayTrace en la funcin Init que visualice un texto parecido a Programa en ejecucin.... . Si el programa es correcto este mensaje se visualizar inmediatamente. Si no aparece el programa tiene problemas que impiden su ejecucin. La sentencia puede ser eliminada, o dejada como comentario, una vez que el codigo est libre de errores. Consejo 1 Cuando un programa no se ejecute adecuadamente no es necesario salir de Blitzkrieg. Se puede volver a Windows, manteniendo la ejecucin en segundo plano, depurar y editar el programa, salvarlo y entonces seleccionar Restart Mission, opcin que vuelve a iniciar la ejecucin del programa desde el inicio. Nota.- Esta opcin no funcionar si el fichero del programa se encuentra dentro de un fichero .pak ya que estos ficheros estn bloqueados cuando el editor y/o el juego estn activos. Consejo 2 No incluir el mapa en un fichero .pak hasta que no est completamente depurado. Cualquier mapa que sea abierto, con el Editor, estando almacenado en un fichero .pak es salvado directamente en la carpeta Data del editor y puede, facilmente, quedar excluido del .pak a menos que el programador se acuerde de incluir los ficheros modificados. Al depurar los programas es necesario chequear los errores ms comunes: Funciones que no tienen un end al final. Lineas de comentarios con un solo guion en lugar de los dos que son necesarios. Bloque de comprobacin que no tienen su propio end al final. Por ejemplo:
function CheckTown() if GetNUnitsInArea(0, "Town") == 0 then ObjectiveChanged(0,1); RunScript( "Objective1", 5000); end;

El codigo anterior es erroneo debido a que al bloque "if GetNUnits..." le falta el end. Cada bloque requiere su proio end. Uso incorrecto de mayusculas / minusculas: el comando if debe ir en minusculas, no es correcto teclear If. Sentencias no finalizadas con punto y coma ;. Esta regla no aplica a las funciones y palabras clave. Valores (o cadenas de texto) que no se finalizan correctamente. Por ejemplo GetUnitsInArea(0, "Town) es erroneo debido a que el nombre del ScriptArea no tiene las dobles comillas de cierre. El uso incorrecto de las doble comillas en DisplayTrace. Por ejemplo: DisplayTrace( "Comandante, los "Tigers" han llegado."); es incorrecto porque al cerrar la palabra Tigers con dobles comillas se est indicando al programa que visualize "Comandante, los " Funciones y palabras clave embebidos entre parentesis, cuando no se escriben el nmero correcto de parentesis de apertura o cierre. Por ejemplo: if (GetNScriptUnitsInArea (1, "finalattack") == 1 then, es incorrecto debido a que la funcin GetNScriptUnitsInArea no se ha finalizado con un parentesis. Teclear Lose(); en lugar de Loose(); an cuando la ortografia correcta para palabra que indica perder es Lose , la palabra clave correcta es Loose. Win(), en esta sentencia falta el nmero del jugado.

Para ahorrar tiempo durante el proceso de depuracin es util sabe que errores siguientes NO rompen el programa: Enviar al mapa un grupo de refuerzos inexistente. Llamar a ejecucin a una funcin que no existe (utilizando RunScript).

Depurando programas que se comportan de forma inesperada Algunas veces un programa no se comportar exactamente como se esperaba. Por ejemplo, los objetivos no se complentan habiendo satisfecho los requisitos o un grupo de refuerzo se presenta repetidas veces. A continuacin se presentan algunos de los errores ms comunes que se dan en los programas: Si se da el caso de que una accin en particular o un evento (por ejemplo, un grupo de refuerzo continua apareciendo repetidamente en el mapa) es muy posible que falte la sentencia Suicide();. Esta sentencia hace que una funcin se detenga y su uso es critico para asegurar la correcta ejecucin de los programas. Ejemplo:
function Init() RunScript(MyCheck, 5000); end; function MyCheck() if GetNUnitsInArea(0, Town) > 0 then RunScript(Reinforcements,5000); end; end; function Reinforcements() LandReinforcement(100) end;

La ejecucin de MyCheck se produce cada 5 segundos. Esta funcin comprueba que el jugador 0 tenga una o ms unidades en el area Town. Si se cumple la condicin la funcin Reinforcements es llamada para hacer aparece el grupo de refuerzo 100. No obstante, en el ejemplo, el grupo de refuerzo ser llamado repetidas veces mientras el jugaor 0 disponga de alguna unidad en el area Town debido a que la funcin MyChechk no contiene una orden de finalizar una vez que la condicin se ha cumplido una vez. El codigo correcto sera :
function MyCheck() if GetNUnitsInArea(0, Town) > 0 then RunScript(Reinforcements,5000); Suicide(); end; end;

La sentencia Suicide(); dice al procesador que finalice la ejecucin de la funcin MyCheck una vez que se ha cumplido la condicin y los refuerzos han sido llamados. Objective Received: Unknown Objective . Este mensaje aparecer en el mapa si la entrada correspondiente al objetivo falta en el fichero de mapas .xml. Sin embargo, este mensaje es normal si se ejecuta el mapa directamente desde el editor ya que Blitzkrieg no procesa los ficheros en las carpetas scenarios\custom\missions\nombre misin. Si al comprobar el nmero de unidades en un area, no se obtienen resultados hay que chequear que no existen dos areas definidas con el mismo nombre. Si las unidades de aviacin no aparecen, despues de haber sido llamadas con la funcin Cmd, hay que comprobar que la aviacin no ha sido, previamente desactivada, con la funcin DisableAviation(), en otro punto del programa.

Apendice A Lista de Funciones Blitzkrieg (por Wespex)

Funciones AddIronMan ChangeFormation ChangePlayer ChangeWarFog Cmd|GiveCommand DamageObject DeleteReinforcement DisableAviation DisplayTrace Draw EnableAviation FlagReinforcement GetActiveShellType GetAviationState GetFGlobalVar GetFrontDir GetIGlobalVar GetMapSize GetNAmmo GetNAntitankInScriptArea GetNAPFencesInScriptArea GetNFencesInScriptArea GetNMinesInScriptArea GetNScriptUnitsInArea GetNTrenchesInScriptArea GetNUnitsInArea GetNUnitsInCircle GetNUnitsInParty GetNUnitsInScriptGroup GetNUnitsOfType GetObjCoord GetObjectHPs GetScriptAreaParams GetSGlobalVar GetSquadInfo GetUnitState God IsEntrenched IsFollowing IsStandGround Custom Function IsWarehouseConnected KillScript LandReinforcement Loose ObjectiveChanged Password QCmd|GiveQCommand : RandomFloat RandomInt ReserveAviationForTimes RunScript Texto en pantalla Tipo de municin utilizada por la artilleria ltima llamada a la aviacin realizada por el jugador Nombre y valor de la variable Direccin a la que la unidad est mirando Nombre y valor de la variable Tamao del mapa en puntos script Niveles de municin (primario y secundario) Nmero de obstaculos antitanque en el area Nmero de alambradas de espino en el area Nmero de vallas y muros en el area Nmero de minas en el area (AT y AP) Nmero de unidades con el ScriptID en el area Nmero de trincheras en el area Nmero de unidades del jugador en el area Nmero de unidades del jugadoe en las coordenadas Nmero de unidades del jugador en el mapa Nmero de unidades con el ScriptID Tipo de infanteria Localizacin de los objetos Puntos de salud de los objetos Parmetros del area Nombre y valor de la variable Formacin de las unidades Estado de la unidad Si la unidad est atrincherada = 1, si no = 0 Si la unidad sigue a otra = 1, si no = 0, si no existe -1 Si la unidad est atrincherada = 1, si no = 0 Valor salida Si deposito de campaa conectado con deposito principal = 1, si no = 0 (strScriptFunctionName) (iReinfID) (iObjNum, iState) Estado del objetivo, si = 0 -> visualizado; si = 1 -> alcanzado, si = 2 -> no comprobado (strName) (iAction, iScriptID, params) Nmero decimal entre 0 y 1 (n) Nmero aleatorio entre 0 y n (iParty, iTime) (strFunctionName, iTime, iTurns) Valores requeridos (iScriptID) (iScriptID, iFormation) (iScriptID, iParty) (iParty) (iAction, iScriptID, xLoc, yLoc) (iScriptID, fDamage) (iScriptID) (iParty, iAviationType) (strText, params, ...) (iParty, iAviationType) (nParty) (iScriptID) (iPlayer) (strGlobalVarName, 0) (iScriptID) (strGlobalVarName,0) (iScriptID) (strScriptAreaName) (strScriptAreaName) (strScriptAreaName) (strScriptAreaName) (iScriptID, strScriptAreaName) (strScriptAreaName) (iPlayer, strScriptAreaName) (iPlayer, X, Y, Radius) (iPlayer) (iScriptID, iPlayer) (strUnitType, iPlayer) (iScriptID) (iScriptID_Static) (strScriptAreaName) (strGlobalVarName, 0) (iScriptID) (iScriptID) (iParty, iMode) (iScriptID) (iScriptID) (iScriptID) Input Value (iScript_StorageID) Valores devueltos

Funciones SetCheatDifficultyLevel SetDifficultyLevel SetFGlobalVar SetGameSpeed SetIGlobalVar SetSGlobalVar ShowActiveScripts Suicide SwitchWeather SwitchWeatherAutomatic Trace ViewZone Win

Valores requeridos (n) (n) (strGlobalVarName, fVar) (n) (strGlobalVarName, iVar) (strGlobalVarName, sVar) (iState) (iState) (strText, params) (strScriptAreaName, iParam) (iParty)

Valores devueltos Visualiza en la consola el texto del programa que est ejecutandose Visualiza un texto en la consola -

Apendice B Enlaces tiles

Editor SciTe para Blitzkrieg Guia de Calvin para la Programacin en LUA Tutorial para Mapas de un solo jugador por Wespex Otros Tutoriales en el Portal Blitzkrieg Creando un Mapa, Preguntas y Respuestas. Foros del Portal Blitzkrieg