🥥CocoVaults

¡Aquí encontrarás instrucciones para saber cómo configurar el plugin de CocoVaults!

Documentación del Plugin CocoVaults

¡Nota Importante! Este es el primer plugin premium desarrollado por nuestro estudio y continuaremos actualizándolo. Este plugin permite otorgar cofres virtuales a los jugadores de tu servidor. Es altamente modificable y soporta MySQL, MariaDB y SQLite.

¿Cómo configurar este plugin?

El plugin es relativamente sencillo de configurar y es totalmente editable. Puedes elegir si deseas almacenar los datos utilizando MySQL, MariaDB, SQLite o YAML local.

Archivo Settings.yml

El archivo de configuración en formato YAML utiliza MiniMessage para su personalización. Puedes editarlo según tus necesidades.

# Version of the configuration file / plugin, do not
# modify this file or you will disrupt the
# version and a new file will be created.
Config-Version: 1.6.4
Plugin-Version: 1.6.4

# Plugin Storage, you can edit them according to your needs.
Storage-Mode:
  Mode: YAML # Available: YAML, MySQL, MariaDB, SQLite

  MySQL-Data:
    host: 127.0.0.1
    port: 3306
    name: DatabaseName
    user: root
    password: root

  MariaDB-Data:
    host: 127.0.0.1
    port: 3310
    name: DatabaseName
    user: root
    password: root

  SQLite-Data:
    file: database.db

# Plugin permissions
# The vault permissions is: cocovaults.quantity.X

Plugin-Permissions:
  ALL: cocovaults.*
  Open-Vaults: cocovaults.open
  Admin-Vaults: cocovaults.admin
  Change-Icons: cocovaults.icons
  Rename: cocovaults.rename

# Plugin messages, you can edit them according to your needs.
Messages:
  Prefix: '<aqua>Coco</aqua><white>Vaults</white> <dark_gray><bold>» </bold></dark_gray>'
  No-Perms: "<red>You don't have permissions to run this command"
  No-Subcmd: "<red>This command doesn't exist"
  No-Player-Found: "<red>This player doesn't exist"
  Reloading: "<yellow>Reloading..."
  Reloaded-Success: "<green>Config was reloaded correctly"
  Only-players: "<red>This command can only be used by players"
  Full-Space: "<red>You can't fit any more things in your Vault"
  No-More-Vaults: "<red>You cannot open more vaults"
  No-Admin: "<red>You cannot open other players' Vaults"
  Blacklisted-Item: "<red>You can't save this in Vaults"
  Opened-Vault: "<green>Vault %vault% opened successfully"
  Changed-Icon: "<green>Vault icon changed correctly"
  Analysis-Error: "<red>There was an error when making this request"
  Saved-Vault: "<green>Vault closed correctly"
  Invalid-Material: "<red>Invalid item material."
  Invalid-Vault: "<red>Invalid vault number."
  Vault-Deleted: "<red>Vault deleted successfully."
  Vault-Restored: "<green>Vault restored successfully"
  Data-Loading-Error: "<red>Plugin data has not loaded yet"
  GUI-Item-Name: "<white>CocoVault <green>%vault%"
  Vault-Closed-Due-To-Inactivity: "<red>The vault was closed due to inactivity"
  No-Valid-Count-Give: '<red>Invalid number of Vaults'
  Gived-Vaults: '<green>You gave %count% number of Vaults to %player%'
  Conversion-Started: "<yellow>Starting conversion of all data from PlayerVaultsX..."
  Conversion-Complete: "<green>Conversion from PlayerVaultsX has completed successfully! %vaults% %players% player vaults have been converted."
  Import-Confirmation: "<yellow>This action will overwrite existing data. Enter the command again to confirm the import."

# GUI Messages
GUIs:
  Vault-List-GUI: "<black>CocoVaults GUI - Page %page%"
  GUI-Item-Name: "<white>CocoVault <green>%vault%"
  Player-Vault: "<black>CocoVault %vault%"
  Next-Page-Button: "<white>Next Page ➡"
  Previous-Page-Button: "<white>⬅ Previous Page"

