Tutorial:Agregar Nuevos Items

Esta es una guía de cómo agregar los nuevos ítems del juego a la wiki. Manejaremos conceptos de plantillas por lo que es importante saber que habrán cosas que no se expliquen en este tutorial pero que si están explicadas en el Tutorial:Manejo de Plantillas

Cada ítem que agreguemos a la wiki lo agregaremos como una nueva plantilla, esto lo hacemos para poder hacer referencia a este nuevo ítem desde cualquier parte de la wiki de forma fácil y con poco código.

La nueva plantilla la crearemos con el nombre "Plantilla:Item_{{id}}" reemplazaremos {{id}} por la id del ítem sin sus tres 000 finales. Por ejemplo, el ítem 50510000; el nombre de esta plantilla será Plantilla:Item_50510. Escribir Plantilla:Item_50510000 será incorrecto debido a que los 3 últimos ceros no son realmente parte de la id sino que son un dato extra que indica una información extra del propio ítem por lo que a la hora de crear la plantilla de este ítem, estos 3 últimos ceros los ignoraremos.

Correcto ✔ Plantilla:Item_50510

Incorrecto X Plantilla:Item_50510000

¿Por qué agregamos Plantilla al principio? Porque como mencionamos en el tutorial de manejo de plantillas, la palabra Plantilla indica que esta página que creamos debe ser usada como una plantilla.

Con esto creamos la página que será utilizada como una plantilla, y la propia plantilla pero no el item, esto es porque realmente no agregamos información sobre el ítem.

Lo siguiente que veremos es una muestra genérica de una plantilla de un ítem, más concretamente, una chaqueta:

<div 
   class="item_container {{{1|}}} {{#if:{{{bg|}}}|{{#ifexpr:{{{bg|}}}=0|empty|}}|}}"
   data-lvl="0" 
   data-popup='{
     "name":"*Un nombre*",
     "type":"Ropa", 
     "cdn_cat":"body",
     "cdn_img":"*nombre de imagen*",
        "str":-0,
        "mob":-0,
        "dex":-0,
        "cha":-0,
        "con":-0,
        "vig":-0,
        "tou":-0,
        "sta":-0,
        "hea":-0,
        "rid":-0,
        "ref":-0,
        "dod":-0,
        "hid":-0,
        "swi":-0,
        "aim":-0,
        "sho":-0,
        "pit":-0,
        "fin":-0,
        "rep":-0,
        "lea":-0,
        "tac":-0,
        "tra":-0,
        "ani":-0,
        "app":-0,
        "fboff":0,
        "fbdef":0,
        "money":0,
        "drop":0,
        "luck":0,
        "regen":0,
        "text":["*texto*","*otro texto y se pueden agregar más*"]
        "lvl":1,
        "id":*id de item*,
        "bp":2000,
        "sp":1000,
        "set":"*nombre del set*",
        "upg":1,
        "auc":1,
        "dmglvl":-0,
        "dmg_min":15,
        "dmg_max":25
        "hspd":262
   }' 
   data-url='body/{{#if:{{{1|}}}|{{#ifeq:{{{1|}}}|||wear/}}|}}*nombre de imagen*.png'>
   <div class="item_level">
   <div class="icon_level"></div>
   <div class="upgrade"></div><span class="level">0</span>
   <div class="downgrade"></div>
   </div>{{#if:{{{nb|}}}|
   <div class="item_number">{{{nb}}}</div>|}}
 </div>

Las líneas verdes son aquellas líneas que serán modificadas o eliminadas según el ítem y sus características. Las líneas rojas son aquellas que no serán modificadas y que serán siempre iguales para todos los ítems (o por lo menos hasta el momento de la creación de esta guía)

Pasaremos a dar una indicación de los distintos fragmentos de código para saber que significan.

Utilizaremos el ítem 50510 como ejemplo para explicar el código:

data-lvl="0"

Esta línea la agregaremos en aquellos ítems que puedan ser mejorables. Si el item no es mejorable entonces borraremos esta línea o no la agregaremos a nuestro código.

data-popup='{

Esta línea es la que nos permite agregar la info del popup del item. El popup es la tabla de info que se muestra en la pantalla cuando ponemos el puntero del ratón sobre un item o cuando lo presionamos en un dispositivo móvil. Esta línea de código no la modificaremos ni la eliminaremos.

 "name":"*Un nombre*",
 "type":"*Tipo de item*", 
 "cdn_cat":"*Categoría*",
 "cdn_img":"*nombre de imagen*",

Llamemos a cada uno de estos elementos como atributos (igual que en las plantillas). Estos serán información que se mostrará dentro del popup.

"name" es el atributo donde indicaremos el nombre del ítem, en nuestro ejemplo, el nombre sería Cabeza de caballo ya que este es el nombre de nuestro item.

"type" es el atributo donde indicaremos el tipo del objeto. En nuestro caso el tipo de objeto sería Adorno de cabeza. Todos los sombreros serán Adornos de cabeza.

