InventorySync PRO — Installation

Installation
Prérequis de cette version
Serveurs de jeu : le backend fourni cible l’API Spigot de Minecraft 26.2 et nécessite Java 25+. Il inclut la planification Spigot/Paper/Folia et peut fonctionner sur des versions compatibles de Purpur. Utilisez une distribution adaptée à votre version ; ce Wiki ne garantit pas la compatibilité avec toutes les versions de Minecraft.
Proxy facultatif : BungeeCord ou Velocity compatible avec votre installation. Les modules proxy utilisent du bytecode Java 17, mais il faut respecter le prérequis Java de votre version de proxy. Le module de jeu exige toujours Java 25+. Les pilotes SQLite et MySQL sont inclus dans le Universal JAR.

Installer sur un serveur de jeu

1. Arrêtez le serveur et, pour une mise à jour, sauvegardez les données des joueurs et le dossier du plugin.
   
2. Placez InventorySyncPRO-1.7.0-Universal.jar dans plugins/. Gardez un seul JAR InventorySyncPRO ; les JAR de modules Maven ne sont pas la distribution finale.
   
3. Démarrez une fois pour créer plugins/InventorySyncPRO/config.yml et messages.yml. Par défaut : SQLite, profils GLOBAL, synchronisation coffre de l’Ender/XP activée et pont proxy désactivé.
   
4. Arrêtez le serveur, choisissez le mode de profils et les correspondances, puis redémarrez. Les changements de stockage, de synchronisation et de pont backend exigent un redémarrage complet.
   
5. Accordez les permissions nécessaires à l’équipe. Testez reconnexion, mondes de profils différents, consultation hors ligne et sauvegarde avant d’ouvrir aux joueurs.
   

Installer sur un réseau

1. Installez le Universal JAR sur chaque backend participant. Arrêtez-les pour préparer les réglages communs. Créez une base MySQL et un compte autorisé à utiliser les tables du plugin.
   
2. Définissez storage.type: MYSQL et la même base accessible sur chaque backend. Attribuez un storage.server-id unique à chacun. Gardez identiques les paramètres complets de synchronisation/groupes et la politique d’administration.
   
3. Choisissez GLOBAL, PER_WORLD ou PER_GROUP. Gardez sync.restore-on-join et sync.kick-on-failure à true ; MySQL exige les deux. Consultez l’exemple Survival-1/Survival-2/Lobby dans Configuration.
   
4. Pour le pont facultatif, installez le même JAR sur BungeeCord ou Velocity. Démarrez une fois pour générer proxy.properties. Activez le pont sur les backends et le proxy avec le même secret aléatoire partout.
   
5. Avec le pont, les ID doivent correspondre exactement aux noms enregistrés sur le proxy, casse comprise. Lettres, chiffres, points, tirets bas et tirets sont autorisés, avec 32 caractères au maximum ; ALL est réservé. Utilisez ces noms dans la liste facultative des serveurs autorisés.
   
6. Redémarrez backends et proxy. Vérifiez le démarrage, exécutez /isync status sur chacun et /isyncproxy status si le pont est utilisé. Avec un compte de test, vérifiez un transfert, un groupe séparé, la restauration XP/coffre de l’Ender et une modification distante autorisée.
   

SQLite est local à un backend ; ne partagez pas son fichier entre serveurs. Configurez correctement le transfert d’UUID et les restrictions d’accès aux backends. Le proxy n’a pas besoin des identifiants de la base et ne remplace pas MySQL.