Introducción
Hola gente! En este tutorial trataré les enseñaré Jass en general, es decir, desde lo más básico hasta lo más difícil, osea, no les lanzaré toda la info de golpe, no quiero ser la causa de colapsos cerebrales masivos Este tutorial está destinado a los principiantes, GUI'seros y a los que piensan que solo mentes superdotadas pueden entender el Jass. La idea es demostrar que es más fácil de lo que parece, y animarlos a aprenderlo, ya que tiene varias ventajas a comparación del GUI.

¿Qué es Jass?:

¿Y vJass?:

Funciones
Una función es un conjunto de "acciones" que se ejecutarán en orden ¿más despacio? bueno, compara cada función con el conjunto de acciones de un detonador en GUI:
[gui]Acciones
   -------- deto en GUI --------
   Partida - Display to (All players) the text: Hola !!
   Wait 2.00 seconds
   Partida - Display to (All players) the text: Bienvenido...
[/gui]
Como ya sabrás, todas esas acciones se ejecutarán en orden, lo mismo pasa con las funciones en Jass.

Vamos al grano. ¿Como creo una función? Así:
[jass]function [nombre de la función] takes [parametros que toma] returns [parametros que devuelve]
 //acciones de la función
endfunction
[/jass]
  ~ Lo de los parámetros por ahora no los tomes en cuenta, en su lugar escribe nothing
  ~ El nombre de la función puede ser cualquiera, pero ojo, no pueden haber dos funciones con el mismo nombre.
  ~ Cuando escribas //, todo lo que siga a su derecha se transformará en un comentario, lo cual al detonador no le sirve para nada, PERO a nosotros si, acostúmbrate a usar los comentarios para mantener tu código ordenado
  ~ No olvides "terminar" la función con endfunction.

Hagamos un ejemplo:
[jass]
function MiFuncion takes nothing returns nothing
  call BJDebugMsg("Hola gente!!!")
endfunction[/jass]

  ~ En este caso, la función se llama MiFuncion.
  ~ Como dije antes, las funciones son como un conjunto de acciones, y antes de ejecutar cada acción, hay que escribir la palabra call Si nos olvidamos del call, nos aparecerá un error...  En el ejemplo anterior, estamos ejecutando la acción BJDebugMsg, la cual muestra un texto en la pantalla a todos los jugadores, en este caso, es el texto que va en los paréntesis ("Hola gente!!!")

Variables
Las variables son como "almacenes" en donde guardamos cosas para usarlas más adelante existen dos tipos de variables: locales y globales.

La diferencia?? Las globales pueden usarse en cualquier detonador y en el lugar donde quieras, similar a las variables creadas en el editor de variables y las locales SOLO pueden ser usadas dentro de la función donde se crean.

Calma, vamos por parte. Primero, como creamos una variable global?? Al principio de todo el código de tu detonador, así:

[jass]
globals
  [tipo de variable] [nombre de la variable] = [valor de la variable]
endglobals [/jass]

  ~ Dentro de globals y endglobals puedes crear todas las variables que quieras
  ~ Los nombres de las variables no se pueden repetir
  ~ el valor de la variable, osea, la parte de = [valor de la variable] es opcional, ya que si lo deseas puedes darle a tu variable un valor más adelante

Ya, pero... que es el tipo de variable??
Recuerdas que las variables son como almacenes?? Pues el tipo de variable indica que tipo de cosas habrá dentro del almacén puede ser un número, un texto, una unidad, una región, etc.

Tipos de variables más comunes

  ~ unit = La variable almacena una unidad
  ~ integer = Almacena un numero cualquiera, pero sin decimales. Ejemplos: 1, -10, 2000, 34234...
  ~ real = Almacena un número cualquiera con decimales.
  ~ string = Almacena texto. Recuerda que los "textos" o "cadenas" deben ir entre comillas ""
  ~ boolean = Solo almacena un valor de Verdadero o falso. true o false.
  ~ trigger = Almacena un detonador
  ~ timer = Almacena un reloj..
  ~ location = Almacena un punto en el mapa
  ~ sound = Almacena un sonido


