SellGUI

# SellGUI v3 <img width="800" height="200" alt="2028end" src="https://github.com/user-attachments/assets/14beab6b-c27b-4777-96fc-c91bbe6e82ae" /> A quick announcement: This project was originally By Aoov, but after realizing its potential, I took over updating this plugin. You can support me through donations :3 as that's how your donations help me and this project. SellGUI is a Minecraft selling plugin with a configurable GUI, `/sellall`, autosell, price setting tools, price evaluation, and support for custom item plugins. Version 3 focuses on cleaner configuration, multiple sell menus, menu-specific item rules, and safer item stacking behavior. (https://nguyensonhoa.github.io/SellGUIWiki/#home) ## What's New In v3 - Added multiple sell menus through the `gui/sell_menus/` folder. - Each sell menu can live in its own YAML file, for example `default.yml` and `fishing.yml`. - Added `/sellgui <menu>` to open a specific menu. - Added `/sellgui <player> <menu>` so admins can open a specific menu for another player. - Added per-menu item filters: - `allowed-items` allows only specific items. - `denied-items` blocks specific items. - `exclusive: true` locks listed items to that menu only. - `/sellall` and autosell now skip items locked to exclusive menus. - Split the old root `gui.yml` into a cleaner `gui/` folder. - Added item stack normalization to fix items not stacking after smelting, joining, leaving, or server restart. - Bundled `libs/shopgui-api-3.1.0.jar` so Maven builds work from a fresh clone. - Addon Plugin Support ## Requirements ### Required | Component | Notes | | --- | --- | | Java | Java 21 recommended for modern Paper/Spigot 1.20.6+ servers | | Server | Paper/Spigot `1.20.6+`, optimized for `1.21+` | | Vault | Required for economy support | | Economy plugin | EssentialsX, CMI, or any Vault-compatible economy plugin | | NBTAPI | Required dependency in `plugin.yml` | ### Optional | Plugin | Purpose | | --- | --- | | EssentialsX | Use Essentials worth prices | | ShopGUIPlus | Use ShopGUI+ sell prices | | MMOItems | Detect and price MMOItems | | Nexo | Detect and price Nexo items | | MythicLib | Extra item/NBT metadata support | | PlaceholderAPI | Registers `%sellgui_*%` placeholders | | PacketEvents | Displays item worth lore through packets when enabled | ## Installation 1. Download the SellGUI v3 jar. 2. Place the jar in your server `plugins/` folder. 3. Make sure Vault, NBTAPI, and an economy plugin are installed. 4. Restart the server so SellGUI can generate its files. 5. Edit files inside `plugins/SellGUI/`. 6. Run `/sellgui reload` or restart the server after editing configuration files. ## Build From Source ```bash git clone https://github.com/NguyenSonhoa/SellGUI.git cd SellGUI git checkout v3.0 mvn -q -DskipTests package ``` Jar output: ```text target/SellGUI-3.0.1.jar ``` `libs/shopgui-api-3.1.0.jar` is committed so Maven can build immediately after cloning. ## Commands Aliases for `/sellgui`: `/sg`, `/sell` | Command | Description | Permission | | --- | --- | --- | | `/sellgui` | Open the default sell menu | `sellgui.use` | | `/sellgui <menu>` | Open a specific sell menu, for example `/sellgui fishing` | `sellgui.use` and the menu permission | | `/sellgui <player>` | Open the default menu for another player | `sellgui.others` | | `/sellgui <player> <menu>` | Open a specific menu for another player | `sellgui.others` | | `/sellgui help` | Show in-game help | `sellgui.use` | | `/sellgui reload` | Reload configs and GUIs | `sellgui.reload` | | `/sellgui evaluate` | Open the Price Evaluation GUI | `sellgui.evaluate` | | `/sellgui autosell` | Open the Autosell Settings GUI | `sellgui.autosell` | | `/autosell` | Open the Autosell Settings GUI | `sellgui.autosell` | | `/sellgui setprice <amount>` | Set a fixed price for the item in hand | `sellgui.setprice` | | `/sellgui setrange <min> <max>` | Set a random price range for the item in hand | `sellgui.setrange` | | `/sellguiprice` | Open the Price Setter GUI | `sellgui.setprice` | | `/sellguiprice <price>` | Enter a price for the item in the open Price Setter GUI | `sellgui.setprice` | | `/sellall` | Preview selling all valid inventory items | `sellgui.sellall` | | `/sellall confirm` | Confirm `/sellall` | `sellgui.sellall` | ## Permissions | Permission | Default | Description | | --- | --- | --- | | `sellgui.*` | plugin manager/op | Access to all declared SellGUI permissions | | `sellgui.use` | true | Use the basic SellGUI command | | `sellgui.admin` | op | General admin permission | | `sellgui.others` | manual grant | Open SellGUI for other players | | `sellgui.reload` | op | Reload the plugin | | `sellgui.setprice` | op | Use the Price Setter and fixed price commands | | `sellgui.setrange` | op | Set random price ranges | | `sellgui.evaluate` | op | Use the Price Evaluation GUI | | `sellgui.sellall` | true | Use `/sellall` | | `sellgui.autosell` | true | Open the autosell GUI | | `sellgui.menu.*` | true |