[Guia] Guia basica para poder programar un Script.


Primero que todo esta Guia esta basada de la que originalmente viene en el Foro DivineRO sobre edicion de Npc de una forma sencilla. Mas sin embargo considero que mucho de ella no es comprendible para una persona que apenas comienza a hacer sus scripts, como me paso a mi por ello es que se me ah ocurrido hacerle unas cuantas modificaciones.
Es mi primera Guia por lo que perdonaran si algo no comprenden. Tratare de ser lo mas explicita y clara para que todos podamos comprender.!

Vamos a comenzar con lo mas basico.

Existen dos tipos de Npc`s a los cuales nos vamos a referir:

    Npc`s Shop: que son todos aquellos que nos venden y nos compran los items.

    Npc`s Script: que son todos aquellos que hacemos para tareas determinadas, como sean mandar a un personaje de un lado a otro, quests o actividades                     determinadas.


Una ves esto claro vamos a comenzar de la manera que comienza todo novato. Me refiero a Novato  por que todas las personas somos novatos, hasta que alguien con mas experiencia nos orienta, en este caso una FAQ o una Guia!

Los scripts se deben de trabajar en hojas de texto normales.


NPC`s de Script.

Lo importante y a lo que hay que poner suma atencion es a la tabulacion a los puntos( . ) comas( , ) puntos y comas( ; ) las llaves( {} ) y las comillas ( " ) ya que estos minimos detalles pueden hacer que si faltan en nuestro script, este  no pueda ser ejecutado o de plano que nos marque un error en el map serv o que nos rebotee el map serv.

Vamos a ver como realizamos un script muy sencillo de platica ente el npc y el usuario como primer paso:

Ejemplo 1:

prontera.gat,110,120,4ScriptAlfredo119,{

mes "Hola bienvenido a los npcs script";
Close;
}



Ok por partes ahora.

- Lo primero que vemos en el script es:

prontera.gat,110,120,5ScriptAlfredo119,{

lo cual es:

prontera.gat,     Es la ciudad en donde se localizara el npc, de esa manera podemos poner en ves de prontera, hugel o comodo o cualquiera de las ciudades en donde quiera que aparesca el npc. ¿Por que el ( .gat ) ? Bueno sencillo es la extencion de los mapas de Ragnarok, por ello cada que hacemos referencia a un mapa debemos de ponerlo aunque sea un cuarto en alguno de los mapas ( ejemplo prt_in.gat ). Por si no saben, prt_in es: prt = prontera, in = inside. Osea es uno de los tantos sub-mapas que hay en prontera. Detras del nombre del mapa debe de haber siempre una ( , ).

110,120,5     Bueno esto es la localizacion en coordenadas exactas de donde es que quiere que aparezca. Como todos sabemos, ragnarok esta reguido por cuadros por ello cada cuadro es una coordenada diferente. asi que el NPC esta localizado en el cuadro 110 de 120 = 110,120. Si nos vamos al juego y le damos en donde estas parados un comando ( /where ) nos marcara exactamente las coordenadas y el nombre del mapa en el que nos localizamos. Nuevamente la  ( , ) es un separado y finalmente el 5 que aparece de ultimo es hacia donde estara mirando nuestro NCP. En este caso el 5 es que estara directamente viendo hacia nosotros, sin girar la pantaya.

       Precionar o utilizar la tecla TAB de tu teclado una ves. No es un espacio normal, debe ser un tabulador.

Script        Esto indica el tipo de NPC que estamos realizando, en este caso un script.

       Precionar o utilizar la tecla TAB de tu teclado una ves. No es un espacio normal, debe ser un tabulador.

Alfredo        Es el nombre que llebara nuestro NPC.

       Precionar o utilizar la tecla TAB de tu teclado una ves. No es un espacio normal, debe ser un tabulador.

119,        El 119 es el numero de sprite que utilizaremos para este npc. Y la ( , ) es un separador nuevamente.

{        Esta llave es la que nos indica que el scrip va a comenzar. Y siempre debe de ir en esa posicion en ese lugar.


Para la lista de Npcs y sus sprites puedes visitar: http://shuji-yagami.iespana.es/meinfiles/divinero-aportes/npclist.html


- La segunda parte del script es:

mes " Hola bienvenido a los npcs script";

Esta la seccion en donde colocaremos todo lo que el npc le quiera decir o hacer al usuario.

El mes siempre debe de ir al comienzo de toda oracion, sea lo que sea que queramos poner. Mas adelante les dare mas comandos que podemos utilizar pero basicamente el mes es para platicas o especificacion.

Muy importante es el uso de las  ( "texto" ) Las comillas hacen que el texto sea visto por nuestro usuario, sin ellos el scrip no funciona y nos marcara un error, asi que cada ves que hagamos un texto deben de ir las comillas    ( ; ) de apertura de texto y cierre de este mismo. Ejemplo: ( "Hola como estas )
Finalmente y no menos importante el punto y coma ( ; ) Esta puntuacion nos da por entendido que ahi termina la oracion o cierre de dialogo.

- La tercera parte del script es:

Close;
}


Close;         Que esto nos idica que termina el script, o se cierra el script. Y ( } )                el parentesis si se fijan es al reves del que pusimos arriba eso                     tambien nos
                  indica cierre de script o termino del mismo.


Este seria nuestro primer Npc del que podemos hacer referencia.

Les voy a poner algunos ejemplos aca para que se hagan una idea de lo que pueden realizar con estos comando simples:

1. Ejemplo:

prontera.gat,110,120,5ScriptAlfredo119,{

mes "Hola bienvenido a los npcs script";
Close;
}


2. Ejemplo:

hugel.gat,90,180,5ScriptAlfredo119,{

mes "Hola bienvenido a los npcs script";
mes "Aca podemos agregar mas texto";
mes "Sin importar la cantidad que sea";
mes "Es importante destacar que entre el mes y las comillas es un simple espacio en blanco";
Close;
}

De esa manera podemos hacer platicas de platicas de npc con nuestros usuarios o simplemente darles la bienvenida a alguna zona especifica o dar informacion de algo importante.



NOTA IMPORTNATE:

No debemos de olvidar que cada oracion debe de comenzar con mes y finalizar con ;                 Ejemplo: mes "Hola";

No debemos olvidar que todo texto debe de ir con " al principio y " al final de el.                          Ejemplo: "Hola";

No debemos olvidar que al finalizar el scrip siempre tenemos que poner el Close; y la llave que cierra }

Un erro que a veces nos sucede es que se nos olvida despues del sprite colocar la , y la llave { asi que tengan cuidado al respecto.




Bueno ya conocimos el mes que es para las platicas... ahora vamos a conocer el next y el menu y su utilizacion.

Next;  Este es el comando que nos indica que la platica seguira en la siguiente ventana del npc... por que de hecho no podemos hacer que todos nuestros npcs tengan una enorme ventana con todo lo que queremos decir. Por ello hacemos un Next; para que siga en otra ventana. Vamos a poner de ejemplo el script del ejemplo 2 pasado.


prontera.gat,110,120,4ScriptAlfredo119,{

mes "Hola bienvenido a los npcs script";
mes "Aca podemos agregar mas texto";
next;
mes "Sin importar la cantidad que sea";
mes "Es importante destacar que entre el mes y las comillas es un simple espacio en blanco";
Close;
}

Otro ejemplo de utilizacion de next;

prontera.gat,110,120,4ScriptAlfredo119,{

mes "Hola bienvenido a los npcs script";
next;
mes "Aca podemos agregar mas texto";
next;
mes "Sin importar la cantidad que sea";
next;
mes "Es importante destacar que entre el mes y las comillas es un simple espacio en blanco";
Close;
}


Si se fijan bien lo unico que realizamos es colocar el next; y el ; dentro de lo que ya teniamos programando.
Efectivamente es importante que el comando tambien finalice con el punto y coma ( ; ) por que significa que ahi termina esa linea, no lo olviden. Por lo general cuando empesamos a hacer scripts este tipo de falta de signos es tipico por que no estamos concientes de cada uno de ellos, es nada mas cuestion de fijarnos bien.

menu;    Bueno este comando es para que el npc le presente opciones a el usuario. Vamos a utilizar el mismo ejemplo anterior pero vamos a incluir este comando.


prontera.gat,110,120,4ScriptAlfredo119,{

mes "Hola bienvenido a los npcs script";
mes "Desearias aprender un poco mas de los scripts?";
next;
menu "Si",referencia1,"No",referencia2;

referencia1:
    mes "Mas adelante te dare mas datos de a realizacion de scrips";
    Close;

referencia2:
    mes "Este es para hacer una opcion mas para el menu que estamos estudiando en este momento";
    Close;

Close;
}

Bueno aca se nos complican un poco las cosas, por que hasta el momento habiamos visto cosas muy sencillas, pero el comando menu nos viene a dar un mar de opciones para nuestros scrips y el poder tambien darle opciones a nuestros usuarios, un ejemplo es que en nuestro npc de informacion de nuestro servidor como anteriormente este expresado, se de la opcion de un SI o un NO. Tambien lo utilizamos en npc en donde la persona pueda escojer un ojeto de su interes o algun quest npc que posee varios quests al mismo tiempo.

Para ello vamos por partes del menu:

menu    nos idica que sera un grupo de opciones. Entre el menu y las comillas del texto lo que va es exactamente un espacio en blanco normal.

Recuerden que todo texto y lo seguire repitiendo en el transcurso de la Guia debemos NO OLVIDAR por nada las comillas del comienzo y finalizacion del texto.

referencia     Esto es lo que va a pasar si el usuario le pica a nuesto SI o a nuestro NO.

En este caso si nuestro usuario le pica que SI, el npc le dira lo que indica en la referencia 1. Mas sin embargo el le pica NO, nos dira lo que dice la referencia 2.

Tambien es importante destacar que cada opcion va separa de su referencia por una ( , ) y cada referencia va con una ( , ) antes de la siguiente opcion en el menu.

El menu tambien cierra con el ( ; ) despues de la ultima referencia. Ademas de que las referencias no lleban comillas ( " )

Parte de la referencia:

referencia1:
    mes "Mas adelante te dare mas datos de los comandos de scrips";
    Close;

Si nos fijamos bien, esta referencia solamente nos habla por ello es que es marcado con mes pero dentro de esta referencia tambien podemos colocar los next;


referencia1:
    mes "Mas adelante te dare mas datos de los comandos de scrips";
    mes "Tambien los podemos usar el comando next; dentro del mes";
    next;
    mes "Como se mostro en este mini ejemplo";
    Close;


Es importante decir que toda referencia lleba su close; por que eso nos idica que esa seccion del script esta terminada.

Nota importante1:  Despues de cada opcion y de cada referencia debe de haber un separador que es el papel que juega nuestra ( , ).
Nota importante2:  La referencia no debe de llamarse de la mismo manera que la opcion que damos a nuestro usuario.

Ya que por experiencia propia se que el menu es un poco complicado y que al principio para toda persona nueva haciendo scripts, voy a poner un ejemplo de la utilizacion del comando menu un poco mas extensa que la que ya vimos en la parte de arriba, tambien una de las cosas que aprendi es que uno aprende mas y mas rapido si tiene ejemplos en donde se puede basar para poder hacer lo que queremos.


prontera.gat,110,120,4ScriptAlfredo119,{

mes "Hola bienvenido a los npcs script";
mes "Vamos a agregar un menu un poco mas complicado";
next;
mes "Por ello vamos a utilizar un menu de 5 opciones para nuestro usuario";
menu "Quiero aprender",referencia1,"No es tan complicado",referencia2,"Esc cuestion de fijarnos bien",referencia3,"No olvidar la puntuacion",referencia4,"No darse por vencido",referencia5;


referencia1:  
    mes "Vamos a aprender juntos el arte hacer nuestros scripts";
    Close;

referencia2:
    mes "Con un poco de practica esto sera pan comido ya veras";
    Close;

referencia3:
    mes "No es concurso de quien hace que mas rapido tomate tu tiempo para pensar en tus scripts";
    Close;

referencia4:
    mes "No olvides que fijarnos en la puntuacion es importante, el minimo error de esto puede darnos un error mas grave";
    Close;

referencia5:
    mes "Si no te sale el primero sigue intentando que puede ser que poniendo atencion en el script encuentres los errores";
    Close;

Close;
}

Recuerden que las referencias no deben de tener el mismo nombre que la opcion que estamos dando al usuario. Cada referencia debe de cerrarse con un Close;

Bueno eso es un ejemplo de un menu mas complejo para que los que deseen poner mas complejas las opciones puedan realizarlo.




Npcs de Quest.

Bueno nos hemos fijado en muchisimos servers que nos ponen npcs que dan la opcion de creacion de items... bueno, vamos a realizar el nuestro.

Primero que nada vamos a colocar un ejemplo como anteriormente lo eh estado haciendo. Va? Vamos a trabajar con la base del script que hemos estado trabajando.

Ejemplo 1.
prontera.gat,110,120,4ScriptAlfredo119,{

mes [Alfredo];
mes "Hola bienvenido a los npcs script tipo quest";
mes "En esta ocacion vamos a tratar el tema de como podemos realizar un quest para nuestros usuarios?";
next;
mes "Por ende vamos inventarnos que queremos crear un objeto que solo por medio de un quest lo podemos poseer";
mes "El objeto que vamos a realizar es un guante llamado todo poderoso";
mes "Para poder realizar el el guante todo poderoso vamos a pedir los siguientes items";
next;
mes "2 gloves con slot";
mes "10 diamantes de 2 kilates";
mes "1 muñeco de Osiris";                <<<< 1.
mes "10 steel";
next;
mes "Deseas hacer tu guante todo poderoso?";
menu "Si",referencia1,"No",referencia2;            //Este es un menu basico.                                                                 Que nos da la opcion                                                                    si queremos o no el guante.

referencia1:
    mes "Para que pueda realizarte el guante necesito que me entregues los items que se requieren";
    if(countitem(2624)<2)goto falta;
    if(countitem(732)<10)goto falta;    
    if(countitem(751)<1)goto falta;            <<<< 2.
    if(countitem(999)<10)goto falta;
    next;
    mes "parece que posees todo lo que necesito para hacer el guante";
    delitem, 2624,2;
    delitem, 732,10;
    delitem, 751,1;                    <<<< 3.
    delitem, 999,10;
    getitem 1009,1;                    <<<< 4.
    mes "Disfrutalo";
    Close;

referencia2:
    mes "Aca el usuario estia negando la accion de hacer el guante por lo que simplemente le decimos adios";
    Close;
falta:
    mes "Aca vamos a colocar que pasaria si el usuario no lleba los suficientes items";
    Close;                                            <<<< 5.

Close;
}

Ok ok... se que se ve complejo y medio complicado pero bueno haremos referencia a los comando aca expresados:

Los que ya conocemos como el  mes   el menu   el next;  y el close; que son basicamente lo que riguen todo script. Las partes basicas del script estan numeradas por ello vamos a empezar en orden.

<<<< 1.  Esta es la lista de items que se le tienen que entregar al npc para poder hacer el objeto. Como pueden fijarse va con el comando mes y entre comillas y especificada la cantidad de items que se le tienen que entregar.

<<<< 2. Este comando if(countitem(numero item) es el comando que checa si el usuario posee el item y la cantidad de items que es requerida pero no nos adentraremos mucho en el tema por que seria muy complicado para esta guia basica.

     Pero puedo darles la idea de que el numero de item que va es el numero de item que tiene en la base de datos del emulador. Y el numero de items que se requiere es la cantidad de items que se estan pidiendo para hacer la quest. En este caso pedimos 2 gloves con slot, por lo que su numero en la base de datos es: 2624 y tienen que ser dos por ello queda: if(countitem(2624)<2).

    Despues de esto viene un goto falta; que es con lo que se cierra el comando, esto significa que tendremos que creear una referencia llamada   ( falta ), para que si el usuario no lleba los dos items no pueda crearlo.

                Ejemplo:  if(countitem(2624)<2)goto falta;

    Dentro de este parametro tambien podemos utilizar  el  < > ya sea: <2 menos 2 o >2 mas 2. Dependiendo de lo que deseemos.

<<<< 3. Este comando delitem 2624,2; es el que retira del usuario el item y su cantidad correspondiente, dependiendo de la cantidad que se haya pedido. Tambien debe de tener el ; al fina por que ahi acaba la accion.

                Ejemplo: delitem, 2624,2;


<<<< 4. Este comando getitem 1009,1; es igual que el anterior solo que a la imbersa. A que me refiero con esto, bueno a que este es el que le entrega al usuario el item que en este caso es el guante todo poderoso.

                Ejemplo: getitem 1009,1;

<<<< 5. Este es la referencia de la que estuvimos platican en la seccion 2 de esta explicacion, osea que es la referencia que tenemos que crear por si el usuario no tiene los items y la cantidad de items necesarias para crear el nuevo item.

                Ejemplo:
falta:
    mes "Aca vamos a colocar que pasaria si el usuario no lleba los suficientes items";
    Close;                                          



Npcs Shop.


Los Npc de shop son mas faciles que todo lo que son npcs de script, por ello esta parte de la guia sera mas facil.


Ejemplo 1.
prontera.gat,155,106,5shopArmaduras86,
512:-1,513:-1,514:-1,515:-1,516:-1,517:-1,529:-1,530:-1,536:-1,548:-1,558:-1,559:-1,562:-1,564:-1,565:-1,566:-1,567:-1,570:-1,571:-1

Ahora si  por partes.

- Vamos a localizar a nuestro nuevo vendedor en prontera.gat por ello, nuestro script debe de decir:    prontera.gat,155,106,5

Recuerden que el gat es la extencion del mapa de ro por ello en todo mapa que pongas debes de ponele la extencion.

- Tambien podemos observar que el npc posee las coordenadas en las que queremos que este.   prontera.gat,155,106,5

- El 5 que es la orientacion hacia donde va a mirar el npc.
              prontera.gat,155,106,5

- son la normal tecla de tabulador de nuestro teclado.

- El Shop que nos indica que este es un npc de venta.

- Su nombre que en este caso es Armadiras.

- nuevamente un tabulador.

- El 86, como sabemos es el numero de sprite que queremos para nuestro npc.

Ahora vamos a trabajar comprendiendo la parte interna del NCP....

512:-1,513:-1,514:-1,515:-1,516:-1,517:-1,529:-1,530:-1,536:-1,548:-1,558:-1,559:-1,562:-1,564:-1,565:-1,566:-1,567:-1,570:-1,571:-1

este numero nos refiere al numero de item que queremos vender.


512:-1,513:-1,514:-1,515:-1,516:-1,517:-1,529:-1,530:-1,536:-1,548:-1,558:-1,559:-1,562:-1,564:-1,565:-1,566:-1,567:-1,570:-1,571:-1


esto nos idica que queremos venderlo al precio que viene estipulado dentro de la base de datos.


512:-1,513:-1,514:-1,515:-1,516:-1,517:-1,529:-1,530:-1,536:-1,548:-1,558:-1,559:-1,562:-1,564:-1,565:-1,566:-1,567:-1,570:-1,571:-1

esta coma es un separador entre items.


Vamos a poner el caso de que no queramos vender las cosas al precio que viene estipulado en la base de datos.

512:-1000000,513:-1,514:-1,515:-1,516:-1,517:-1,529:-1,530:-1,536:-1,548:-1,558:-1,559:-1,562:-1,564:-1,565:-1,566:-1,567:-1,570:-1,571:-1

Nuevamente el numero del item que queremos vender.

512:-1000000,513:-1,514:-1,515:-1,516:-1,517:-1,529:-1,530:-1,536:-1,548:-1,558:-1,559:-1,562:-1,564:-1,565:-1,566:-1,567:-1,570:-1,571:-1

Este es el nuevo precio que queremos que tenga el item que queremos vender.


Seria de esta forma:

512:-1,513:-1,514:-1,515:-1,516:-1,517:-1,529:-1,530:-1,536:-1,548:-1,558:-1,559:-1,562:-1,564:-1,565:-1,566:-1,567:-1,570:-1,571:-1

Vamos a modificar la tabla que teniamos anteriormente con :-1 por la tabla abajo expuesta:

512:-1000000,513:-1,514:-1,515:-1,516:-1,517:-1,529:-1,530:-1,536:-1,548:-1,558:-1,559:-1,562:-1,564:-1,565:-1,566:-1,567:-1,570:-1,571:-1

Y colocaremos en el :-1 el precio que queremos que nos cueste: Ejemplo: :-1000000

De esa manera podemos modificar cada uno de los precios que se encuentran en la tabla de objetos a vender. Pueden quedar todos con los precios originales, o pueden venderse unos al precio original y otro a un precio determinado Ejemplo.

512:-1000000,513:-1,514:-1,515:-10000,516:-1,517:-1,529:-1,530:-500000,536:-1,548:-1,558:-1,559:-1,562:-6000,564:-1,565:-1,566:-1,567:-1,570:-1,571:-1

y quedaria de esa manera.


Como ven esto no es muy complicado.



Como agregar nuestro nuevos scripts a nuestro server.

Bueno amigos ya tenemos nuestros scrips y shops listos para ser colocados en nuestro  server pero ahora la pregunta es:

¿Como los hago que funcionen?

Bueno  una ves que tenemos todo configurado y listo para ser probado, como en la parte superior mencione, trabajamos en una hoja de texto normal o bloque de notas, por ello vamos a salvar nuestro script como:  nombre del script.txt   Ejemplo:  alfredo.txt

Una ves salvado lo vamos a copiar de donde lo salvamos y nos vamos a nuestro emulador.

Vamos a localizar dentro del emulador una carpeta que se llama: npc  seria c:/eAthena/npc  y dentro de ella vamos a buscar una sub carpeta que se llama: Custom  entonces tendriamos la extencion de esta manera:    c:/eAthena/npc/Custom que es en donde debemos colocar nuestra copia del script que acabamos de realizar.

Luego nos regresamos a la carpeta  c:/eAthena/npc   y dentro de ella vamos a encontrar un archivo que se llama: scripts_custom.cof la vamos a abrir y nos va a aparecer todos los scripts customs que estan en el emulador.

Bueno nos vamos hasta el puro final del bloque de notas y vamos a escribir lo siguiente:

npc: npc/custom/nombre del script nuestro.txt    osea    npc: npc/custom/alfredo.txt  

Le damos guardar al archivo de scripts_custom.cof y lo cerramos....

Y listo ya podemos ver nuestros scripts dentro de nuestro server.


Mi-Seccion de ayuda en errores basicos.

Errores basicos que nos pueden llegar a marcar en el char serv por una mala colocacion de un script.

1. Falta de comillas ( " ) en los comiensos y finales de las mes o en los menus.

2. Falta del ( ; ) en el final de cada una de las oraciones o comandos.

3. Falta de las llaves ( {} ) al comenzar y al cerrar el script.

4. Falta de la ( , ) a la hora como separador.

5. A veces si no colocamos el mapa correcto nos puede dar error.


---
Existen mis amigos muchisimos mas comandos que podemos agregar a nuestros scripts, pero no nos podemos adentrar en ellos en esta Guia ya que esta diseñada para ayudar a las personas que estan comenzando a realizar los scripts. Mas adelante puede que me ponga a realizar una recopilacion con ejemplo de como realizar otras funciones de los npcs... por ahora me despido y espero que les sirva de ayuda la Guia que les eh ofrecido.