SellGUI

Minecraft 版本： 1.20.6 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11 26.1 26.1.1 26.1.2

平台： bukkit paper purpur spigot

标签： economy game-mechanics utility

SellGUI v3

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.

WIKI

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

Optional

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

git clone https://github.com/NguyenSonhoa/SellGUI.git
cd SellGUI
git checkout v3.0
mvn -q -DskipTests package

Jar output:

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

Permissions

Examples:

sellgui.multiplier.2.0
sellgui.bonus.30
sellgui.menu.fishing

When adding a new menu, give it its own permission in the menu file, for example sellgui.menu.mining, then grant that permission to the ranks that should use it.

v3 Configuration Layout

After the first server start, SellGUI creates files under plugins/SellGUI/.

plugins/SellGUI/
  config.yml
  itemprices.yml
  mmoitems.yml
  nexo.yml
  customitems.yml
  custommenuitems.yml
  random-prices.yml
  messages.yml
  sounds.yml
  autosell_data.yml
  gui/
    sell_menus/
      default.yml
      fishing.yml
    price_setter.yml
    price_evaluation.yml
    autosell_settings.yml

The old root gui.yml has been removed in v3. GUI layouts and sell menus now live in the gui/ folder.

SellGUI loads and merges all .yml and .yaml files inside gui/, including files in subfolders. The recommended layout is one sell menu per file under gui/sell_menus/.

Multi-Menu System

Default menu:

plugins/SellGUI/gui/sell_menus/default.yml

Example fishing menu:

plugins/SellGUI/gui/sell_menus/fishing.yml

Example mining menu:

sell_menus:
  mining:
    name: "Mining"
    permission: "sellgui.menu.mining"
    title: "&8/sellgui > Mining"
    size: 36
    item-filter:
      allowed-items:
        - "IRON_INGOT"
        - "GOLD_INGOT"
        - "DIAMOND"
        - "EMERALD"
      denied-items: []
      exclusive: true
    positions:
      sell_button: [31]
      confirm_button: [31]
      filler_slots: [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 17, 18, 26, 27, 28, 29, 30, 32, 33, 34, 35]
      item_slots: [10, 11, 12, 13, 14, 15, 16, 19, 20, 21, 22, 23, 24, 25]
    items:
      sell_button:
        material: "EMERALD"
        custom-model-data: 0
        name: "&a&lCalculate Mining Sale"
        lore:
          - "&7Only mining items can be sold here."
          - "&eTotal Value: &a$0.00"
        glow: true
      confirm_button:
        material: "GREEN_CONCRETE"
        custom-model-data: 0
        name: "&a&lConfirm Mining Sale"
        lore:
          - "&fTotal: &e$%total%"
        glow: true
      filler:
        material: "GRAY_STAINED_GLASS_PANE"
        custom-model-data: 0
        name: " "
        lore: []
      no_items:
        material: "BARRIER"
        custom-model-data: 0
        name: "&c&lNo Items To Sell"
        lore:
          - "&7Add mining items to this menu."
    item_total_format: "&7%amount%x &f%item% &8= &e$%total%"
    evaluation_required_format: "&7%amount%x &f%item% &cNeeds Evaluation"

Open it with:

/sellgui mining

Item Filters And Exclusive Items

Each menu can define:

item-filter:
  allowed-items: []
  denied-items: []
  exclusive: false

With exclusive: true, those items are:

• Blocked from other sell menus.
• Skipped by /sellall.
• Skipped by autosell.

Item Identifier Format

Vanilla items can be written by material name:

allowed-items:
  - "COD"
  - "SALMON"

Full identifiers are also supported:

allowed-items:
  - "VANILLA:COD"
  - "MMOITEMS:SWORD.EXCALIBUR"
  - "NEXO:CUSTOM_FISH"

Price System

SellGUI can read prices from multiple sources:

• itemprices.yml for vanilla items.
• mmoitems.yml for MMOItems.
• nexo.yml for Nexo items.
• Essentials worth when use-essentials-price: true.
• ShopGUI+ when use-shopguiplus-price: true.
• NBT/PDC prices when prices.nbt-pricing: true.
• Random/evaluation prices from random-prices.yml.

Main price config:

