Herramientas de Debug
La Base de Sky incluye múltiples herramientas de depuración que facilitan el desarrollo y testing de tu fangame, incluyendo mejoras propias sobre el debug estándar de Essentials.
¿Qué es el modo Debug?
El modo Debug es un modo de desarrollo accesible solo para los creadores del juego. Proporciona comandos y opciones adicionales para probar el juego, modificar datos, y encontrar errores antes de publicar.
Activar el modo Debug
El modo Debug se activa automáticamente cuando el juego se ejecuta desde RPG Maker XP (con F12). También puede activarse:
- Estableciendo
$DEBUG = trueen los scripts - Pasando el argumento
debugpor línea de comandos al ejecutable del juego
El modo debug NO debe estar disponible en las builds compiladas para los jugadores. Solo se usa durante el desarrollo.
Easy Debug Terminal (F3)
Pulsando F3 durante el juego (en modo debug) se abre el Easy Debug Terminal, una consola interactiva que permite ejecutar comandos de debug rápidamente sin navegar por menús.
| Tecla | Función |
|---|---|
| F3 | Abrir Easy Debug Terminal |
| F9 | Menú de debug estándar de Essentials |
| F12 | Reiniciar el juego |
Debug Passability
La herramienta de Debug Passability muestra visualmente la pasabilidad de los tiles en el mapa actual. Esto permite encontrar errores de mapping rápidamente.
- Adaptado a la versión 21.1 de Essentials
- Un NPC en Pueblo Inicio explica cómo activarlo
- Muestra con colores qué tiles son transitables y cuáles no
Debug List Search
Mejora las listas del debug estándar con un buscador integrado, permitiendo filtrar rápidamente entre Pokémon, objetos, movimientos, etc. en los menús de debug. Mejorado con mejores buscadores en v1.2.0.
Menú de Debug (F9)
El menú principal de debug se abre desde el menú de pausa o pulsando F9. Contiene todas las funciones de depuración organizadas en submenús.
Opciones de campo (Field Options)
| Función | Descripción |
|---|---|
| Warp to map | Teletransporta al jugador a un punto del mapa elegido |
| Use PC | Abre un PC para acceder al almacenamiento y PC del jugador |
| Switches | Muestra y permite modificar todos los Game Switches |
| Variables | Muestra y permite modificar todos los Game Variables |
| Change field effects | Modifica efectos del overworld (Repelente, Strength, Flash, Flautas) |
| Refresh map | Recarga todos los eventos del mapa actual |
| Day Care | Gestiona los Pokémon en la Guardería y fuerza la generación de huevos |
| Toggle storage wallpapers | Bloquea/desbloquea fondos especiales del PC |
Opciones de batalla (Battle Options)
| Función | Descripción |
|---|---|
| Test wild battle | Inicia batalla contra un Pokémon salvaje elegido con nivel personalizado |
| Test wild battle advanced | Batalla avanzada: elegir múltiples Pokémon, personalizar cada uno |
| Test trainer battle | Inicia batalla contra un entrenador elegido |
| Test trainer battle advanced | Batalla avanzada: elegir entrenadores y configurar Pokémon por lado |
| Roaming Pokémon | Ver y modificar información de Pokémon errantes |
| Reset map's trainers | Reinicia los Self Switches de los entrenadores del mapa |
| Toggle Exp. All | Activa/desactiva el reparto de experiencia global |
| Toggle battle logging | Activa/desactiva el registro de mensajes de batalla en debuglog.txt |
Opciones de Pokémon
| Función | Descripción |
|---|---|
| Heal party | Cura completamente todo el equipo |
| Add Pokémon | Añade un Pokémon de especie y nivel elegidos |
| Fill storage boxes | Llena todas las cajas con uno de cada especie (nivel 50) |
| Clear storage boxes | Vacía todas las cajas del PC |
| Give demo party | Llena el equipo con un set predefinido |
| Quick hatch eggs | Los huevos del equipo necesitarán solo 1 paso para eclosionar |
| Access Pokémon storage | Abre directamente el almacenamiento |
Opciones de objetos y jugador
| Función | Descripción |
|---|---|
| Add item | Añade un objeto elegido a la mochila |
| Fill Bag | Llena la mochila con todos los objetos |
| Empty Bag | Vacía completamente la mochila |
| Set money | Establece dinero, Monedas o BP |
| Set Gym Badges | Activa/desactiva las primeras 24 medallas |
| Toggle running shoes | Activa/desactiva las zapatillas de correr |
| Toggle Pokédex | Activa/desactiva la Pokédex y Pokédex regionales |
| Toggle Pokégear | Activa/desactiva el Pokégear |
| Set player character | Cambia el personaje del jugador |
| Set player name | Renombra al jugador |
Editores PBS y Archivos
| Función | Descripción |
|---|---|
| Edit encounters.txt | Modifica encuentros salvajes por mapa |
| Edit trainers.txt | Edita entrenadores y sus equipos |
| Edit pokemon.txt | Edita datos de especies de Pokémon |
| Edit pokemon_metrics.txt | Posiciona sprites de Pokémon en batalla (con buscador en v1.2.0) |
| Edit items.txt | Edita datos de objetos |
| Edit map_metadata.txt | Edita metadatos de mapas |
| Edit regional_dexes.txt | Crea y modifica Pokédex regionales |
| Edit terrain tags | Define terrain tags de cada tile en cada tileset |
| Compile data | Compila todos los datos de los PBS |
| Create PBS file(s) | Genera archivos PBS desde los datos cargados |
| Manage Mystery Gifts | Gestiona el archivo master de Regalos Misteriosos |
| Battle animation editor | Editor de animaciones de ataques |
| Fix invalid tiles | Verifica y corrige tiles inválidos en todos los mapas |
Menú Debug de Pokémon
Accesible desde la pantalla de equipo, el PC, o la función "Test Wild Battle Advanced". Permite editar un Pokémon individual:
| Función | Descripción |
|---|---|
| HP/status | Modificar HP, estado, Pokérus. Debilitar o curar completamente |
| Level/stats | Cambiar nivel, Exp, EVs, IVs, felicidad, ID personal |
| Moves | Enseñar/olvidar cualquier movimiento, editar PP, resetear moveset |
| Set item | Cambiar el objeto equipado (cualquier objeto, incluso Key Items) |
| Set ability | Cambiar habilidad (de las disponibles o cualquiera) |
| Set nature | Cambiar o resetear la naturaleza |
| Set gender | Cambiar o resetear el género |
| Species/form | Cambiar especie, forma, forzar forma ignorando getForm |
| Cosmetic info | Shininess, tipo de Poké Ball, cintas, mote, entrenador original |
| Set egg | Convertir entre huevo y Pokémon, poner pasos a 1 |
| Mystery Gift | Crear un Regalo Misterioso con este Pokémon |
| Duplicate / Delete | Duplicar o eliminar el Pokémon |
Menú Debug de Batalla
Accesible pulsando F9 durante el menú principal de combate (Fight/Bag/Pokémon/Run). Permite:
- Modificar los Pokémon participantes en la batalla
- Cambiar entorno, clima y terreno
- Ver y modificar efectos especiales activos
- Ver el orden de velocidad de los Pokémon en batalla
Atajos con Ctrl
En modo debug, mantener Ctrl activa funciones especiales:
En el overworld
| Atajo | Efecto |
|---|---|
| Ctrl + mover | Caminar sobre cualquier tile (ignorar pasabilidad) |
| Ctrl + moverse | Saltar batallas de entrenadores y evitar encuentros salvajes |
| Ctrl + Fly | Volar a ubicaciones no visitadas |
En batalla
| Atajo | Efecto |
|---|---|
| Ctrl tras animación | Forzar el efecto secundario del movimiento |
| Ctrl al lanzar Poké Ball | Captura garantizada |
| Ctrl + Run | Huir siempre (incluso de entrenadores, eligiendo victoria o derrota) |
| Ctrl + Fight | Forzar opción de Mega Evolución |
Otros
| Atajo | Efecto |
|---|---|
| Ctrl al iniciar juego | Forzar recompilación de plugins y PBS |
| Ctrl + cerrar error | Copiar mensaje de error al portapapeles |
| Ctrl en minijuego minero | Evitar que se alarguen las grietas |
Consola de Debug
Al ejecutar en modo debug se abre una ventana de consola junto al juego. Muestra información útil del motor y se puede usar para imprimir mensajes de depuración:
# Imprimir un mensaje a la consola de debug
echoln "Mi mensaje de debug"
# Imprimir el valor de una variable
echoln $player.party[0].name