Servidores Minecraft com plugin EconomyShopGUI

## 🔌 Sobre o EconomyShopGUI EconomyShopGUI é um plugin de Minecraft que fornece um sistema de loja gráfica configurável para que os jogadores possam comprar e vender itens através de menus em vez de comandos no chat. O plugin disponibiliza secções da loja, páginas paginadas da loja, uma interface de venda e itens físicos opcionais "ShopStand". Foi concebido para ambientes de servidor Bukkit/Spigot/Paper e integra-se com plugins de economia comuns. ## 🎯 Objetivo O plugin substitui ou complementa comandos de loja baseados em texto com lojas guiadas por GUI e configuração administrativa da loja. Destina-se a proprietários e administradores de servidores que querem lojas no jogo estruturadas e configuráveis, ligadas a um plugin de economia já existente. ## ⚙️ Funcionalidades - Secções da loja configuráveis e páginas GUI paginadas. - Fluxos de compra e venda de itens com ecrã de transação e limites configuráveis. - Funcionalidade global e por secção de vender tudo. - Suporte para item físico ShopStand (lojas de exibição colocáveis). - Marketplace de layouts / layouts instaláveis e instalação de layouts no jogo. - API de desenvolvimento para integração com o plugin a partir de outros plugins. - Integração com vários sistemas de economia e integrações opcionais para plugins de spawner e utilidades. - Usa o bStats para métricas anónimas do plugin. ## 🧩 Para quem é - Servidores Survival e SMP que querem lojas GUI no jogo. - Servidores que já usam um plugin de economia separado e precisam de uma interface de loja frontal. - Servidores que querem layouts de loja configuráveis e suportes físicos de loja opcionais. - Programadores de plugins que precisam de uma API de loja para integrar o comportamento da loja. ## 🏗️ Casos de uso de exemplo - Os operadores criam secções da loja para recursos, ferramentas e cosméticos e permitem que os jogadores comprem através de uma GUI. - Um servidor oferece o comando /sellall para os jogadores venderem itens às secções da loja configuradas. - Os administradores instalam ou carregam um layout para alterar o aspeto da loja sem editar ficheiros brutos. ## ⌨️ Comandos | **Comando** | **Descrição** | **Permissão** | **Acesso** | |---|---|---|---| | `/eshop additem <section> <material> <buy price> <sell price>` | Adiciona um item a uma secção da loja. | `EconomyShopGUI.eshop.additem` | Admin | | `/eshop edititem <section> <index> <action> <key> <value>` | Edita as propriedades de um item numa secção. | `EconomyShopGUI.eshop.edititem` | Admin | | `/eshop deleteitem <section> <index>` | Remove um item de uma secção da loja. | `EconomyShopGUI.eshop.deleteitem` | Admin | | `/eshop addhanditem <section> <buy price> <sell price>` | Adiciona o item que tens na mão a uma secção da loja. | `EconomyShopGUI.eshop.addhanditem` | Admin | | `/eshop installLayout <id>` | Instala um layout de loja por id (integração com marketplace de layouts). | `EconomyShopGUI.eshop.installLayout` | Admin | | `/eshop logs export` | Exporta os registos de transações como uma vista web (funcionalidade de registo de transações). | `não especificado` | Admin | | `/sellall` | Vende todos os itens vendáveis de acordo com as secções da loja configuradas. | `EconomyShopGUI.sellall` | Jogador | | `/sellgui` | Abre a Sell GUI para vender itens através de um menu. | `EconomyShopGUI.sellgui` | Jogador | (Os comandos acima estão incluídos apenas quando documentados pelo autor do plugin.) ## 🔐 Permissões | **Permissão** | **Descrição** | **Padrão** | |---|---|---| | `EconomyShopGUI.shop` | Permite aos jogadores abrir a loja. | não especificado | | `EconomyShopGUI.shop.<section>` | Acesso para abrir uma secção específica da loja pelo nome. | não especificado | | `EconomyShopGUI.shop.all` | Permite abrir todas as secções da loja. | não especificado | | `EconomyShopGUI.sellall` | Permite usar o comando `/sellall`. | não especificado | | `EconomyShopGUI.sellall.<section>` | Permite vender para uma secção específica da loja com `/sellall`. | não especificado | | `EconomyShopGUI.sellall.all` | Permite vender para todas as secções com `/sellall`. | não especificado | | `EconomyShopGUI.sellallitem` | Permite o uso de `/sellall <item>`. | não especificado | | `EconomyShopGUI.sellgui` | Permite abrir a Sell GUI. | não especificado | | `EconomyShopGUI.reload` | Permite recarregar o plugin. | não especificado | | `EconomyShopGUI.eshop.additem` | Permite adicionar itens à loja através de comando. | não especificado | | `EconomyShopGUI.eshop.edititem` | Permite editar itens da loja através de comando. | não especificado | | `EconomyShopGUI.eshop.deleteitem` | Permite eliminar itens da loja através de comando. | não especificado | | `EconomyShopGUI.eshop.addhanditem` | Permite adicionar à loja o item que tens na mão através de comando. | não especificado | | `EconomyShopGUI.eshop.addsection` | Permite adicionar secções da loja através de comando. | não especificado | | `EconomyShopGUI.eshop.uploadLayout` | Permite carregar um layout. | não especificado | | `EconomyShopGUI.eshop.installLayout` | Permite instalar um layout. | não especificado | | `EconomyShopGUI.eshop.shopstands.create` | Permite criar/colocar itens ShopStand. | não especificado | | `EconomyShopGUI.eshop.shopstands.destroy` | Permite destruir ShopStands. | não especificado | (Os padrões são registados como "não especificado" quando o plugin não indica um valor padrão na lista de permissões documentada.) ## ⚙️ Instalação ### 📥 Configuração - Descarrega o JAR oficial do plugin e coloca-o na pasta `plugins/` do teu servidor. - Reinicia o servidor (ou usa um gestor de plugins para carregar o plugin). - Verifica a consola do servidor ao iniciar para confirmar que o plugin foi carregado e se existem avisos de dependências. ### 📦 Dependências - Requer um fornecedor de economia. O plugin documenta suporte para um de: **Vault**, **PlayerPoints**, **CoinsEngine**, **GemsEconomy**, **UltraEconomy**, **VotingPlugin**, **zEssentials** (um destes tem de estar presente para as operações de economia). - As integrações opcionais incluem PlaceholderAPI, Citizens, Quests e vários plugins de spawner para suporte direto. ## 🧠 Notas técnicas - O plugin é publicado para servidores Bukkit/Spigot/Paper e o autor observa que não oferece suporte para servidores modificados/híbridos. - Requisitos indicados pelo autor: Minecraft 1.8+ e Java 8 ou superior. - O plugin expõe uma API de desenvolvimento para que outros plugins possam ligar-se a eventos e funcionalidades da loja. - O plugin usa o bStats para recolha anónima de métricas. - Existe uma variante premium que adiciona funcionalidades como editor GUI, itens de comando e itens NBT personalizados; a funcionalidade principal (lojas GUI) existe na versão gratuita. ## 🤝 Quando este plugin é útil Se precisares de uma montra gráfica no jogo que se integre com o teu plugin de economia existente e suporte layouts configuráveis, secções da loja e fluxos de venda, o EconomyShopGUI oferece uma interface documentada para administradores e uma API para integração com plugins.

Plugins