Vale, así que las globales pueden usarse en cualquier parte... Mmm.. y las locales??

Las locales solo se usan dentro de la función donde se crean. Si creamos una variable local en la función A, no podremos usarla en la función B, en cambio, una global podría usarse tanto en A como en B

Ya, y como creo una local? Al principio de una función, las variables locales se crean así:
[jass]
local [tipo de variable] [nombre de la variable] = [valor de la variable][/jass]

  ~ Igualmente, el valor es opcional y el nombre no debe repetirse. No pueden haber dos variables locales con el mismo nombre dentro de la misma función.

Hagamos un ejemplo. ¿Recuerdas la función que creamos al principio? usemos variables en ella

[jass]
function MiFuncion takes nothing returns nothing
 local string texto1 = "Hola "
 local string texto2
 set texto2 = "gente!!!"
  call BJDebugMsg(texto1 + texto2)
endfunction[/jass]

Creamos dos variables del tipo string (texto): texto1 y texto2. A texto1 le asignamos un valor al principio, pero a texto2 no. ¿Cómo le damos valor? Así:
[jass]set [variable] = [valor][/jass]
De la misma forma, podemos cambiarle el valor a una variable

Como ya vimos antes, BJDebugMsg mostraba un mensaje en el mapa, pero en este caso, el mensaje será la "suma" de las variables texto1 y texto2, es decir, "Hola " + "gente!!!" = "Hola gente!!!" Se entiende?

Creando un detonador
Sip, para que esa función funcione, debemos crear un detonador que la ejecute, igual que en GUI.

¿Cómo lo hago en JASS? creamos otra función como esta:

[jass]
function Creando takes nothing returns nothing
   local trigger t = CreateTrigger()
   call TriggerRegisterTimerEventSingle (t, 3.0)
   call TriggerAddAction (t, function MiFuncion)
endfunction[/jass]

Calma, calma, explico:

La función se llama Creando

Primero creamos una variable local de tipo trigger (detonador) llamada t, a la cual le asignamos el valor "CreateTrigger()". Con esto, creamos un detonador

call TriggerRegisterTimerEventSingle (t, 3.0) es el acontecimiento que tendrá que ocurrir para que se ejecute el detonador. TriggerRegisterTimerEventSingle es el equivalente a:
[gui]Acontecimientos
   Tiempo - Elapsed game time is 3.00 seconds
[/gui]

¿Qué es esa "t" dentro de los parentesis? es el detonador al cual le estamos asignando el acontecimiento, recuerdas cuando creamos la variable local trigger t? Esa es

Ya.. y el "3.0"? Es el tiempo que tendrá que pasar para que se ejecute el acontecimiento n.n similar al ejemplo en GUI que dí antes (3 segundos).

"TriggerAddAction" es la acción que añade las acciones al detonador. La "t" de los parentesis? es el detonador al cual le asignamos las acciones. "function MiFuncion"?? Es la funcion en donde están las acciones del detonador !!

Al final, nuestro ejemplo quedaría algo así:

[jass]
function MiFuncion takes nothing returns nothing
   local string texto1 = "Hola "
   local string texto2
   set texto2 = "gente!!!"
   call BJDebugMsg(texto1 + texto2)
endfunction

//=============================================================

function Creando takes nothing returns nothing
   local trigger t = CreateTrigger()
   call TriggerRegisterTimerEventSingle (t, 3.0)
   call TriggerAddAction (t, function MiFuncion)
endfunction[/jass]

Ya está!! Detonador creado!!

Scope & initializer
¿Que pasa? Detonador creado, con acontecimiento y todo, pero no pasa nada... Por que es???

Tranqui, no es error tuyo, ni mio, lo que pasa es que aun no ejecutamos la función que crea el detonador, es decir, la funcion "Creando".

Tedioso? Naa, en la práctica es más simple de lo que parece. Para esto, encapsularemos nuestro detonador en un scope.

Como creo un scope? Así:

[jass]
scope [nombre del scope] initializer [funcion que se inicia primero]
  //...
endscope
[/jass]