prices:
  nbt-pricing: true
  calculation-method: "auto"
  default-price: 0.0
  multipliers:
    enabled: true
    permission-based: true
    default-multiplier: 1.0
    max-multiplier: 5.0
  random-pricing:
    enabled: false
    variation-percent: 10.0

prices.calculation-method values:

Price Setter

Open the GUI:

/sellguiprice

Workflow:

1. Place an item in the center slot.
2. Use the GUI or chat input to enter a price.
3. Click save to write the price.

Quick command:

/sellgui setprice 10

In most price-setting flows, price 0 can be used to remove the saved price.

Price Evaluation

Open the GUI:

/sellgui evaluate

Use this when items must be evaluated before they can be sold. Related files:

plugins/SellGUI/gui/price_evaluation.yml
plugins/SellGUI/random-prices.yml

If general.allow-player-evaluation-stack: false, players cannot evaluate a whole stack at once.

Autosell

Open the GUI:

/autosell
/sellgui autosell

Autosell lets players toggle automatic selling for priced items. Player data is stored in:

plugins/SellGUI/autosell_data.yml

In v3, autosell skips items locked to exclusive sell menus so category-specific items are not sold accidentally.

SellAll

Commands:

/sellall
/sellall confirm

/sellall calculates a preview. The player then confirms with /sellall confirm.

In v3, /sellall skips:

• Items with no price.
• Enchanted items when sell-all-command-sell-enchanted: false.
• Items that require evaluation but have not been evaluated.
• Items locked to an exclusive sell menu.

Item Stack Normalization

V3 adds stack normalization to fix vanilla items that stop stacking because of temporary SellGUI metadata or lore.

Config:

stacking:
  enabled: true
  normalize-on-join: true
  normalize-on-quit: true
  normalize-on-plugin-disable: true
  normalize-smelt-results: true
  normalize-after-furnace-extract: true

This removes temporary SellGUI metadata such as current_price, evaluated, and Evaluated: ... lore when appropriate, then merges similar stacks in the player's inventory.

It does not intentionally remove custom NBT or metadata from other plugins, so custom items with real metadata stay intact.

PlaceholderAPI

When PlaceholderAPI is installed, SellGUI registers the sellgui identifier and processes PlaceholderAPI placeholders in supported GUI text.

SellGUI PlaceholderAPI Placeholders

Built-In Placeholders

These placeholders can be used in SellGUI text/config values. If PlaceholderAPI is installed, SellGUI lets PlaceholderAPI process placeholders first. If PlaceholderAPI is missing or fails, SellGUI falls back to these built-in placeholders.

Worth Lore Through PacketEvents

Enable in config.yml:

general:
  add-worth-lore: true

PacketEvents is required. SellGUI displays worth lore through packets so the real inventory item is not constantly rewritten with lore.

GUI titles where worth lore should not be shown:

general:
  worth-lore-blacklist-gui-titles:
    - "ah"
    - "Auction House"
    - "My Chest"

Migration From Older Versions

If you are upgrading from a pre-v3 build:

1. Back up plugins/SellGUI/.
2. Stop the server.
3. Install the v3 jar.
4. Start the server to generate the new gui/ folder.
5. Move old GUI layout/menu settings from gui.yml into files under gui/.
6. Put each sell menu in its own file under gui/sell_menus/<menu>.yml.
7. Run /sellgui reload.

Important changes:

Troubleshooting

/sellgui fishing says the player has no permission

Make sure the player has the menu permission:

sellgui.menu.fishing

An item cannot be sold in the default menu

Check whether the item belongs to another exclusive menu. For example, fish in fishing.yml has exclusive: true, so fish can only be sold through /sellgui fishing.

/sellall does not sell some items

Check:

• The item has a price in itemprices.yml, mmoitems.yml, nexo.yml, Essentials, or ShopGUI+.
• The item is enchanted while sell-all-command-sell-enchanted: false.
• The item requires evaluation.
• The item is locked to an exclusive menu.

Maven build fails because of ShopGUI API

Make sure this file exists:

libs/shopgui-api-3.1.0.jar

Then build again:

mvn -q -DskipTests package

Important Files

Changelog

See CHANGELOG.md.

Support

When reporting issues, include:

• Server version.
• SellGUI version.
• Related economy/item plugins.
• Related config or menu files.
• Console error logs.
• Steps to reproduce the issue.