# Blacklist
Item-BlackList:
  - DIAMOND_BLOCK
  - DIAMOND

Claves de Configuración:

  1. Config-Version y Plugin-Version: No se recomienda modificar estas claves, ya que están relacionadas con la verificación de errores y versiones. Si se alteran, tu configuración se eliminará al actualizar el plugin.

  2. Storage-Mode: Puedes seleccionar el modo de almacenamiento: YAML, MySQL, MariaDB, o SQLite. Para MySQL o MariaDB, simplemente introduce las credenciales de la base de datos. Para SQLite, especifica el nombre del archivo de base de datos.

  3. Plugin-Permissions:

    • ALL: Todos los permisos del plugin.

    • Open-Vaults: Permiso para abrir los vaults.

    • Admin-Vaults: Permiso para administrar los vaults.

    • Change-Icons: Permiso para cambiar los iconos de los vaults.

    • Rename: Permiso para renombrar los vaults.

  4. Messages: Todos los mensajes son completamente personalizables. Puedes adaptarlos a las necesidades de tu servidor.

  5. GUIs: Mensajes personalizados para la interfaz gráfica del usuario (GUI).

  6. Item-BlackList: Lista de ítems que no se pueden guardar en los vaults.

¿Cómo conectar este plugin a una Base de Datos?

El plugin anteriormente usaba JDBC directo para conectarse a las bases de datos. Ahora, simplemente introduce las credenciales para MariaDB o MySQL en el archivo de configuración.

Comandos del Plugin:

  • /cocovaults <VAULT> - Abre un Vault.

  • /cocovaults GUI - Abre el menú de tus vaults, mostrando todos los vaults disponibles.

  • /cocovaults icon <MATERIAL> <VAULT> - Cambia el ícono del vault en la GUI.

  • /cocovaults admin reload - Recarga la configuración del plugin.

  • /cocovaults admin forceopen <JUGADOR> <VAULT> - Fuerza la apertura del vault de un jugador.

  • /cocovaults admin view <JUGADOR> <VAULT> - Abre el vault de un jugador como administrador.

Permisos del Plugin:

  • Permiso de cantidad: cocovaults.quantity.X

  • Permisos generales:

    • cocovaults.*: Todos los permisos del plugin.

    • cocovaults.open: Permiso para abrir los vaults.

    • cocovaults.admin: Permiso para administrar los vaults.

    • cocovaults.icons: Permiso para cambiar los iconos de los vaults.

Lista Negra de Ítems:

Puedes bloquear ítems específicos que no deseas que se guarden en los vaults mediante la sección Item-BlackList.

¿Ítems Custom y CustomModelData?

¡Claro que hay soporte! Los usuarios pueden guardar cualquier objeto en los vaults, incluyendo:

  • CustomModelData

  • Objetos de ItemsAdder y Oraxen

  • Objetos con datos NBT Custom

¿Soporta Servidores Cruzados?

¡Sí, soporta servidores cruzados! Las consultas se realizan en tiempo real para compartir e insertar datos, lo que puede afectar ligeramente la jugabilidad, pero sigue siendo igual de efectivo. No hay problemas de lag, ya que todas las tareas se ejecutan de manera asincrónica al hilo principal del servidor.

¿Cómo usar el Importador?

El plugin CocoVaults incluye una función de importación que te permite migrar datos desde otros plugins de vaults, como PlayerVaultsX. Esta herramienta es útil si deseas cambiar a CocoVaults sin perder los datos existentes de los jugadores.

