Herramientas de Debug
Contenido
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
Importante
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 |
|---|---|
| Saltar a mapa | Teletransporta al jugador a un punto del mapa elegido |
| Usar PC | Abre un PC para acceder al almacenamiento y PC del jugador |
| Interruptores | Muestra y permite modificar todos los Game Switches |
| Variables | Muestra y permite modificar todos los Game Variables |
| Zona safari y Concurso de Captura de Bichos | Permite editar los pasos y Poké Ball restantes al estar dentro de la Zona Safari o en el Concurso de Captura de Bichos |
| Cambiar efectos de campo | Modifica efectos del overworld (Repelente, Strength, Flash, Flautas) |
| Actualizar mapa | Recarga todos los eventos del mapa actual |
| Guardería | Gestiona los Pokémon en la Guardería y fuerza la generación de huevos |
| Alternar fondos del almacenamiento | Bloquea/desbloquea fondos especiales del PC |
| Saltar créditos | Alterna si los créditos se pueden saltar con el botón Usar |
| Exporta un Mapa | Elige un mapa para exportarlo como PNG |
Opciones de combate (Battle Options)
| Función | Descripción |
|---|---|
| Testear combate salvaje | Inicia batalla contra un Pokémon salvaje elegido con nivel personalizado |
| Testear combate salvaje (avanzado) | Batalla avanzada: elegir múltiples Pokémon, personalizar cada uno |
| Testear combate entrenador | Inicia batalla contra un entrenador elegido |
| Testear combate entrenador (avanzado) | Batalla avanzada: elegir entrenadores y configurar Pokémon por lado |
| Elige las reglas del próximo combate | Elige las reglas que se aplicarán al próximo combate |
| Elegir entrenador compañero | Elige a un entrenador para luchar junto a ti en el próximo combate |
| Elegir la versión de encuentros salvajes | Elige qué versión de encuentros salvajes debe usarse |
| Pokémon errante | Activr y edita los Pokémon errantes |
| Reiniciar entrenadores del mapa | Reinicia los Self Switches de los entrenadores del mapa |
| Alterna el efecto del Rep. Exp. Global | Activa/desactiva el reparto de experiencia global |
| Alterna los log de los mensajes en batalla | Activa/desactiva el registro de mensajes de batalla en debuglog.txt |
Opciones de Pokémon
| Función | Descripción |
|---|---|
| Curar equipo | Cura completamente todo el equipo |
| Añadir Pokémon | Añade un Pokémon de especie y nivel elegidos |
| Llenar cajas del PC | Llena todas las cajas con uno de cada especie (nivel 50) |
| Vaciar cajas del PC | Vacía todas las cajas del PC |
| Dar equipo de prueba | Llena el equipo con un set predefinido |
| Reducir pasos de Huevos del equipo | Los huevos del equipo necesitarán solo 1 paso para eclosionar |
| Acceder al sistema dealmacenamiento (PC) | Abre directamente el almacenamiento |
| Opciones Pokémon Oscuros | PokéCepo y purificación |
Opciones de objetos
| Función | Descripción |
|---|---|
| Imprimir eventos de objetos | Imprime un listado de eventos de objetos que hay en los mapas |
| Añadir objeto | Añade un objeto elegido a la mochila |
| Llenar mochila | Llena la mochila con todos los objetos |
| Vaciar mochila | Vacía completamente la mochila |
Opciones del Jugador
| Función | Descripción |
|---|---|
| Definir dinero | Establece dinero, Monedas o BP |
| Define las Medallas de Gimnasio | Activa/desactiva las primeras 24 medallas |
| Alternar zapatillas de correr | Activa/desactiva las zapatillas de correr |
| Alternar Pokédex y Dexes Regionales | Activa/desactiva la Pokédex y Pokédex regionales |
| Alternar Pokégear | Activa/desactiva el Pokégear |
| Editar teléfono y contactos | Edita las propiedades del teléfono y los contactos registrados |
| Alternar acceso al almacenamiento desde el equipo | Activa/desactiva el acceso al almacenamiento desde el equipo |
| Define el personaje del jugador | Cambia el personaje del jugador |
| Define el outfit del personaje | Cambia el outfit del personaje |
| Define el nombre del jugador | Renombra al jugador |
| Randomizar ID del jugador | Genera un nuevo ID del jugador aleatorio |
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. Este editor permite asignar valores de terrain tags superiores al 7 cosa que no se puede hacer desde el RPGMaker |
| 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 |
| Buscar uso de Switch | Busca en todos los mapas dónde se usa un Game Switch específico (Event Reporting) |
| Buscar uso de Variable | Busca en todos los mapas dónde se usa una Game Variable específica (Event Reporting) |
| Buscar uso de Audio | Busca uso de BGM, BGS, ME o SE en eventos. Puede filtrar por tipo o buscar uno específico (Event Reporting) |
| Buscar en Comentarios | Busca un texto dentro de los comentarios de eventos en todos los mapas (Event Reporting) |
| Buscador en Sprite Positioner | Buscador integrado al posicionar sprites de batalla (v1.2.0) |
ℹ️ Nota: Desde la pantalla de Continue/New Game, solo están accesibles los submenús de editores
PBS, otros editores y opciones de archivos, ya que los demás requieren una partida cargada.
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