Qué es ShopGUI+

ShopGUI+ es un plugin de servidor que reemplaza las tiendas tradicionales de carteles (ChestShop, QuickShop) con una interfaz gráfica completa. El jugador escribe /shop, se abre un menú de categorías (bloques, comida, armas, herramientas, etc.), y elige una categoría y luego un objeto concreto para comprar o vender.

Es un plugin de pago en SpigotMC, pensado para tiendas de admin: el admin define el stock y los precios, y los jugadores solo compran y venden. ShopGUI+ no admite tiendas administradas por jugadores (para eso sigues necesitando QuickShop Hikari o ChestShop).

El plugin está disponible en SpigotMC. Requiere Vault y cualquier plugin de economía (EssentialsX, CMI, CoinsEngine). Opcionalmente admite PlaceholderAPI.

Interfaz y categorías

El menú de ShopGUI+ tiene dos niveles:

Menú principal - una lista de categorías (por ejemplo Bloques, Armas, Herramientas, Comida, Decoraciones). Cada categoría tiene su propio ícono en el menú.
Menú de categoría - una lista de objetos con precios de compra y venta. El jugador hace clic izquierdo para comprar y clic derecho para vender.

Al hacer clic en un objeto se abre una ventana para elegir la cantidad: 1, 8, 16, 32, 64 o una cantidad personalizada. El jugador ve el costo total antes de confirmar la transacción. Toda la interacción ocurre en la GUI: sin escribir comandos y sin carteles en el mundo del juego.

El admin define las categorías y los productos en archivos YAML dentro de la carpeta plugins/ShopGUIPlus/shops/. Cada categoría es un archivo aparte, lo que ayuda a mantener el orden en servidores con mucha variedad.

Configuración de la tienda

Un ejemplo de configuración de categoría en plugins/ShopGUIPlus/shops/blocks.yml:

shop:
  name: "Bloques"
  icon:
    material: GRASS_BLOCK
  items:
    stone:
      material: STONE
      buyPrice: 5.0
      sellPrice: 2.5
      slot: 0
    oak_log:
      material: OAK_LOG
      buyPrice: 8.0
      sellPrice: 4.0
      slot: 1
    cobblestone:
      material: COBBLESTONE
      buyPrice: 3.0
      sellPrice: 1.5
      slot: 2

Cada objeto tiene un precio de compra (buyPrice), un precio de venta (sellPrice) y una posición en el menú (slot). Puedes definir solo uno de los precios: si omites sellPrice, los jugadores no podrán vender ese objeto.

ShopGUI+ también admite comandos de venta: el admin puede añadir un producto que ejecute un comando en el servidor al comprarlo (por ejemplo, dar un rango, un kit o un efecto). Es útil para vender servicios y ventajas sin objetos físicos.

Precios dinámicos

ShopGUI+ tiene un sistema integrado de precios dinámicos basado en la oferta y la demanda. Cuando los jugadores compran un objeto en grandes cantidades, su precio sube. Cuando lo venden en grandes cantidades, el precio baja. Es un mecanismo natural para equilibrar el mercado.

Configuración de los precios dinámicos en config.yml:

dynamicPricing:
  enabled: true
  maxBuyMultiplier: 2.0      # buy price max 2x base
  minBuyMultiplier: 0.5      # buy price min 0.5x base
  maxSellMultiplier: 2.0     # sell price max 2x base
  minSellMultiplier: 0.5     # sell price min 0.5x base
  resetInterval: 24          # reset prices every 24 hours

Los precios dinámicos son opcionales. Muchos servidores prefieren precios fijos para que los jugadores sepan cuánto van a pagar. Activa esta función solo en servidores con muchas transacciones, donde las variaciones de precio tengan sentido económico.

Comandos y permisos

Comando	Descripción	Permiso
`/shop`	Abre el menú principal de la tienda	shopguiplus.shop
`/shop [category]`	Abre una categoría concreta	shopguiplus.shop
`/sell hand`	Vende el objeto que tienes en la mano	shopguiplus.sell.hand
`/sell all`	Vende todo lo que hay en tu inventario	shopguiplus.sell.all
`/sellgui`	Abre la GUI de venta (suelta los objetos dentro)	shopguiplus.sellgui
`/shopreload`	Recarga la configuración	shopguiplus.reload

Los permisos de ShopGUI+ se controlan con LuckPerms. Puedes restringir el acceso a categorías concretas por rango con los permisos shopguiplus.shop.[category].

Consejos para admins

Pon siempre los precios de venta por debajo de los de compra - define sellPrice entre el 40 y el 60% de buyPrice. Así evitas exploits en los que un jugador compra y vende de inmediato para ganar dinero.
Usa /sell all en servidores de Skyblock/Prison - los jugadores que farmean grandes cantidades de recursos agradecerán poder vender todo su inventario con un comando.
Tiendas separadas por mundo - ShopGUI+ admite una selección distinta en cada mundo. Útil en servidores con varios modos de juego.
Integración con rankings - usa PlaceholderAPI para mostrar a los mejores comerciantes en rankings.
No exageres con la variedad - con 50 a 100 productos basta. Una tienda demasiado grande abruma a los jugadores y arruina una economía basada en el comercio entre jugadores.

Artículos relacionados: Vault, EssentialsX, QuickShop Hikari, catálogo de plugins.