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 bien, aquí está por qué eso es una mala idea:

EliteMobs no tiene sistema de niveles. El sistema de progresión está ligado a conseguir mejores objetos matando Mobs Élite y subiendo de nivel las habilidades de arma y armadura para acceder a botín de mayor nivel, mobs de mayor nivel, misiones de mayor nivel y desafíos de arena y mazmorras de mayor nivel.

Además, EliteMobs tiene un equilibrio muy delicado en lo que respecta a la compra de amuletos y la reventa del botín obtenido de los Mobs Élite.

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

Ahora el sistema de progresión no funcionará correctamente, lo que lleva a problemas aún peores. Los Mobs Élite de nivel alto tienen diversos poderes, y se supone que los jugadores deben aprenderlos lentamente luchando contra ellos durante decenas de horas, aprendiendo a identificar los poderes que tienen los Mobs Élite y cómo contrarrestarlos, además de aprender a prepararse para entrar en combate contra Mobs Élite.

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 necesario para matar a los EliteMobs de forma eficiente a través de largas horas de juego.

Requisitos​

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

  • El 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 en funcionamiento

EliteMobs detectará Vault automáticamente 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 (p. ej., EssentialsX, CMI, etc.)
  3. Abre EconomySettings.yml en la carpeta del plugin EliteMobs
  4. Establece useVault: true
  5. Reinicia el servidor

Ejemplo de configuración:

# Whether to use Vault for the economy instead of the built-in system.
# NOT RECOMMENDED! See: https://wiki.nightbreak.io/EliteMobs/vault
useVault: false

Cómo funciona​

Cuando la integración con Vault está habilitada:

  • Toda la moneda de EliteMobs (Monedas Élite) se convierte a la moneda principal de la economía de tu servidor
  • Los jugadores ganan la moneda de tu economía en lugar de Monedas Élite al matar Mobs Élite
  • Las transacciones de tienda, las mejoras de habilidad y todas las demás funciones de economía de EliteMobs usan la economía de tu servidor
  • El sistema de economía de EliteMobs queda completamente reemplazado 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
  • Comprobaciones de saldo: Consulta el saldo de Vault del jugador
  • Establecimiento directo de saldo: DESHABILITADO por seguridad (usa tu plugin de economía)

Nota: Mientras la integración con Vault está habilitada, todas las operaciones de moneda se enrutan a Vault. EliteMobs no recurre silenciosamente a su economía interna si Vault deja de estar disponible en tiempo de ejecución, así que asegúrate de que tu plugin de economía siga registrado con Vault mientras useVault esté activado.

Funciones de seguridad​

Por motivos 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 a un Mob Élite de nivel 50
  • Recibe 100 Monedas Élite (almacenadas en la base de datos de EliteMobs)
  • Solo puede gastar Monedas Élite en las tiendas de EliteMobs

Con Vault:

  • El jugador mata a un Mob Élite de nivel 50
  • Recibe 100 [moneda de tu economía] (almacenadas en Vault/plugin de economía)
  • Puede gastar dinero en las 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 entre todos los plugins

Por esto no se recomienda: rompe el sistema de progresión previsto al permitir que los jugadores usen moneda de otras fuentes.

Solución de problemas​

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

  1. Comprueba los registros del servidor en busca de: "Vault detected." (en una línea de registro de EliteMobs)

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

  2. Comprueba la advertencia: "Vault preference detected. This is not the recommended setting."

    • Esto es lo esperado cuando la integración con Vault está habilitada: es un recordatorio, no un error
    • Si Vault sigue sin funcionar, asegúrate de que tu plugin de economía esté correctamente registrado con Vault

  3. Comprueba si aparece: "Player tried to check currency when they had no economy entry"

    • Causa: el plugin de economía no ha creado la cuenta del jugador
    • Solución: revisa 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: true
    • Reinicia el servidor tras el cambio de configuración
    • Comprueba que haya un plugin de economía registrado con Vault

Para desarrolladores​

Si estás desarrollando un complemento o una integración:

  • Estado de Vault: Comprueba VaultCompatibility.VAULT_ENABLED (booleano estático)
  • API de economía: Usa los métodos de EconomyHandler (no VaultCompatibility directamente)
  • Operaciones admitidas: add, subtract, check (set está deshabilitado)
  • Precisión de la moneda: el sistema interno usa 2 decimales
  • Sin recurso de respaldo en tiempo de ejecución: cuando VAULT_ENABLED es true, EconomyHandler siempre delega en Vault; no hay cambio automático de vuelta a la economía interna

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 dependencia solo de compilación. El JAR del plugin Vault debe estar presente en el servidor en tiempo de ejecución.