Saltar al contenido principal

Integración con Vault

A partir de la versión 7.1.0, EliteMobs admite la integración con Vault (usando VaultAPI 1.7). Puedes activar Vault para unificar la economía de EliteMobs con la economía de tu servidor.

Ahora aquí está por qué es una mala idea:

EliteMobs no tiene sistema de niveles. El sistema de progresión está vinculado a obtener mejores objetos matando Elite Mobs y subiendo de nivel las habilidades de armas y armadura para acceder a botín de nivel más alto, mobs de nivel más alto, misiones de nivel más alto y desafíos de arena y mazmorras de nivel más alto.

Además, EliteMobs tiene un equilibrio muy delicado cuando se trata de comprar amuletos y revender botín obtenido de Elite Mobs.

Por lo tanto, si combinas la economía de tu servidor con la economía de EliteMobs, los jugadores podrán fácilmente comprar su camino hasta la cima, potencialmente evitando la curva de aprendizaje.

Ahora el sistema de progresión no funcionará correctamente, lo que lleva a problemas aún peores. Los Elite Mobs de alto nivel tienen varios poderes, y los jugadores están destinados a aprender lentamente esos poderes luchando contra ellos durante docenas de horas, aprendiendo cómo identificar los poderes que tienen los Elite Mobs y cómo contrarrestar esos poderes, así como aprender cómo prepararse para entrar en combate contra Elite Mobs.

Si los jugadores saltan directamente al endgame, sentirán que la dificultad del combate es casi imposible y extremadamente injusta, ya que no habrán tenido tiempo de desarrollar el conocimiento requerido para matar a los EliteMobs eficientemente a través de largas horas de juego.

Requisitos​

Para usar la integración con Vault, debes tener:

  • Plugin Vault (versión compatible con VaultAPI 1.7+)
  • Un plugin de economía que se registre con Vault (EssentialsX, CMI, etc.)
  • Ambos plugins correctamente configurados y funcionando

EliteMobs detectará automáticamente Vault y lo usará si está habilitado en la configuración.

Configuración​

Para habilitar la integración con Vault:

  1. Asegúrate de que el plugin Vault esté instalado en tu servidor
  2. Asegúrate de tener un plugin de economía que funcione con Vault (por ejemplo, EssentialsX, CMI, etc.)
  3. Abre EconomySettings.yml en la carpeta del plugin EliteMobs
  4. Establece useVault - not recommended: true
  5. Reinicia el servidor

Ejemplo de configuración:

# ADVERTENCIA: Habilitar esto no es recomendable. Ver arriba las razones.
useVault - not recommended: false

Nota: La clave de configuración incluye deliberadamente "- not recommended" para recordarte las implicaciones de jugabilidad.

Cómo Funciona​

Cuando la integración con Vault está habilitada:

  • Toda la moneda de EliteMobs (Monedas Élite) se convierte en la moneda de economía principal de tu servidor
  • Los jugadores ganan la moneda de tu economía en lugar de Monedas Élite al matar Elite Mobs
  • Las transacciones de tienda, mejoras de habilidades y todas las demás características de economía de EliteMobs usan la economía de tu servidor
  • El sistema de economía de EliteMobs se reemplaza completamente por Vault

Operaciones de moneda:

  • Depósitos: El dinero se añade al saldo de Vault del jugador
  • Retiros: El dinero se elimina del saldo de Vault del jugador
  • Consultas de saldo: Consulta el saldo de Vault del jugador
  • Establecimiento directo de saldo: DESHABILITADO por seguridad (usa tu plugin de economía)

Si Vault falla al inicializarse o deja de estar disponible, EliteMobs volverá automáticamente a su sistema de economía interna.

Características de Seguridad​

Por razones de seguridad, EliteMobs NO admite establecer directamente el saldo de moneda de un jugador a través de Vault. Cualquier intento de hacerlo será bloqueado y registrado. Usa los comandos de tu plugin de economía para establecer saldos directamente si es necesario.

Escenario de Ejemplo​

Sin Vault:

  • El jugador mata un Elite Mob de nivel 50
  • Recibe 100 Monedas Élite (almacenadas en la base de datos de EliteMobs)
  • Puede gastar Monedas Élite solo en tiendas de EliteMobs

Con Vault:

  • El jugador mata un Elite Mob de nivel 50
  • Recibe 100 [tu moneda de economía] (almacenadas en Vault/plugin de economía)
  • Puede gastar dinero en tiendas de EliteMobs Y en cualquier otro lugar del servidor
  • Otros jugadores pueden enviar dinero para comprar servicios de EliteMobs
  • La economía está unificada en todos los plugins

Por eso no es recomendable: Rompe el sistema de progresión previsto al permitir a los jugadores usar moneda de otras fuentes.

Solución de Problemas​

Si la integración con Vault está habilitada pero no funciona:

  1. Verifica los logs del servidor para: "[EliteMobs] Vault detected."

    • Si falta: El plugin Vault no está instalado o no se está cargando

  2. Verifica si hay una advertencia: "Something went wrong with the vault configuration"

    • Causa: Incompatibilidad de versión de Vault
    • Solución: Actualiza Vault a la última versión o deshabilita la integración

  3. Verifica si hay: "Player checked currency with no economy entry"

    • Causa: El plugin de economía no ha creado una cuenta de jugador
    • Solución: Verifica la configuración de tu plugin de economía

  4. Si está habilitado pero EliteMobs sigue usando Monedas Élite:

    • Verifica que la clave de configuración sea exactamente: "useVault - not recommended: true"
    • Reinicia el servidor después del cambio de configuración
    • Verifica que un plugin de economía esté registrado con Vault

Para Desarrolladores​

Si estás desarrollando un addon o integración:

  • Estado de Vault: Verifica VaultCompatibility.VAULT_ENABLED (booleano estático)
  • API de Economía: Usa métodos de EconomyHandler (no VaultCompatibility directamente)
  • Operaciones admitidas: agregar, restar, verificar (establecer está deshabilitado)
  • Precisión de moneda: El sistema interno usa 2 decimales
  • Respaldo: La economía vuelve automáticamente al sistema interno si Vault falla

Ubicación del código fuente:

  • src/main/java/com/magmaguy/elitemobs/economy/VaultCompatibility.java
  • src/main/java/com/magmaguy/elitemobs/economy/EconomyHandler.java

EliteMobs usa VaultAPI 1.7 como una dependencia solo de compilación. El JAR del plugin Vault debe estar presente en el servidor en tiempo de ejecución.