Pasos para Usar el Importador:

  1. Realiza una Copia de Seguridad: Antes de comenzar, es fundamental que realices una copia de seguridad de tus datos actuales. Esto incluye los datos de CocoVaults y del plugin desde el cual deseas importar (por ejemplo, PlayerVaultsX). La importación puede sobrescribir datos existentes, y una copia de seguridad te permitirá restaurar la información si es necesario.

  2. Verifica la Instalación del Plugin de Origen: Asegúrate de que el plugin desde el cual deseas importar datos (por ejemplo, PlayerVaultsX) esté instalado y funcionando correctamente en tu servidor. Los datos deben ser accesibles para que la importación sea exitosa.

  3. Ejecuta el Comando de Importación:

    • Utiliza el siguiente comando para iniciar la importación:

      /cocovaults admin import PlayerVaultsX

    • Advertencia: Al ejecutar este comando por primera vez, el plugin te solicitará una confirmación debido a que la importación puede sobrescribir datos existentes.

    • Recibirás un mensaje como:

      Esta acción sobrescribirá datos existentes. Escribe el comando de nuevo para confirmar la importación.

  4. Confirma la Importación:

    • Vuelve a ejecutar el comando exactamente de la misma manera:

      /cocovaults admin import PlayerVaultsX

    • Al confirmar, el plugin comenzará el proceso de importación de los datos.

  5. Espera la Finalización del Proceso:

    • El plugin mostrará mensajes indicando el progreso de la importación.

    • Una vez completado, recibirás un mensaje de éxito como:

      ¡La conversión desde PlayerVaultsX se ha completado con éxito! Se han convertido X vaults de X jugadores.

Notas Importantes:

  • Sobrescritura de Datos: Ten en cuenta que este proceso puede sobrescribir los datos existentes en CocoVaults. Asegúrate de que estás dispuesto a proceder antes de confirmar la importación.

  • Soporte Limitado: Actualmente, el importador soporta la migración desde PlayerVaultsX. El soporte para otros plugins podría añadirse en futuras actualizaciones.

  • Compatibilidad: Verifica que tanto CocoVaults como el plugin de origen sean compatibles con la versión de tu servidor y que estén actualizados.

  • Permisos Necesarios: Para ejecutar el comando de importación, necesitas tener el permiso cocovaults.admin.import.

Soporte para Servidores Híbridos como ArcLight

CocoVaults es compatible con servidores híbridos como ArcLight, que permiten combinar las funcionalidades de Bukkit/Spigot y mods de Forge. Esto te brinda la flexibilidad de utilizar CocoVaults en entornos donde los jugadores pueden disfrutar tanto de plugins como de mods.

Beneficios de Usar CocoVaults en Servidores Híbridos:

  • Integración Fluida: El plugin está diseñado para funcionar sin problemas en servidores que utilizan una combinación de mods y plugins, manteniendo la estabilidad y el rendimiento.

  • Compatibilidad con Ítems Custom: CocoVaults soporta ítems con CustomModelData, objetos de ItemsAdder y Oraxen, así como ítems con datos NBT personalizados. Esto es especialmente útil en servidores moddeados donde los ítems personalizados son comunes.

  • Almacenamiento de Ítems de Mods: Los jugadores pueden almacenar ítems provenientes de mods en sus bóvedas virtuales, ofreciendo una experiencia de juego más integrada y conveniente.

Consideraciones al Utilizar CocoVaults en Servidores Híbridos:

  • Pruebas Previas: Se recomienda realizar pruebas exhaustivas en un entorno de desarrollo antes de implementar el plugin en tu servidor híbrido de producción para asegurar la compatibilidad y detectar posibles conflictos.

  • Actualizaciones y Soporte: Mantén el plugin actualizado a la última versión para garantizar la mejor compatibilidad y rendimiento en entornos híbridos. Si encuentras algún problema, puedes contactar al equipo de soporte para obtener asistencia.

  • Rendimiento: CocoVaults está optimizado para minimizar el impacto en el rendimiento del servidor, ejecutando operaciones pesadas de manera asíncrona para evitar lag y asegurar una experiencia fluida para los jugadores.

Demostración de Uso:

AnteriorDS-Ads

Última actualización