Servidores de Minecraft con el plugin EconomyShopGUI

## 🔌 Acerca de EconomyShopGUI EconomyShopGUI es un plugin de Minecraft que proporciona un sistema de tienda gráfica configurable para que los jugadores puedan comprar y vender objetos a través de menús en lugar de comandos de chat. El plugin ofrece secciones de la tienda, páginas de tienda paginadas, una interfaz de venta y objetos físicos opcionales "ShopStand". Está diseñado para entornos de servidor Bukkit/Spigot/Paper e integra con plugins de economía comunes. ## 🎯 Propósito El plugin reemplaza o complementa los comandos de tienda basados en texto con tiendas guiadas por GUI y configuración administrativa de la tienda. Está pensado para propietarios y administradores de servidores que quieren tiendas dentro del juego estructuradas y configurables que se conecten con un plugin de economía existente. ## ⚙️ Características - Secciones de tienda configurables y páginas GUI paginadas. - Flujos de compra y venta de objetos con una pantalla de transacción y límites configurables. - Funcionalidad de vender todo global y por sección. - Compatibilidad con objetos físicos ShopStand (tiendas de exhibición colocables). - Marketplace de layouts / layouts instalables e instalación de layouts dentro del juego. - API para desarrolladores para engancharse al plugin desde otros plugins. - Integración con múltiples sistemas de economía e integraciones opcionales para plugins de spawner y utilidades. - Usa bStats para métricas anónimas del plugin. ## 🧩 Para quién es - Servidores Survival y SMP que quieren tiendas GUI dentro del juego. - Servidores que ya usan un plugin de economía separado y necesitan una interfaz de tienda frontal. - Servidores que quieren layouts de tienda configurables y soportes físicos de tienda opcionales. - Desarrolladores de plugins que necesitan una API de tienda para integrar el comportamiento de la tienda. ## 🏗️ Casos de uso de ejemplo - Los operadores crean secciones de tienda para recursos, herramientas y cosméticos y dejan que los jugadores compren mediante una GUI. - Un servidor ofrece el comando /sellall para que los jugadores vendan objetos a las secciones de tienda configuradas. - Los administradores instalan o suben un layout para cambiar el aspecto de la tienda sin editar archivos en bruto. ## ⌨️ Comandos | **Comando** | **Descripción** | **Permiso** | **Acceso** | |---|---|---|---| | `/eshop additem <section> <material> <buy price> <sell price>` | Añadir un objeto a una sección de la tienda. | `EconomyShopGUI.eshop.additem` | Admin | | `/eshop edititem <section> <index> <action> <key> <value>` | Editar las propiedades de un objeto en una sección. | `EconomyShopGUI.eshop.edititem` | Admin | | `/eshop deleteitem <section> <index>` | Eliminar un objeto de una sección de la tienda. | `EconomyShopGUI.eshop.deleteitem` | Admin | | `/eshop addhanditem <section> <buy price> <sell price>` | Añadir el objeto que tienes en la mano a una sección de la tienda. | `EconomyShopGUI.eshop.addhanditem` | Admin | | `/eshop installLayout <id>` | Instalar un layout de tienda por id (integración con marketplace de layouts). | `EconomyShopGUI.eshop.installLayout` | Admin | | `/eshop logs export` | Exportar los registros de transacciones como una vista web (función de registro de transacciones). | `no especificado` | Admin | | `/sellall` | Vender todos los objetos vendibles según las secciones de tienda configuradas. | `EconomyShopGUI.sellall` | Jugador | | `/sellgui` | Abrir la Sell GUI para vender objetos mediante un menú. | `EconomyShopGUI.sellgui` | Jugador | (Los comandos anteriores solo se incluyen cuando el autor del plugin los documenta.) ## 🔐 Permisos | **Permiso** | **Descripción** | **Valor predeterminado** | |---|---|---| | `EconomyShopGUI.shop` | Permite a los jugadores abrir la tienda. | no especificado | | `EconomyShopGUI.shop.<section>` | Acceso para abrir una sección específica de la tienda por nombre. | no especificado | | `EconomyShopGUI.shop.all` | Permite abrir todas las secciones de la tienda. | no especificado | | `EconomyShopGUI.sellall` | Permite usar el comando `/sellall`. | no especificado | | `EconomyShopGUI.sellall.<section>` | Permite vender a una sección específica de la tienda con `/sellall`. | no especificado | | `EconomyShopGUI.sellall.all` | Permite vender a todas las secciones con `/sellall`. | no especificado | | `EconomyShopGUI.sellallitem` | Permite usar `/sellall <item>`. | no especificado | | `EconomyShopGUI.sellgui` | Permite abrir la Sell GUI. | no especificado | | `EconomyShopGUI.reload` | Permite recargar el plugin. | no especificado | | `EconomyShopGUI.eshop.additem` | Permite añadir objetos de la tienda mediante comando. | no especificado | | `EconomyShopGUI.eshop.edititem` | Permite editar objetos de la tienda mediante comando. | no especificado | | `EconomyShopGUI.eshop.deleteitem` | Permite eliminar objetos de la tienda mediante comando. | no especificado | | `EconomyShopGUI.eshop.addhanditem` | Permite añadir a la tienda el objeto que tienes en la mano mediante comando. | no especificado | | `EconomyShopGUI.eshop.addsection` | Permite añadir secciones de la tienda mediante comando. | no especificado | | `EconomyShopGUI.eshop.uploadLayout` | Permite subir un layout. | no especificado | | `EconomyShopGUI.eshop.installLayout` | Permite instalar un layout. | no especificado | | `EconomyShopGUI.eshop.shopstands.create` | Permite crear/colocar objetos ShopStand. | no especificado | | `EconomyShopGUI.eshop.shopstands.destroy` | Permite destruir ShopStands. | no especificado | (Los valores predeterminados se registran como "no especificado" cuando el plugin no indica un valor predeterminado en la lista de permisos documentada.) ## ⚙️ Instalación ### 📥 Configuración - Descarga el JAR oficial del plugin y colócalo en la carpeta `plugins/` de tu servidor. - Reinicia el servidor (o usa un gestor de plugins para cargar el plugin). - Revisa la consola del servidor al arrancar para confirmar que el plugin se cargó y si hay avisos de dependencias. ### 📦 Dependencias - Requiere un proveedor de economía. El plugin documenta compatibilidad con uno de estos: **Vault**, **PlayerPoints**, **CoinsEngine**, **GemsEconomy**, **UltraEconomy**, **VotingPlugin**, **zEssentials** (uno de estos debe estar presente para las operaciones de economía). - Las integraciones opcionales incluyen PlaceholderAPI, Citizens, Quests y varios plugins de spawner para compatibilidad directa. ## 🧠 Notas técnicas - El plugin se publica para servidores Bukkit/Spigot/Paper y el autor indica que no da soporte a servidores modificados/híbridos. - Requisitos indicados por el autor: Minecraft 1.8+ y Java 8 o superior. - El plugin expone una API para desarrolladores para que otros plugins puedan conectarse a eventos y funciones de la tienda. - El plugin usa bStats para la recopilación anónima de métricas. - Existe una variante premium que añade funciones como editor GUI, objetos de comando y objetos NBT personalizados; la funcionalidad principal (tiendas GUI) existe en la versión gratuita. ## 🤝 Cuándo es útil este plugin Si necesitas una tienda gráfica dentro del juego que se integre con tu plugin de economía existente y admita layouts configurables, secciones de tienda y flujos de venta, EconomyShopGUI ofrece una interfaz documentada para administradores y una API para integración con plugins.

Plugins