Plugins
Sistema de plugins
Pokémon Essentials v21.1 incluye un sistema de plugins que permite añadir funcionalidades modulares. La Base de Sky mejora este sistema con detección automática de cambios.
Estructura de plugins
La estructura de los plugins en La Base de Sky sigue un formato específico para facilitar su integración y mantenimiento.
Cada plugin está compuesto por una carpeta que tiene un archivo meta.txt con la información general del pluginy luego N carpetas o archivos de scripts de Ruby con la extensión .rb
El archivo meta.txt de cada plugin en LBDS puede contener los siguientes campos:
| Campo | Descripción | Tipo | Obligatorio |
|---|---|---|---|
Name |
Nombre del plugin | String | Sí |
Version |
Versión del plugin (formato X.Y.Z) | String | Sí |
Essentials |
Versión de Pokémon Essentials con las que es compatible el plugin (formato X.Y.Z) | String | Sí |
Link |
Enlace al sitio web o repositorio del plugin | String | No |
Credits |
Autor o autores del plugin | String | No |
Requires |
Indica la dependecia de otro Plugin para que este funcione correctamente, los valores posibles para este campo son:
|
String | No |
Exact |
Indica la dependecia de una version especifica de otro Plugin para que este funcione. | String | No |
Optional |
Indica Plugins que deben cargarse antes que este, el formato es <Nombre Plugin>,<Version> |
String | No |
Conflicts |
Indica Plugins que no pueden cargarse junto con este, el formato es <Nombre Plugin> de hacerlo lanzará un error |
String | No |
Disabled |
Indica que el Plugin está deshabilitado y no se cargará | Booleano | No |
First |
Indica que el Plugin debe cargarse antes que cualquier otro plugin | Booleano | No |
Last |
Indica que el Plugin debe cargarse después de todos los otros plugins | Booleano | No |
Priority |
Dentro de los Plugins indicados como Si hay 2 Plugins indicados como Si hay 2 Plugins indicados como |
Entero | No |
Plugins incluidos
La Base de Sky viene con los siguientes plugins ya incluídos en el código interno de la base:
| Plugin | Descripción |
|---|---|
| Pokédex Avanzada | Pokédex mejorada con buscador y más funciones |
| Enhanced Pokémon UI | Interfaz mejorada de información de Pokémon |
| Easy Debug Terminal | Terminal de debug con F3 |
| Debug Passability | Visualización de pasabilidad de tiles |
| Debug List Search | Buscador en listas de debug |
| Mejoras del Almacenamiento | Ordenar, buscar y más en el PC |
| Multiple Exp Panel | Panel visual de distribución de experiencia |
| Fondos del Pokégear | Fondos personalizables para el Pokégear |
| Pokévial | Objeto clave recargable como poción |
| Cápsula de Habilidad | Cambiar habilidad de un Pokémon |
| Intercambio desde PC | Intercambiar Pokémon desde el almacenamiento |
| Ver IVs y EVs | Mostrar valores individuales y de esfuerzo |
| Reordenador de Tileset | Herramienta para reordenar tiles |
| Buscasalvajes | Ver Pokémon salvajes por ruta |
| Fancy Camera | Movimiento de cámara suave |
| Map Exporter | Exportar mapas como PNG |
| Hotfixes | Correcciones automáticas de bugs |
| Luka's Scripting Utilities | Utilidades de scripting |
| MUI - Modular UI Scenes | Framework de interfaz modular para resumen, equipo y Pokédex (ver guía) |
| Event Reporting | Buscar uso de switches, variables, audio y comentarios en eventos (ver guía) |
| Box Auto-Sort | Ordenar automáticamente los Pokémon dentro de las cajas del PC |
| Bag with Party | Muestra el equipo en la pantalla de la mochila |
| Easy Mouse | Soporte de entrada por ratón/táctil en menús |
Data/Scripts/ (no como carpetas en Plugins/). La carpeta Plugins/
se reserva para plugins de terceros que el usuario instale manualmente.
Instalar nuevos plugins
- Descarga el plugin de su fuente (generalmente Relic Castle o PokéCommunity)
- Copia la carpeta del plugin dentro de la carpeta
Plugins/del proyecto - Reinicia el juego — el Plugin Manager lo detectará automáticamente
- El plugin se compilará y activará en el siguiente inicio
Plugin Manager mejorado
El Plugin Manager de la base incluye mejoras para detectar automáticamente cuando se agregan o eliminan carpetas de plugins, sin necesidad de intervención manual.
Luka's Scripting Utilities
Se incluye una versión actualizada de las Luka's Scripting Utilities, una colección de herramientas y utilidades para facilitar el scripting en Ruby dentro de Essentials.
Ruby Standard Library (RSL)
Desde la versión 1.1.0 se incluye la Ruby Standard Library, un compilado de librerías de código estándar de Ruby que se pueden importar en tus scripts. Esto permite, por ejemplo:
- Usar la librería de JSON para manejar archivos JSON
- Utilizar otras librerías estándar de Ruby 3.3.0
Más información en la documentación de la Ruby Standard Library.
PokéUpdater
Si el plugin PokéUpdater está instalado, se muestra un botón de "Buscar actualizaciones" en la pantalla de carga. Si no está instalado, el botón no aparece.
Plugins opcionales no incluidos
Los siguientes plugins no vienen incluidos en La Base de Sky, pero el código contiene hooks de compatibilidad (PluginManager.installed?) para ellos. Si se instalan manualmente en la carpeta Plugins/, activarán funcionalidades adicionales.
| Plugin | Qué desbloquea | Notas |
|---|---|---|
| Deluxe Battle Kit (DBK) | Reglas de combate avanzadas ("towerBattle", "inverseBattle", "noBag", "wildMegaEvolution", etc.), sprites personalizados de entrenador con "setSlideSprite", textos de intro/derrota personalizados |
Sin DBK, usar estas reglas genera el error "La regla de combate X no existe.". Ver reglas de combate para la lista completa de reglas DBK. |
| PokéUpdater | Botón "Buscar actualizaciones" en la pantalla de carga | Si no está instalado, el botón simplemente no aparece. |
| Animated Pokémon System | Sprites animados de Pokémon en resumen, Pokédex y combate | Los gráficos animados son opcionales; sin el plugin se usan sprites estáticos. |
Los plugins externos deben ser compatibles con Essentials v21.1. Plugins diseñados para versiones anteriores o posteriores pueden causar errores. Verifica siempre la compatibilidad antes de instalar.