Une passerelle entre les plugins

VaultUnlocked, affiché sous le nom Vault par le serveur, fournit un langage commun aux plugins de permissions, de discussion et d'économie. Il ne crée pas lui-même les Écus du Lion et ne conserve pas le portefeuille des joueurs.

Sur la copie locale vérifiée, EssentialsX fournit l'économie utilisée par l'hôtel des ventes. Vault sert de passerelle afin que les plugins compatibles lisent et modifient le même solde.

Le trajet d'une transaction

Lorsqu'un joueur achète ou vend un objet :

1. le plugin concerné calcule le montant et demande une opération économique ;
2. Vault transmet cette demande au fournisseur d'économie actif ;
3. EssentialsX Economy débite ou crédite le compte ;
4. le plugin termine la vente, le remboursement ou le versement ;
5. /balance affiche ensuite le solde de référence.

Cette séparation permet à l'économie WaterCraft, à l'hôtel des ventes et aux commandes EssentialsX d'utiliser la même monnaie sans maintenir plusieurs portefeuilles indépendants.

Commandes pour les joueurs

Il n'existe aucune commande Vault destinée aux joueurs. Pour consulter ton argent, utilise /balance. Les autres commandes économiques sont expliquées dans Économie de Waterloo et Hôtel des ventes.

Si une commande affiche « économie indisponible », ne répète pas immédiatement un achat. Le premier débit peut avoir réussi alors que le message final a échoué.

Signaler une transaction incorrecte

Transmets à l'équipe :

• ton pseudo exact ;
• la date et l'heure ;
• le solde avant et après si tu les connais ;
• le montant attendu ;
• la commande ou le menu utilisé ;
• l'objet, le contrat ou le numéro de vente concerné ;
• le message reçu et une capture d'écran.

Ne recrée pas plusieurs fois la même vente pour « tester ». Cela peut produire de nouveaux mouvements d'argent et compliquer la comparaison des journaux.

Commandes de l'équipe

/vault-convert ne doit pas être exécutée sur une intuition. Une mauvaise source, une mauvaise destination ou une seconde conversion peut dupliquer ou écraser des soldes.

Vérification de l'équipe après un démarrage

1. Lire la console et confirmer que Vault, EssentialsX et les plugins économiques sont tous activés sans erreur.
2. Utiliser /vault-info pour identifier les services réellement enregistrés.
3. Vérifier que l'hôtel des ventes annonce le fournisseur économique attendu.
4. Consulter /balance sur un compte de test dont le solde est connu.
5. Effectuer une seule opération contrôlée dans le système à tester.
6. Comparer le résultat du menu, le nouveau /balance et les journaux du plugin.
7. Annuler proprement le test avec la fonction prévue par le plugin ; ne pas corriger la base à la main.

Une activation verte de Vault ne garantit pas à elle seule que chaque plugin a trouvé le bon fournisseur. Il faut lire les lignes de démarrage des consommateurs concernés.

Préparer une migration économique

Une conversion de fournisseur est une maintenance majeure.

1. Fermer les ventes et empêcher les nouvelles transactions.
2. Exporter ou relever les soldes de contrôle.
3. Arrêter le serveur et produire une sauvegarde réellement vérifiée.
4. Identifier les noms exacts de l'ancien et du nouveau fournisseur avec /vault-info et leur documentation.
5. Tester la conversion sur une copie séparée du serveur.
6. Comparer plusieurs comptes, y compris un compte à zéro et un compte avec un solde élevé.
7. Ne lancer la conversion en production qu'après validation et avec un plan de retour arrière.

Consulte Backuper avant toute migration. Le système de sauvegarde local étant encore à valider, aucune conversion économique ne doit dépendre d'une archive de 0 octet.

Dépannage

/balance fonctionne, mais pas l'hôtel des ventes

Le fournisseur d'économie fonctionne probablement, mais le plugin d'enchères peut ne pas être relié ou avoir refusé l'opération. Contrôle ses journaux et sa configuration avant de modifier Vault.

Plusieurs plugins affichent des soldes différents

Arrête les transactions, relève un échantillon de comptes et vérifie le fournisseur annoncé par chaque plugin. Ne lance pas /vault-convert avant d'avoir identifié l'origine exacte de chaque solde.

Vault n'apparaît pas au démarrage

Vérifie que le fichier VaultUnlocked-2.20.2.jar est présent, compatible et chargé avant les plugins qui en dépendent. Conserve la totalité du journal de démarrage ; une ligne isolée ne suffit pas à trouver l'ordre d'échec.

Les grades ou préfixes semblent touchés

Vault peut aussi exposer les permissions et le chat, mais les groupes WaterCraft restent gérés par LuckPerms. Diagnostique le fournisseur concerné sans modifier l'économie.