InventorySync PRO — Instalación

Instalación
Requisitos de esta versión
Servidores de juego: el backend proporcionado está compilado para la API Spigot de Minecraft 26.2 y requiere Java 25+. Incluye planificación para Spigot/Paper/Folia y puede funcionar en versiones compatibles de Purpur. Usa una distribución destinada a tu versión real; esta Wiki no confirma compatibilidad con todas las versiones de Minecraft.
Proxy opcional: BungeeCord o Velocity compatible con tu instalación. Los módulos proxy usan bytecode Java 17, pero debes cumplir el requisito de Java de la versión de proxy utilizada. El módulo de juego sigue requiriendo Java 25+. Los controladores SQLite y MySQL están incluidos en el Universal JAR.

Instalación en un servidor de juego

1. Detén el servidor y, si actualizas, guarda una copia de los datos de jugadores y la carpeta del plugin.
   
2. Coloca InventorySyncPRO-1.7.0-Universal.jar en plugins/. Conserva un solo JAR de InventorySyncPRO; los JAR de módulos Maven no son la distribución final.
   
3. Arranca una vez para generar plugins/InventorySyncPRO/config.yml y messages.yml. Por defecto se usa SQLite, perfiles GLOBAL, sincronización de EnderChest/XP activa y puente proxy desactivado.
   
4. Detén el servidor, elige el modo de perfiles y sus asignaciones y vuelve a iniciarlo. Los cambios de almacenamiento, sincronización y puente del backend requieren un reinicio completo.
   
5. Concede los permisos necesarios al equipo. Prueba reconexiones, cambios de mundo con perfiles distintos, una consulta de datos guardados sin conexión y una copia antes de abrir a los jugadores.
   

Instalación en una red

1. Instala el Universal JAR en cada backend participante. Detenlos mientras preparas ajustes compartidos. Crea una base MySQL y una cuenta con permisos para las tablas del plugin.
   
2. Establece storage.type: MYSQL y la misma base accesible en cada backend. Asigna un storage.server-id único a cada uno. Mantén iguales la configuración completa de sincronización/grupos y la política de administración.
   
3. Elige GLOBAL, PER_WORLD o PER_GROUP. Mantén sync.restore-on-join y sync.kick-on-failure en true; MySQL exige ambos. Consulta el ejemplo Survival-1/Survival-2/Lobby en Configuración.
   
4. Para usar el puente opcional, instala el mismo JAR en BungeeCord o Velocity. Arranca una vez para generar proxy.properties. Activa el puente en backends y proxy y usa el mismo secreto aleatorio en todos.
   
5. Con el puente activo, los ID deben coincidir exactamente con los nombres registrados en el proxy, incluidas mayúsculas. Admiten letras, números, puntos, guiones bajos y guiones, hasta 32 caracteres; ALL está reservado. Usa esos nombres en la lista opcional de permitidos.
   
6. Reinicia backends y proxy. Comprueba el arranque, ejecuta /isync status en cada backend y /isyncproxy status si usas el puente. Prueba con una cuenta de prueba una transferencia, un grupo separado, restauración de XP/EnderChest y una edición remota autorizada.
   

SQLite es local a un backend; no compartas su archivo entre servidores. Configura correctamente el reenvío de UUID y las restricciones de acceso a backends. El proxy no necesita credenciales de base de datos ni sustituye a MySQL.