Plugin de Minecraft QuickShop-Hikari

🔌 Acerca de QuickShop-Hikari

QuickShop-Hikari es un plugin de Minecraft que implementa tiendas de compra/venta basadas en cofres (ChestShops). Los jugadores crean y usan tiendas interactuando con cofres; la mayor parte del juego no requiere comandos. El proyecto está mantenido por la QuickShop-Community y se centra en compatibilidad moderna, seguridad de datos e integraciones extensibles.

🎯 Propósito

Ofrecer una economía dentro del juego basada en objetos, donde los jugadores puedan listar artículos a la venta o crear tiendas de compra usando cofres. El plugin está pensado para administradores de servidores que quieren una economía física, impulsada por cofres, y control por tienda sin obligar a los jugadores a aprender comandos.

⚙️ Características

• Crear tiendas de compra y venta usando cofres y carteles (tiendas basadas en cofres).
• Soporte para datos NBT, encantamientos, durabilidad de objetos, datos de pociones y huevos de mob.
• Objeto de visualización virtual encima de las tiendas con opción de activarlo o desactivarlo (compatible con ProtocolLib o PacketEvents).
• Soporte para cofres ilimitados y comportamiento mixto de compra/venta en cofres dobles.
• Soporte de blacklist con opciones de permiso para omitirla.
• Gestión de permisos por tienda y beneficios de tienda entre propietarios y otros jugadores.
• Soporte i18n para nombres de objetos y encantamientos, y sintaxis MiniMessage para los mensajes.
• Soporte para fuentes de datos H2 (local) y MySQL (remoto).
• Hooks de integración para plugins comunes de protección y utilidad (módulos de compatibilidad disponibles).
• API para desarrolladores (se proporcionan coordenadas Maven/Gradle) para consultar tiendas e integrar funciones.
• Telemetría de bStats con opción de desactivarla mediante la configuración.

🧩 Para quién es

Propietarios y administradores de servidores que ejecutan Survival/SMP o servidores centrados en la economía y quieren un mercado físico basado en cofres. Encaja tanto en servidores pequeños como grandes que usan plugins de economía compatibles con Vault y quieren control por tienda y almacenamiento respaldado por base de datos.

🏗️ Casos de uso de ejemplo

• Los jugadores colocan objetos en un cofre y lo etiquetan para vender automáticamente stacks a otros jugadores.
• Un administrador activa permisos por tienda para que los moderadores puedan gestionar tiendas en mundos o regiones concretas.
• Una red usa almacenamiento MySQL para mantener las tiendas persistentes entre instancias del servidor.

⌨️ Comandos

Nota: la documentación del proyecto indica que el juego normal de los jugadores no requiere comandos; los comandos son principalmente administrativos.

🔐 Permisos

⚙️ Instalación

📥 Configuración

• Descarga el jar oficial de QuickShop-Hikari desde la distribución del proyecto (releases de Modrinth/Spigot/GitHub).
• Coloca el archivo jar en la carpeta plugins/ de tu servidor.
• Inicia el servidor y verifica que el plugin se haya cargado (la documentación muestra ejecutar el comando qs en la consola para mostrar la ayuda/salida de prueba).

📦 Dependencias

Integraciones obligatorias/opcionales confirmadas y enumeradas por el proyecto:

• Vault (requerido para conectar la economía)
• Un plugin de economía compatible con Vault (ejemplos proporcionados por el proyecto)
• ProtocolLib o PacketEvents (requeridos para objetos de visualización virtuales / localización por jugador)
• LuckPerms (recomendado para la gestión de permisos)

🧾 Configuración

• El plugin crea y usa un config.yml (la documentación hace referencia a claves de config.yml para el protocolo de visualización y los ajustes de privacidad).
• El almacenamiento de datos admite H2 local o MySQL remoto; las opciones de configuración están disponibles en los archivos de configuración del plugin.

🧠 Notas técnicas

• La documentación oficial recomienda ejecutarlo en un servidor basado en Paper y documenta un requisito de Java 21.
• El proyecto proporciona una API para desarrolladores y coordenadas Maven/Gradle para uso en tiempo de compilación.
• QuickShop-Hikari incluye módulos de compatibilidad para plugins de terceros (por ejemplo, WorldGuard, WorldEdit, OpenInv) como descargas opcionales.
• Telemetría: usa bStats; se puede desactivar desde la configuración.

🤝 Cuándo es útil este plugin

Si quieres un mercado visible para los jugadores, basado en cofres, con almacenamiento persistente y controles por tienda (en lugar de tiendas solo por GUI o por comandos), QuickShop-Hikari ofrece una implementación moderna, respaldada por base de datos, con hooks para plugins comunes de economía y protección.