faq installation errors

---

title: Errores de instalación description: Soluciones a los fallos más comunes al instalar o arrancar Vault 2.1. Error de Economy, plugin duplicado, MySQL Hikari, Java versión.

FAQ: errores de instalación y arranque

1. [Vault] ERROR: Could not register Economy — another plugin already did it

Otro plugin ya registró la interfaz net.milkbowl.vault.economy.Economy.

Causas típicas:

• Tienes Vault.jar clásico + EssentialsX Economy.jar (Essentials también registra Economy)
• Tienes un plugin antiguo de economía (CMI, Gringotts, etc.)

Solución:

1. Elige un único plugin de economía: si vas a usar Vault 2.1, quita EssentialsX Economy jar y/o el Vault.jar antiguo.
2. O al contrario: si necesitas EssentialsX Economy, quita vault-2.x.x.jar.
3. Reinicia el servidor.

2. HikariPool-1 - Exception during pool initialization (MySQL)

Database no puede conectar al pool HikariCP.

Pasos a revisar:

storage:
  use_mysql: true
  mysql:
    host: 127.0.0.1      # Asegúrate de que no sea localhost si usas socket
    port: 3306
    database: vault      # ¿Existe la BD? Haz CREATE DATABASE vault;
    username: vaultuser
    password: "correcta" # Comillas dobles si tiene caracteres especiales

Orden de comprobación:

1. Abre una shell y prueba: mysql -h127.0.0.1 -uvaultuser -p vault -e "SELECT 1"
2. Verifica useSSL=false&serverTimezone=UTC&allowPublicKeyRetrieval=true en params: si usas MySQL 8.
3. Asegúrate de que el pool no esté agotado (pool_size: 10 por defecto; no subaslo innecesariamente).
4. Mira el stacktrace: si dice Communications link failure es red/firewall; si Access denied es credenciales.

3. NoSuchMethodError: PlayerProfile / SkinsRestorer

La cabeza en /pay no se renderiza.

Causas:

• Estás en Spigot 1.12 o anterior sin SkinsRestorer.
• La reflection applyLivePlayerProfile / applySkinRestorerSkin no encuentra la API.

Solución:

• Instala SkinsRestorer (el plugin intenta cargar net.skinsrestorer.api.SkinsRestorerProvider dinámicamente).
• Asegúrate de que softdepend: [SkinsRestorer] quede antes en el arranque.

4. UnsupportedClassVersionError al cargar

Estás usando una versión de Java anterior a la compilada.

JAR	Java mínimo
vault-2.1.0-java17.jar	Java 17
vault-2.1.0-java21.jar	Java 21

Comprueba con java -version. Si tu panel/host solo da Java 16 o inferior, actualiza el runtime del servidor.

5. Mensajes aparecen como pay.only_players (sin traducir)

Messages no encontró el archivo de idioma.

Solución:

1. Confirma que plugins/Vault/messages/messages_en.yml (o el que corresponda) existe y no está corrupto. Si lo borraste por accidente, reinstala el JAR para que se generen de nuevo.
2. En config.yml comprueba language: en (debe ser uno de: en, es, fr, de, nl, pl, pt, ru, zh_CN, zh_TW, hi).
3. Ejecuta /vault reload. Si sigue fallando, borra la carpeta messages/ y deja que el plugin la regenere.

6. WARN: Failed to create transactions JSON log

Fallo al crear logs/daily-YYYY-MM-DD.json.

Causa habitual: permisos de escritura del usuario de Windows/Linux sobre plugins/Vault/.

Solución:

• En Linux: chown -R minecraft:minecraft plugins/Vault y chmod -R u+rwX plugins/Vault
• En Windows: botón derecho → Propiedades → Seguridad → Asegura que el usuario del servidor tenga "Escritura"
• El log diario no es obligatorio para funcionar; sin él sigues teniendo FileTxDAO/MySqlTxDAO.