O que é o ShopGUI+

O ShopGUI+ é um plugin de servidor que substitui as lojas tradicionais com placas (ChestShop, QuickShop) por uma interface gráfica completa. O jogador digita /shop, abre-se um menu de categorias (blocos, comida, armas, ferramentas e assim por diante), e ele escolhe uma categoria e depois um item específico para comprar ou vender.

É um plugin pago no SpigotMC, feito para lojas de admin: o admin define o estoque e os preços, e os jogadores só compram e vendem. O ShopGUI+ não suporta lojas de jogadores (para isso você ainda precisa do QuickShop Hikari ou do ChestShop).

O plugin está disponível no SpigotMC. Ele exige o Vault e qualquer plugin de economia (EssentialsX, CMI, CoinsEngine). Opcionalmente, suporta o PlaceholderAPI.

Interface e categorias

O menu do ShopGUI+ tem dois níveis:

Menu principal - uma lista de categorias (por exemplo Blocos, Armas, Ferramentas, Comida, Decorações). Cada categoria tem o próprio ícone no menu.
Menu da categoria - uma lista de itens com preços de compra e de venda. O jogador clica com o botão esquerdo para comprar e com o direito para vender.

Ao clicar em um item, abre-se uma janela para escolher a quantidade: 1, 8, 16, 32, 64 ou uma quantidade personalizada. O jogador vê o custo total antes de confirmar a transação. Toda a interação acontece na GUI: sem digitar comandos e sem placas no mundo do jogo.

O admin define as categorias e os produtos em arquivos YAML na pasta plugins/ShopGUIPlus/shops/. Cada categoria é um arquivo separado, o que facilita a organização em servidores com uma grande variedade de itens.

Configuração da loja

Um exemplo de configuração de categoria em plugins/ShopGUIPlus/shops/blocks.yml:

shop:
  name: "Blocos"
  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 item tem um preço de compra (buyPrice), um preço de venda (sellPrice) e uma posição no menu (slot). Você pode definir só um dos preços: se omitir o sellPrice, os jogadores não poderão vender aquele item.

O ShopGUI+ também suporta comandos de venda: o admin pode adicionar um produto que executa um comando no servidor quando é comprado (por exemplo, conceder um cargo, um kit ou um efeito). Isso é útil para vender serviços e vantagens sem itens físicos.

Preços dinâmicos

O ShopGUI+ tem um sistema embutido de preços dinâmicos baseado em oferta e demanda. Quando os jogadores compram um item em grande quantidade, o preço sobe. Quando vendem em grande quantidade, o preço cai. É um mecanismo natural de equilíbrio do mercado.

Configuração dos preços dinâmicos no config.yml:

dynamicPricing:
  enabled: true
  maxBuyMultiplier: 2.0      # preço de compra no máx. 2x o base
  minBuyMultiplier: 0.5      # preço de compra no mín. 0,5x o base
  maxSellMultiplier: 2.0     # preço de venda no máx. 2x o base
  minSellMultiplier: 0.5     # preço de venda no mín. 0,5x o base
  resetInterval: 24          # redefinir os preços a cada 24 horas

Os preços dinâmicos são opcionais. Muitos servidores preferem preços fixos para que os jogadores saibam quanto vão pagar. Só ative esse recurso em servidores com muitas transações, onde as oscilações de preço fazem sentido econômico.

Comandos e permissões

Comando	Descrição	Permissão
`/shop`	Abre o menu principal da loja	shopguiplus.shop
`/shop [categoria]`	Abre uma categoria específica	shopguiplus.shop
`/sell hand`	Vende o item que está na sua mão	shopguiplus.sell.hand
`/sell all`	Vende tudo o que está no seu inventário	shopguiplus.sell.all
`/sellgui`	Abre a GUI de venda (jogue os itens dentro)	shopguiplus.sellgui
`/shopreload`	Recarrega a configuração	shopguiplus.reload

Você controla as permissões do ShopGUI+ pelo LuckPerms. Dá para restringir o acesso a categorias específicas por cargo com as permissões shopguiplus.shop.[categoria].

Dicas para admins

Sempre defina preços de venda menores que os de compra - deixe o sellPrice entre 40 e 60% do buyPrice. Isso evita exploits em que o jogador compra e vende na hora para lucrar.
Use /sell all em servidores de Skyblock/Prison - quem farma grandes quantidades de recursos vai gostar de poder vender o inventário inteiro com um comando.
Lojas separadas por mundo - o ShopGUI+ suporta uma seleção diferente por mundo. Útil em servidores com vários modos de jogo.
Integração com rankings - use o PlaceholderAPI para mostrar os maiores comerciantes em rankings.
Não exagere na variedade - 50 a 100 produtos bastam. Uma loja grande demais sobrecarrega os jogadores e destrói uma economia baseada no comércio entre eles.

Artigos relacionados: Vault, EssentialsX, QuickShop Hikari, catálogo de plugins.