TUTORIAL: ACTUALIZAR LA
BASE A NUEVAS VERSIONES
La Base de Sky es el proyecto de la comunidad española para tener una base para hacer fanjuegos de Pokémon utilizando la versión más actual de Essentials de la comunidad inglesa, con muchos añadidos que hemos ido sumando a la base. Sin embargo, a medida que más y más gente la usa, vamos descubriendo cosas a mejorar o incluso salen nuevas versiones de algunos códigos que hacen que vaya todo mucho mejor. Es por este motivo que cada cierto tiempo sacamos nuevas versiones de la base con todos estos añadidos. Es muy importante que tratéis de tener el proyecto siempre actualizado, pues muchos errores se corrigen de esta manera. Es en este punto donde a muchos os puede surgir la siguiente duda: ¿cómo puedo actualizar el proyecto que ya tengo empezado para que tenga las novedades de la última versión? Pues eso mismo es lo que vamos a ver hoy.
COMPROBAR NUESTRA VERSIÓN ACTUAL
Lo primero que tenemos que tener en cuenta es qué versión tenemos actualmente con el proyecto en el que estamos trabajando. Si usáis una de las últimas versiones de la base, podréis ver el número de la versión en la pantalla de título del juego:
Si hubiéseis modificado la pantalla o tuviéseis una versión más antigua que la v1.0.4, en las que todavía no modificábamos la pantalla de título, tenéis otro sitio en el que consultar la versión.
Si pulsáis en este icono accederéis a los códigos internos del juego. Sin entrar mucho en detalle, tenéis a la izquierda una lista de todas las secciones del código. Si bajáis a la última de todas de la izquierda llamada "Main", veréis en la parte de arriba del cuadro de la derecha el número de la versión que tenéis en estos momentos.
COMPROBAR LOS CAMBIOS EN GITHUB
Vamos a suponer que nuestro proyecto está en la versión v1.0.6, y queremos actualizar a la v1.0.7, que en el momento de este tutorial es la más actual.
IMPORTANTE: Si estáis en una versión más antigua tendréis que ir una por una revisando cada actualización que haya salido después y añadiendo los cambios de esas versiones, empezando por las más antiguas que no hayáis añadido. Si por ejemplo tenéis la v1.0.5, primero añadiríais los cambios de la v1.0.6 y después los de la v1.0.7.
Ahora lo que tenemos que hacer es ir al Github donde publicamos las nuevas versiones de la base. Github es una página que permite subir archivos y que cada vez que se realiza una modificación de uno de ellos te permite consultar qué cambios se han hecho en esos archivos. Accederíamos al siguiente enlace.
En él accederíamos una página como esta, donde veis que aparecen los mismos archivos que tenéis en el proyecto, con la misma estructura de carpetas. Si os fijáis, en rojo os he marcado donde pone "Commits", que son todas las actualizaciones que hemos hecho en el proyecto.
Al entrar aquí en Commits nos aparece la siguiente vista, que son todos los cambios y actualizaciones del proyecto, con la fecha en la que se ha realizado cada uno. Los importantes en los que os tenéis que fijar son aquellos en los que aparezca el número de una nueva versión, puesto que ahí dentro estarán todos los cambios de la versión a la que nos queremos actualizar. Como hemos dicho, en este caso nos interesan los cambios de la versión 1.0.7.
Genial, hemos entrado en la actualización que nos interesa. Nada más entrar saldrán varias líneas indicando cambios que se han hecho (que son básicamente distintos commits realizados para esta versión en la rama dev, esto si no lo entendéis no os preocupéis), y lo que nos importa es que bajéis un poco hasta que veáis algo como esto:
Aquí lo que tenéis es, en el lado izquierdo, una estructura de árbol donde veis la lista de archivos que han sido modificado, y según vais haciendo click en cada uno, a la derecha veréis qué líneas de código se han modificado. No os preocupéis, que aunque parezca algo lioso, es más sencillo de lo que parece. Vamos a ver por dónde empezaríamos.
Fijémonos en la columna de la izquierda. La carpeta que nos interesa aquí es la que se llama "LA BASE DE SKY". Lo que hay encima son archivos del Github que a nosotros no nos interesan. Ahora vemos que en la carpeta Data salen varios archivos modificados, pero no nos interesa ninguno de ellos. Si vemos los que salen en la lista, el único que podría llegar a ser interesante es el de Map002.rxdata, que significa que un mapa de los que vienen en la base (el que tiene la ID 2) ha tenido algún cambio. Como los mapas de la base son a modo de tutorial, esto indica que hemos modificado algún evento para ayudar a dejar más clara alguna mecánica, pero si queréis lo podéis ignorar.
Un poco debajo encontramos la carpeta "Scripts". Aquí dentro están todos los códigos de Pokémon Essentials, donde se han hecho varios cambios. Vamos a ver ahora cómo añadir estos cambios a nuestro proyecto.
IMPORTANTE: a los códigos se accede desde el icono de Scripts de rpg maker xp (como hemos visto en la segunda foto de este tutorial). Sin embargo, existe una forma que explicaré en otro tutorial para poder sacar todos estos scripts de aquí dentro a una carpeta, para poder editarlos desde un editor externo como puede ser VSCode. Cualquiera que suela programar va a preferir esto ya que el editor que viene con el rpg maker xp está algo limitado. Esta es la razón por la que en el Github veis que los códigos están en una carpeta llamada "Scripts", dentro de la carpeta "Data". Pero para vosotros la forma de ver los scripts de vuestro proyecto es, como os he dicho, dándole al icono de Scripts de la segunda foto de este tutorial.
LEYENDA DE ICONOS
Aprovecho antes de seguir para explicaros qué significan los iconos que aparecen a la derecha de cada archivo modificado:
Si os fijáis, hay cuatro iconos distintos que podemos encontrarnos. Si un archivo tiene un guión rojo, es que ese archivo se ha eliminado del proyecto. Por lo general es recomendable que los borréis si veis que se han eliminado de la base. Por otro lado, si veis que tiene una cruz verde, es que es un archivo nuevo que se ha añadido al proyecto. Tendréis que descargarlo y añadirlo al proyecto en la misma carpeta donde lo veáis. Luego están los archivos con un punto amarillo, que significan que es un archivo que se ha modificado. Si es un archivo de código tendréis que añadir los cambios que contenga en el propio archivo. Si es una imagen, tendréis que sustituir la antigua por la nueva. Hay un cuarto icono que es la flecha gris, que básicamente es que el archivo ha cambiado de nombre, pero no ha sufrido más cambios.
AÑADIR LOS CAMBIOS A NUESTRO PROYECTO
Vamos ahora a volver a donde estábamos, a modificar los códigos. Os recomiendo mucho que hagáis una copia de seguridad de vuestro proyecto antes de hacerle estos cambios, por si acaso la liáis y os cargáis algo. En serio, que no os dé pereza, que luego vienen los arrepentimientos.
Muy en resumen, tenemos que ir seleccionando uno a uno los archivos que salen a la izquierda, y al hacerlo nos saldrá a la derecha qué cambios se han hecho en ese archivo. Las líneas que se han añadido saldrán en verde, y las que se hayan eliminado en color rojo. En este caso, por ejemplo vemos lo siguiente:
¿Veis que a la izquierda pone que estamos en "004_Settings_Extra_Base"? Ese es el script en el que se han hecho los cambios que veis a la derecha. Vamos buscarlo en el rpg maker:
Al buscarlo tenéis que hacerlo sin los números, ya que eso es algo nuestro por tener los scripts fuera de la base, para que sigan ordenados. Ahora que lo tenemos localizado, vamos a ver dónde hacer la modificación. En la pantalla de la foto anterior de Github salen varias líneas en verde, y a la izquierda nos dice el número de la línea en la que se ha añadido, como veis en la foto debajo de estas líneas. En este ejemplo concreto, como veis, se ha añadido en el archivo de "settings extra de la base" un campo para el nuevo repartir experiencia, y sale que está en la línea 26, debajo del código anterior de "SHOW_PRIMAL_ANIM = true". Pues en nuestros scripts pegamos estas líneas nuevas en verde debajo, y quedaría como vemos en la segunda foto de nuestros códigos.
Y de esta manera habríamos añadido estos cambios a nuestro proyecto. Fácil, ¿verdad? Pues es tan sencillo como que vayáis pasando por todos los archivos de la izquierda que veáis que se han modificado, y copiando las líneas verdes de la derecha en vuestro proyecto donde correspondan.
En algunos casos, en vez de solo salir líneas en verde con añadidos, salen líneas rojas y verdes juntas, indicando que una línea ha sido modificada por otra, como este ejemplo:
Veis que a la derecha hay dos líneas que han sido modificadas, la 122 y la 129. Pues como ya os estaréis imaginando, copiáis la línea en verde y os vais a vuestro proyecto a ese script y sustituís la línea en rojo por la verde. Fácil, ¿verdad? Una vez que hayáis terminado de actualizar los cambios de todos los scripts, el resto de cambios que quedan por hacer son principalmente de Gráficos, de Plugins y de PBS.
DESCARGAR IMÁGENES MODIFICADAS
En el caso de gráficos, es bastante sencillo. En este ejemplo, en la versión 1.0.7 tenemos estos cambios:
Como ya sabéis, aquellos archivos de la izquierda que tengan el punto rojo hay que borrarlos. Estos de la izquierda veis que están en la carpeta de Followers shinys, dentro de la carpeta Characters y a su vez dentro de la carpeta Graphics (esto sale en la parte de arriba a la izquierda). Pues os iríais a vuestro proyecto, entráis en estas carpetas y borráis estos archivos con punto rojo (en muchos casos se eliminan por sobrar, por no ser correctos o por tener nombres incorrectos). ¿Y si queremos actualizar un gráfico como el que vemos en la imagen de GLIMMORA o añadir uno que salga con la cruz verde? En ambos casos vamos a querer descargarnos el nuevo y añadirlo en la carpeta, ya sea para sustituir el anterior o para añadir el nuevo. Al pulsarlo veis que a la derecha os hace una previsualización del cambio, para que veáis el que había antes y el que hay ahora. Pues obviamente lo que no vamos a hacer es descargar la nueva versión de la base entera para sacar un único archivo de las carpetas (aunque podéis hacerlo si queréis), pero hay una forma muy sencilla de descargarnos solo esta imagen, para añadirla en la carpeta correspondiente.
Con la imagen seleccionada, hay que pulsar en los tres puntos de arriba a la derecha, y darle a View file. Una vez dentro, se abre esta página que veis debajo, y tenéis arriba a la derecha un icono que, con pulsarlo, se os descargará la imagen para añadirla al proyecto. La descargáis y la movéis al proyecto dentro de la carpeta que corresponda.
En el caso de que haya habido un cambio de nombre, mirad cómo se llamaba el archivo original, y renombradlo manualmente:
En este ejemplo, el gráfico de mabostiff estaba mal escrito. Si os fijáis a la derecha, ha pasado de llamarse MABOSTIFF a MABOSSTIFF, con dos S. Pues buscáis el gráfico en vuestra carpeta y le añadís al nombre esa S que faltaba. Muy fácil, ¿eh?
MODIFICAR LOS PBS
En el caso de modificar los PBS es bastante sencillo, al igual que con los Scrips. Seleccionáis el que haya tenido modificaciones, y vais corrigiendo todo lo que salga en el de la derecha que haya sido cambiado:
Si para ver los PBS usáis alguna herramienta como Notepad++ (se puede descargar gratis) en vez del bloc de notas, os va a ser mucho más cómodo ya que os van a salir a la izquierda los números de línea para saber dónde se ha hecho el cambio. De todos modos, en este caso también suele ser buena idea que hagáis la búsqueda en el archivo con el comando Cntrl + F, y busquéis algún texto de esa zona para encontrar rápido dónde hacer el cambio. Por ejemplo, en la imagen de encima veis que el segundo cambio que se hace es en la categoría de Grookey, que estaba mal escrita, y además veis debajo en las siguientes líneas que es él porque pone que su evo es Thwackey. Pues buscáis a Grookey en el archivo y así llegáis rápido a ese sitio para corregirlo. También podéis hacer click en las flechas azules que os salen entre los números de las líneas para ver más líneas del archivo y que os sea más sencillo localizarlos.
MODIFICAR LOS PLUGINS
Los cambios que nos quedan por hacer son de los Plugins. En este caso también son códigos, como pasaba antes con los Scritps, pero con la peculiaridad de que no podemos abrirlos desde dentro del rpg maker xp. Aquí lo recomendable es que uséis una herramienta externa que os deje modificar código como el programa VS Code, para poder añadir manualmente los cambios. En caso de que no os apañéis bien con este programa, otra opción es que añadáis directamente los nuevos Plugins a vuestro proyecto. Sin embargo, os recomiendo que no copiéis directamente los nuevos dentro de la carpeta Plugins de vuestro proyecto, ya que los nombres de algunas carpetas se han cambiado entre versiones y podéis acabar con duplicados de los plugins, lo que causará error al cargar el juego. Lo que os recomiendo es que primero borréis de la carpeta Plugins de vuestro proyecto los que venían con la base (si tenéis alguno que vosotros hayáis añadido, esos no los borréis, claro). Una vez borrados los antiguos de vuestro proyecto, os bajáis la nueva versión de la base y copiáis los plugins de la carpeta Plugins de la nueva versión a vuestro propio proyecto. Y de esta manera ya los tendríais actualizados.
Una vez hecho todo esto y habiendo comprobado todos los cambios del Github, ya deberíais tener vuestro proyecto actualizado. Como os dije al comienzo, es muy recomendable que estos cambios los hagáis en una copia de vuestro proyecto por si algo saliese mal. Una vez terminéis debéis abrir el juego y ver que cargue correctamente y todo vaya bien. Si os carga perfectamente os recomendaría que no borréis el otro proyecto (el original donde no habéis hecho los cambios) y que os lo guardéis como copia de seguridad, por si acaso sale algún error de algo que hayáis cambiado y que tardéis en daros cuenta.
Y esto sería lo más importante. Como siempre, si tenéis cualquier tipo de duda os recuerdo que tenemos el canal de Discord donde podéis preguntar todo lo que necesitéis.
¡Un saludo y feliz makeo!
Hola Sky intente poner un plugin para menu en pokemon essentials pero al momento de abrirlo este me sale Warning necesitas cambiar el safeExists a fileText.exist donde lo cambio
ResponderEliminarPregunta mejor por el discord, que así puedes adjuntar imágenes y nos es más sencillo ayudarte.
Eliminar