En la función que se inicia primero ponemos la que crea nuestro detonador, en mi caso, "Creando". Quedaría entonces así:

[jass]
scope MiScope initializer Creando

   function MiFuncion takes nothing returns nothing
       local string texto1 = "Hola "
       local string texto2
       set texto2 = "gente!!!"
       call BJDebugMsg(texto1 + texto2)
   endfunction

   //=============================================================

   function Creando takes nothing returns nothing
       local trigger t = CreateTrigger()
       call TriggerRegisterTimerEventSingle (t, 3.0)
       call TriggerAddAction (t, function MiFuncion)
   endfunction
   
endscope[/jass]

Prueba el mapa y... ¡¡¡Funciona!!!

  ~ El nombre de los scopes no debe repetirse
  ~ "initializer [funcion que se inicia primero] es opcional, pero en este ejemplo usamos el scope solo para esto
  ~ Recuerda terminarlo con "endscope".



Ya se que el tutorial salió algo largo, pero en la práctica, cuando aprendas, esto se hace en menos de 5 minutos

Esta es una manera de crear un detonador en (v)Jass, mi objetivo era animarlos a aprender, a enseñarles a manejar los conceptos básicos (variables, funcion, etc..), así como mostrar un uso de encapsular con scopes

Espero que alguien lo lea..

Críticas(constructivas) son aceptadas, cualquier error u otro dato que me salté o para agregar, házmelo saber

Cualquier duda, pregunta !! La idea es que aprendas.. Si no entiendes algo (por no decir todo ) trataré de explicarlo más simple

Saludos!!!

Es un buen aporte , pero creo que para animar mas a la gente no hace falta un tutorial de jass para principiantes sino uno de programación para principiantes.

Buen tutorial, yo apenas tengo una leve idea sobre detonadores, si me animo a prender aquí ya tengo este tutorial, gracias

SpamBot escribió:

Es un buen aporte , pero creo que para animar mas a la gente no hace falta un tutorial de jass para principiantes sino uno de programación para principiantes.

Sí, pero mientras no se puedan usar otros lenguajes en war3 como el Ruby o C (aunque el zinc se parece mucho), no tendría mucho sentido enseñar otros lenguajes aquí. Eso sí, creo que lo que podría haber es uno con los conceptos básicos de programación.

JhOtAm escribió:

yo apenas tengo una leve idea sobre detonadores, si me animo a prender aquí ya tengo este tutorial

En mi opinión no es necesario saber detonadores GUI para aprender JASS, bueno, para mi GUI es una mala costumbre

XSerozY escribió:

SpamBot escribió:

Es un buen aporte , pero creo que para animar mas a la gente no hace falta un tutorial de jass para principiantes sino uno de programación para principiantes.

Eso sí, creo que lo que podría haber es uno con los conceptos básicos de programación

Yo creo que a eso se refería SpamBot. Para enseñar a alguien programar no tienes porque irte de una al lenguaje.

Lo otro, ¿vjass fácil? ... no, no es fácil. Pasarán alrededor 1-3 meses sin ser realmente productivos utilizando vjass. No es algo fácil, es algo que requiere tiempo y dedicación, tal y como dominar cualquier lenguaje de programación.

muzk escribió:

Yo creo que a eso se refería SpamBot. Para enseñar a alguien programar no tienes porque irte de una al lenguaje.

¨
Tienes razón, lo entendí mal.

muzk escribió:

Lo otro, ¿vjass fácil? ... no, no es fácil. Pasarán alrededor 1-3 meses sin ser realmente productivos utilizando vjass. No es algo fácil, es algo que requiere tiempo y dedicación, tal y como dominar cualquier lenguaje de programación.

Toda la razón. Un lenguaje de programación requiere práctica, tiempo y ganas.

Saludos!

solo se que desperdician sus vidas aprendiendo esto xd
mejor vayan a aprender algo que sirva :v

KoleshyEngine escribió:

solo se que desperdician sus vidas aprendiendo esto xd
mejor vayan a aprender algo que sirva :v

yo aprendí/descubrí muchos conceptos que pude aplicar a otros escenarios con esto.

