================================================================================ DETAILED DESCRIPTION (ENGLISH)
VitaCore is the foundational API layer for the entire VitalisNW plugin ecosystem. It provides centralized services that all dependent plugins leverage, eliminating code duplication and ensuring consistent behavior across the network.
Key Services:
- DatabaseService: Centralized connection pooling supporting MySQL (via HikariCP) and SQLite modes. All dependent plugins obtain connections through this service instead of creating their own pools.
- MigrationManager: Transaction-safe SQL schema migration system that tracks applied migrations in a central table (vitacore_migrations).
- PermissionService: Abstraction over LuckPerms for querying player prefixes, suffixes, and group tags.
- CurrencyService: Multi-economy abstraction supporting Vault, PlayerPoints, and Minecraft XP levels.
- NetworkService: Cross-server communication via Redis Pub/Sub and BungeeCord plugin messaging.
- VirtualEntityManager: Client-side hidden armor stands and text displays to prevent region chunk corruption.
- UiNotificationManager: Temporal BossBar and ActionBar dispatch system.
- GuiManager: Global exploit-free click/drag listeners for custom inventory holders.
- CrashReporter: Automated error reporting to local logs and Discord webhooks.
Configuration: plugins/VitaCore/config.yml
- database.type: "sqlite" (default) or "mysql"
- database.host/port/database/username/password (MySQL only)
- redis.enabled: Cross-server messaging via Redis
- diagnostics.discord_webhook: Error reporting
================================================================================ DESCRIPCIÓN DETALLADA (ESPAÑOL)
VitaCore es la capa API fundamental para todo el ecosistema de plugins VitalisNW. Proporciona servicios centralizados que todos los plugins dependientes aprovechan, eliminando la duplicación de código y asegurando un comportamiento consistente en toda la red.
Servicios Clave:
- DatabaseService: Pool de conexiones centralizado compatible con MySQL (via HikariCP) y SQLite. Todos los plugins obtienen conexiones a través de este servicio.
- MigrationManager: Sistema de migraciones SQL transaccional con seguimiento de versiones.
- PermissionService: Abstracción sobre LuckPerms para consultar prefijos, sufijos y grupos.
- CurrencyService: Abstracción multi-economía compatible con Vault, PlayerPoints y XP.
- NetworkService: Comunicación entre servidores via Redis Pub/Sub y BungeeCord.
- VirtualEntityManager: ArmorStands y TextDisplay ocultos del lado del cliente.
- UiNotificationManager: Sistema temporal de BossBar y ActionBar.
- GuiManager: Listeners globales anti-explotación para inventarios personalizados.
- CrashReporter: Reporte automatizado de errores a logs y webhooks de Discord.