"cdn_cat" es un atributo que utilizaremos como metadato del item. No será un dato visible para nosotros pero la programación en la wiki utiliza este dato para identificar el tipo de item y recuperar la imagen que buscaremos con el siguiente atributo. En nuestro ejemplo, el cdn_cat será head

"cdn_img" es el atributo que nos permitirá mostrar la imagen del item dentro del popup. Es importante saber que no subimos la imagen del item a la wiki sino que la obtendremos directamente de los servidores de innogames por lo que escribiremos el nombre de item según como lo tengan guardado ellos ¿Cómo hacemos esto? Si abrimos el juego y hacemos clic derecho sobre el item y hacemos clic derecho en abrir imagen en pestaña nueva (o como lo diga en el navegador que usen) se abrirá una nueva pestaña, en esta nueva pestaña veremos la imagen pero lo que realmente nos importa es la URL de la página, y de esa URL veremos el nombre de la imagen. El nombre será lo último de la URL, lo que está después del último /. Es importante saber que no necesitamos la extensión de la imagen (el .png o .jpg o .jpeg o la extensión que sea).

Como podemos ver, en la URL también veremos el cdn_cat del item, lo tendremos antes del nombre de la imagen. cdn_cat/cdn_img

En nuestro ejemplo, el cdn_img de nuestro item será gift_xshteff

La siguiente tabla es una lista de los tipos y categoría de los objetos o ítems que tenemos:

Tipos y categorías de items

type	cdn_cat	tipo de item
Adorno de Cabeza	head	Para todos los items que sean equipables en la cabeza de pj.
Ropa	body	Para todos los items que sean equipables en el cuerpo del pj. Chaquetas, camisetas, etc.
Collar	neck	Para todos los ítems que sean equipables en el cuello del pj. Collares, bufandas, etc.
Cinturón	belt	Para todos los ítems que sean equipables en la cintura del pj.
Pantalones	pants	Para todos los ítems que sean equipables en las piernas del pj. Pantalones, vaqueros, etc.
Calzado	foot	Para todos los ítems que sean equipables en los pies del pj. Botas, zapatos, sandalias, etc.
(Arma contundente)	right_arm	Para todos los ítems que sean equipables como arma de duelo y que sean armas contundentes.
(Arma de duelo)	right_arm	Para todos los ítems que sean equipables como arma de duelo y que sean armas a distancia.
Rifle	left_arm	para todos los ítems que sean equipables como arma de batallas de fuerte o aventuras. Los rifles, ballestas, etc.
Animal	animal	Para todos los ítems que sean equipables como montura. Caballos, burros, etc.
Producto	yield	Para todos los ítems que sean equipables, consumibles, cofres, de búsqueda, productos de oficio, productos de trabajos, etc. La mayoría de los ítems que aparecen en la sección de "productos" en el inventario del juego son de este tipo.
Receta	récipe	Para todos las recetas de oficio.

     "str":-0,
     "mob":-0, 
     "dex":-0, 
     "cha":-0, 
     "con":-0, 
     "vig":-0, 
     "tou":-0, 
     "sta":-0,
     "hea":-0, 
     "rid":-0, 
     "ref":-0, 
     "dod":-0,
     "hid":-0, 
     "swi":-0,
     "aim":-0,
     "sho":-0,
     "pit":-0, 
     "fin":-0,
     "rep":-0, 
     "lea":-0, 
     "tac":-0,
     "tra":-0, 
     "ani":-0,
     "app":-0, 

Todas estas líneas de código son las distintas habilidades y atributos que puede tener el item. Si por ejemplo no tiene vigor, entonces la línea de vigor la eliminaríamos.

El valor del punto de habilidad o atributo que nos dará lo escribiremos en el lugar del 0. En este punto debemos tener algo en cuenta y hasta diría que es obligatorio recordarlo: Si le escribimos el - al valor que le asignemos al item, este valor será un número que se multiplicará por el nivel del pj. por ejemplo 0.50 de vigor por nivel. Si eliminamos el - antes del valor del atributo o la habilidad entonces este será un valor fijo para el item, no cambiará sin importar el nivel que tenga el pj. En la actualidad los ítems cambian los puntos de habilidad y atributo según el nivel del pj pero antiguamente los ítems tenían puntos de habilidad y atributo fijo.

La siguiente tabla es una lista de los puntos de atributo y habilidad:

Puntos de habilidad y atributos

nombre código	nombre de hab/atr	nombre código	nombre de hab/atr	nombre código	nombre de hab/atr	nombre código	nombre de hab/atr
str	fuerza	mob	movilidad	dex	destreza	cha	Carisma
con	construcción	rid	Montar a Caballo	aim	apuntar	lea	liderazgo
vig	vigor	ref	Reflejo	sho	disparar	tac	tácticas
tou	tenacidad	dod	Eludir	pit	poner trampas	tra	comerciar
sta	condición	hid	Esconder	fin	destreza de manos	ani	instinto animal
hea	Puntos de Vida	swi	nadar	rep	reparar	app	apariencia

Si lo miramos con un poco de atención veremos que el nombre de código para cada habilidad y atributo realmente es le nombre que tienen en ingles pero abreviado: str Streng, vig vigor, rid riding, swi swiming, etc.