Ruke escribió:

KoleshyEngine escribió:

solo se que desperdician sus vidas aprendiendo esto xd
mejor vayan a aprender algo que sirva :v

yo aprendí/descubrí muchos conceptos que pude aplicar a otros escenarios con esto.

KoleshyEngine tiene razón, aprender "ahora" no vale la pena, aunque aprendas cosas adicionales, ya que esas cosas es muy probable que las aprendas de todas formas si aprendes algo que sirva más

Ruke escribió:

KoleshyEngine escribió:

solo se que desperdician sus vidas aprendiendo esto xd
mejor vayan a aprender algo que sirva :v

yo aprendí/descubrí muchos conceptos que pude aplicar a otros escenarios con esto.

mejor enseñales java. eso les sera util

Uhmm, yo he encontrado que entender los conceptos es lo principal, después aplicarlo a cada lenguaje/herramienta/etc. es lo de menos ya que en su mayoría la diferencia reside en la sintaxis.

Apruebo el tuto n_n

buenísimo pero al leer los primeros ejemplos ya me dieron ganas de acabar.... soy pésimo para los lenguajes aunq cuando los voy aprendiendo des tomo "gusto" necesito muchísimo interés y motivación en ello. PERO me parece excelente que haya un tutorial así, antes no había visto alguno...

APRUEBO EL TUTORIAL

jajajaaaa broma

Amigo, tengo dos problemas el primero es la parte del scope me aparece syntax error cuando compilo.
T el segundo es que no puedo probar el mapa Al darle click en probar me sale un error de warcraft  para cerrar el programa. Tipo de problema: Appcrash. AYuda porfavor


Disculpa. Sobre el scope todo esta bien, error mio. Y sobre el programa pues aun tengo el error, seguiré probando el mapa de forma manual.
Ah y por cierto. Muchas gracias por este tutorial espero que sigas haciendo mas, realmente es muy interesante aprender Jass.

@muzk; @KoleshyEngine:

No entiendo para nada :C solo quiero hacer spells como los de dota,si hubiera un tutorial muy detallado,de crear spells,como el chronosphere de dota :C.

AAAAAAAAAAAAAAAAAAAAA NO ABRE EL MAPA
[jass]
function Mifuncion takes nothing returns nothing
endfunction
local trigger Mifuncion = Createtrigger()
call triggerRegisterTimerSingle (t,3.0)
local string hola = "olaa"
call BJDebugMsg("olaa" )
endfunction
//===========================================================================
[/jass]

armando368 escribió:

AAAAAAAAAAAAAAAAAAAAA NO ABRE EL MAPA
[jass]
function Mifuncion takes nothing returns nothing
endfunction
local trigger Mifuncion = Createtrigger()
call triggerRegisterTimerSingle (t,3.0)
local string hola = "olaa"
call BJDebugMsg("olaa" )
endfunction
//===========================================================================
[/jass]

Escribiste
[jass]function Mifuncion takes nothing returns nothing
endfunction[/jass]

Cuando escribes endfunction no puedes escribir debajo de esta línea sin antes declarar una nueva función

PD: La solución: Borrar esa línea "endfunction" totalmente mal colocada

Marcos_M escribió:

armando368 escribió:

AAAAAAAAAAAAAAAAAAAAA NO ABRE EL MAPA
[jass]
function Mifuncion takes nothing returns nothing
endfunction
local trigger Mifuncion = Createtrigger()
call triggerRegisterTimerSingle (t,3.0)
local string hola = "olaa"
call BJDebugMsg("olaa" )
endfunction
//===========================================================================
[/jass]

Escribiste
[jass]function Mifuncion takes nothing returns nothing
endfunction[/jass]

Cuando escribes endfunction no puedes escribir debajo de esta línea sin antes declarar una nueva función

PD: La solución: Borrar esa línea "endfunction" totalmente mal colocada

Ok


PD : Importo spells pero no abre el mapa

Importe el fissure del earthshaker y nada ,incluso coloque object ID

Siempre tienes que guardar el mapa antes de probarlo cuando usas vJASS