SellGUI v3
快速公告:该项目最初由 Aoov 开发,但在意识到其潜力后,我接手了该插件的更新工作。你可以通过捐赠来支持我 :3,因为正是你的捐赠帮助了我以及这个项目。
SellGUI 是一款 Minecraft 售卖插件,拥有可配置的 GUI、/sellall(出售所有物品)、自动售卖、价格设置工具、价格评估功能,并支持自定义物品插件。v3 版本专注于更简洁的配置、多个售卖菜单、针对特定菜单的物品规则,以及更安全的物品堆叠行为。
维基
v3 新增内容
- 通过
gui/sell_menus/ 文件夹添加了多个售卖菜单。
- 每个售卖菜单可以独立存放在各自的 YAML 文件中,例如
default.yml 和 fishing.yml。
- 添加了
/sellgui <menu> 命令以打开特定菜单。
- 添加了
/sellgui <player> <menu> 命令,允许管理员为其他玩家打开特定菜单。
- 添加了按菜单划分的物品过滤器:
allowed-items 仅允许特定物品。
denied-items 禁止特定物品。
exclusive: true 将列出的物品锁定至仅限该菜单使用。
/sellall 和自动售卖现在会跳过被锁定在独占菜单中的物品。
- 将旧的根目录
gui.yml 拆分为更整洁的 gui/ 文件夹。
- 添加了物品堆栈标准化功能,修复了在熔炼、加入服务器、离开服务器或服务器重启后物品无法堆叠的问题。
- 捆绑了
libs/shopgui-api-3.1.0.jar,以便从全新克隆中即可进行 Maven 构建。
- 支持附加插件 (Addon Plugin Support)
要求
必需
| 组件 |
备注 |
| Java |
推荐 Java 21,适用于现代 Paper/Spigot 1.20.6+ 服务器 |
| 服务器 |
Paper/Spigot 1.20.6+,针对 1.21+ 进行了优化 |
| Vault |
经济支持所需 |
| 经济插件 |
EssentialsX、CMI 或任何兼容 Vault 的经济插件 |
| NBTAPI |
在 plugin.yml 中作为必需的依赖项 |
可选
| 插件 |
用途 |
| EssentialsX |
使用 Essentials 的价值价格 |
| ShopGUIPlus |
使用 ShopGUI+ 的售卖价格 |
| MMOItems |
检测并为 MMOItems 定价 |
| Nexo |
检测并为 Nexo 物品定价 |
| MythicLib |
额外的物品/NBT 元数据支持 |
| PlaceholderAPI |
注册 %sellgui_*% 占位符 |
| PacketEvents |
启用时通过数据包显示物品价值 lore |
安装
- 下载 SellGUI v3 jar 文件。
- 将 jar 文件放入服务器的
plugins/ 文件夹中。
- 确保已安装 Vault、NBTAPI 和经济插件。
- 重启服务器,以便 SellGUI 生成其配置文件。
- 编辑
plugins/SellGUI/ 内的文件。
- 编辑配置文件后,运行
/sellgui reload 或重启服务器。
从源代码构建
git clone https://github.com/NguyenSonhoa/SellGUI.git
cd SellGUI
git checkout v3.0
mvn -q -DskipTests package
Jar 输出位置:
target/SellGUI-3.0.1.jar
libs/shopgui-api-3.1.0.jar 已提交到仓库,因此克隆后即可立即进行 Maven 构建。
命令
/sellgui 的别名:/sg, /sell
| 命令 |
描述 |
权限 |
/sellgui |
打开默认售卖菜单 |
sellgui.use |
/sellgui <menu> |
打开特定售卖菜单,例如 /sellgui fishing |
sellgui.use 及对应菜单权限 |
/sellgui <player> |
为其他玩家打开默认菜单 |
sellgui.others |
/sellgui <player> <menu> |
为其他玩家打开特定菜单 |
sellgui.others |
/sellgui help |
显示游戏内帮助信息 |
sellgui.use |
/sellgui reload |
重载配置和 GUI |
sellgui.reload |
/sellgui evaluate |
打开价格评估 GUI |
sellgui.evaluate |
/sellgui autosell |
打开自动售卖设置 GUI |
sellgui.autosell |
/autosell |
打开自动售卖设置 GUI |
sellgui.autosell |
/sellgui setprice <amount> |
设置手中物品的固定价格 |
sellgui.setprice |
/sellgui setrange <min> <max> |
设置手中物品的随机价格范围 |
sellgui.setrange |
/sellguiprice |
打开价格设置器 GUI |
sellgui.setprice |
/sellguiprice <price> |
在当前打开的价格设置器 GUI 中输入物品价格 |
sellgui.setprice |
/sellall |
预览出售所有有效库存物品 |
sellgui.sellall |
/sellall confirm |
确认 /sellall |
sellgui.sellall |
权限
| 权限 |
默认值 |
描述 |
sellgui.* |
插件管理器/op |
访问所有声明的 SellGUI 权限 |
sellgui.use |
true |
使用基本 SellGUI 命令 |
sellgui.admin |
op |
通用管理权限 |
sellgui.others |
手动授予 |
为其他玩家打开 SellGUI |
sellgui.reload |
op |
重载插件 |
sellgui.setprice |
op |
使用价格设置器和固定价格命令 |
sellgui.setrange |
op |
设置随机价格范围 |
sellgui.evaluate |
op |
使用价格评估 GUI |
sellgui.sellall |
true |
使用 /sellall |
sellgui.autosell |
true |
打开自动售卖 GUI |
sellgui.menu.* |
true |
访问 plugin.yml 中声明的所有已配置菜单 |
sellgui.menu.default |
true |
打开默认菜单 |
sellgui.menu.fishing |
true |
打开示例钓鱼菜单 |
sellgui.bonus.<number> |
false |
增加售卖加成,具体取决于定价路径 |
sellgui.multiplier.<number> |
false |
乘数售卖价格 |
示例:
sellgui.multiplier.2.0
sellgui.bonus.30
sellgui.menu.fishing
添加新菜单时,请在菜单文件中为其分配独立的权限,例如 sellgui.menu.mining,然后将该权限授予应使用该菜单的权限组。
v3 配置结构
首次启动服务器后,SellGUI 会在 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
v3 版本中已移除旧的根目录 gui.yml。GUI 布局和出售菜单现在位于 gui/ 文件夹中。
SellGUI 会加载并合并 gui/ 内的所有 .yml 和 .yaml 文件,包括子文件夹中的文件。推荐的布局是在 gui/sell_menus/ 下每个文件对应一个出售菜单。
多菜单系统
默认菜单:
plugins/SellGUI/gui/sell_menus/default.yml
钓鱼菜单示例:
plugins/SellGUI/gui/sell_menus/fishing.yml
采矿菜单示例:
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"
使用以下命令打开:
/sellgui mining
物品过滤器与独占物品
每个菜单可以定义:
item-filter:
allowed-items: []
denied-items: []
exclusive: false
| 键 |
描述 |
allowed-items |
如果为空,该菜单接受除被拒绝物品和锁定到另一个独占菜单的物品之外的任何有效物品。如果已填充,则仅接受列出的物品。 |
denied-items |
阻止特定物品在该菜单中出售。 |
exclusive |
当为 true 时,列出的允许物品只能在此菜单中出售。 |
启用 exclusive: true 后,这些物品将:
- 被其他出售菜单阻止。
- 被
/sellall 跳过。
- 被自动出售跳过。
物品标识符格式
原版物品可以通过材质名称编写:
allowed-items:
- "COD"
- "SALMON"
也支持完整标识符:
allowed-items:
- "VANILLA:COD"
- "MMOITEMS:SWORD.EXCALIBUR"
- "NEXO:CUSTOM_FISH"
| 物品类型 |
格式 |
| Vanilla |
VANILLA:MATERIAL 或仅为 MATERIAL |
| MMOItems |
MMOITEMS:TYPE.ID |
| Nexo |
NEXO:ITEM_ID |
价格系统
SellGUI 可以从多个来源读取价格:
itemprices.yml 用于原版物品。
mmoitems.yml 用于 MMOItems。
nexo.yml 用于 Nexo 物品。
- 当
use-essentials-price: true 时使用 Essentials worth。
- 当
use-shopguiplus-price: true 时使用 ShopGUI+。
- 当
prices.nbt-pricing: true 时使用 NBT/PDC 价格。
- 来自
random-prices.yml 的随机/评估价格。
主要价格配置:
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 的值:
| 值 |
描述 |
auto |
自动选择最佳可用价格来源 |
config |
仅使用 SellGUI 配置文件中的价格 |
essentials |
仅使用 Essentials worth |
nbt |
仅使用 NBT 价格 |
shopguiplus |
仅使用 ShopGUI+ |
价格设置器
打开 GUI:
/sellguiprice
工作流程:
- 将物品放置在中心槽位。
- 使用 GUI 或聊天输入输入价格。
- 点击保存以写入价格。
快速命令:
/sellgui setprice 10
在大多数价格设置流程中,价格 0 可用于移除已保存的价格。
价格评估
打开 GUI:
/sellgui evaluate
当物品必须经过评估才能出售时使用此功能。相关文件:
plugins/SellGUI/gui/price_evaluation.yml
plugins/SellGUI/random-prices.yml
如果 general.allow-player-evaluation-stack: false,玩家不能一次性评估整组物品。
自动出售
打开 GUI:
/autosell
/sellgui autosell
自动出售允许玩家切换定价物品的自动出售功能。玩家数据存储在:
plugins/SellGUI/autosell_data.yml
在 v3 中,自动出售会跳过锁定到独占出售菜单的物品,以防止意外出售类别特定的物品。
全部出售
命令:
/sellall
/sellall confirm
/sellall 计算预览。然后玩家通过 /sellall confirm 确认。
在 v3 中,/sellall 会跳过:
- 没有价格的物品。
- 当
sell-all-command-sell-enchanted: false 时的附魔物品。
- 需要评估但尚未评估的物品。
- 锁定到独占出售菜单的物品。
物品堆叠标准化
V3 添加了堆叠标准化功能,以修复因临时 SellGUI 元数据或描述而停止堆叠的原版物品。
配置:
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
这会在适当时机移除 SellGUI 的临时元数据(如 current_price、evaluated 以及 Evaluated: ... 等描述),然后合并玩家背包中相似的物品堆叠。
它不会有意移除其他插件自定义的 NBT 或元数据,因此带有真实元数据的自定义物品将保持完整。
PlaceholderAPI
当安装了 PlaceholderAPI 时,SellGUI 会注册 sellgui 标识符,并在支持的 GUI 文本中处理 PlaceholderAPI 占位符。
SellGUI PlaceholderAPI 占位符
| 占位符 |
说明 |
%sellgui_pricehand% |
玩家主手物品的价格 |
%sellgui_pricehandfull% |
手中物品的名称和价格 |
内置占位符
这些占位符可用于 SellGUI 文本/配置值。如果已安装 PlaceholderAPI,SellGUI 会优先让 PlaceholderAPI 处理占位符。如果未安装 PlaceholderAPI 或处理失败,SellGUI 将回退使用这些内置占位符。
| 占位符 |
说明 |
%player% |
玩家名称 |
%player_name% |
玩家名称 |
%player_displayname% |
玩家显示名称 |
%player_uuid% |
玩家 UUID |
%player_world% |
玩家所在世界名称 |
%player_x% |
玩家方块 X 坐标 |
%player_y% |
玩家方块 Y 坐标 |
%player_z% |
玩家方块 Z 坐标 |
%player_health% |
当前玩家生命值 |
%player_max_health% |
玩家最大生命值 |
%player_food% |
玩家饥饿值等级 |
%player_level% |
玩家经验等级 |
%player_exp% |
玩家经验进度百分比 |
%vault_eco_balance% |
玩家 Vault 经济余额 |
%player_balance% |
玩家 Vault 经济余额 |
%server_name% |
服务器名称 |
%server_version% |
完整服务器版本 |
%server_bukkit_version% |
Bukkit 版本 |
%server_online% |
在线玩家数量 |
%server_max_players% |
最大玩家数量 |
%sellgui_version% |
SellGUI 插件版本 |
%sellgui_author% |
SellGUI 插件作者 |
%time% |
当前服务器本地时间 |
%date% |
当前服务器本地日期 |
%timestamp% |
当前服务器本地日期和时间 |
通过 PacketEvents 添加价值描述
在 config.yml 中启用:
general:
add-worth-lore: true
需要安装 PacketEvents。SellGUI 通过数据包显示价值描述,这样真实的背包物品就不会被频繁重写描述。
不应显示价值描述的 GUI 标题黑名单:
general:
worth-lore-blacklist-gui-titles:
- "ah"
- "Auction House"
- "My Chest"
从旧版本迁移
如果您是从 v3 之前的版本升级:
- 备份
plugins/SellGUI/ 目录。
- 停止服务器。
- 安装 v3 jar 文件。
- 启动服务器以生成新的
gui/ 文件夹。
- 将旧版
gui.yml 中的 GUI 布局/菜单设置移动到 gui/ 下的文件中。
- 将每个出售菜单放入
gui/sell_menus/<menu>.yml 对应的独立文件中。
- 运行
/sellgui reload。
重要变更:
| 旧版 |
新版 |
根目录 gui.yml |
gui/ 文件夹 |
| 单个出售 GUI |
gui/sell_menus/ 下的多个出售菜单 |
| 任意位置出售物品 |
物品可通过 exclusive: true 锁定到特定菜单 |
故障排除
/sellgui fishing 提示玩家没有权限
确保玩家拥有菜单权限:
sellgui.menu.fishing
默认菜单中无法出售某些物品
检查该物品是否属于另一个独占菜单。例如,fishing.yml 中的鱼设置了 exclusive: true,因此鱼只能通过 /sellgui fishing 出售。
/sellall 未能出售部分物品
请检查:
- 该物品在
itemprices.yml、mmoitems.yml、nexo.yml、Essentials 或 ShopGUI+ 中是否有定价。
- 该物品附魔了,但配置项
sell-all-command-sell-enchanted 为 false。
- 该物品需要评估。
- 该物品被锁定到独占菜单。
Maven 构建因 ShopGUI API 失败
确保存在以下文件:
libs/shopgui-api-3.1.0.jar
然后重新构建:
mvn -q -DskipTests package
重要文件
| 文件 |
说明 |
src/main/resources/config.yml |
默认核心配置 |
src/main/resources/gui/sell_menus/default.yml |
默认出售菜单 |
src/main/resources/gui/sell_menus/fishing.yml |
示例钓鱼出售菜单 |
src/main/resources/gui/price_setter.yml |
定价器 GUI 布局 |
src/main/resources/gui/price_evaluation.yml |
价格评估 GUI 布局 |
src/main/resources/gui/autosell_settings.yml |
自动出售设置 GUI 布局 |
src/main/resources/itemprices.yml |
原版物品价格 |
src/main/resources/mmoitems.yml |
MMOItems 物品价格 |
src/main/resources/nexo.yml |
Nexo 物品价格 |
src/main/resources/random-prices.yml |
随机/评估价格 |
CHANGELOG.md |
v3 更新日志 |
更新日志
请参阅 CHANGELOG.md。
支持
报告问题时,请包含以下信息:
- 服务器版本。
- SellGUI 版本。
- 相关的经济/物品插件。
- 相关的配置文件或菜单文件。
- 控制台错误日志。
- 复现问题的步骤。
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
| 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
- Download the SellGUI v3 jar.
- Place the jar in your server
plugins/ folder.
- Make sure Vault, NBTAPI, and an economy plugin are installed.
- Restart the server so SellGUI can generate its files.
- Edit files inside
plugins/SellGUI/.
- 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
| 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 |
Access all configured menus declared in plugin.yml |
sellgui.menu.default |
true |
Open the default menu |
sellgui.menu.fishing |
true |
Open the example fishing menu |
sellgui.bonus.<number> |
false |
Adds a sell bonus, depending on the pricing path |
sellgui.multiplier.<number> |
false |
Multiplies sell prices |
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
| Key |
Description |
allowed-items |
If empty, the menu accepts any valid item except denied items and items locked to another exclusive menu. If populated, the menu only accepts listed items. |
denied-items |
Blocks specific items in that menu. |
exclusive |
When true, listed allowed items can only be sold in this menu. |
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"
| Item type |
Format |
| Vanilla |
VANILLA:MATERIAL or just MATERIAL |
| MMOItems |
MMOITEMS:TYPE.ID |
| Nexo |
NEXO:ITEM_ID |
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:
| Value |
Description |
auto |
Automatically choose the best available price source |
config |
Use SellGUI config prices only |
essentials |
Use Essentials worth only |
nbt |
Use NBT price only |
shopguiplus |
Use ShopGUI+ only |
Price Setter
Open the GUI:
/sellguiprice
Workflow:
- Place an item in the center slot.
- Use the GUI or chat input to enter a price.
- 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
| Placeholder |
Description |
%sellgui_pricehand% |
Price of the item in the player's main hand |
%sellgui_pricehandfull% |
Item name and price of the item in hand |
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.
| Placeholder |
Description |
%player% |
Player name |
%player_name% |
Player name |
%player_displayname% |
Player display name |
%player_uuid% |
Player UUID |
%player_world% |
Player world name |
%player_x% |
Player block X position |
%player_y% |
Player block Y position |
%player_z% |
Player block Z position |
%player_health% |
Current player health |
%player_max_health% |
Max player health |
%player_food% |
Player food level |
%player_level% |
Player XP level |
%player_exp% |
Player XP progress percent |
%vault_eco_balance% |
Player Vault economy balance |
%player_balance% |
Player Vault economy balance |
%server_name% |
Server name |
%server_version% |
Full server version |
%server_bukkit_version% |
Bukkit version |
%server_online% |
Online player count |
%server_max_players% |
Max player count |
%sellgui_version% |
SellGUI plugin version |
%sellgui_author% |
SellGUI plugin authors |
%time% |
Current server local time |
%date% |
Current server local date |
%timestamp% |
Current server local date and time |
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:
- Back up
plugins/SellGUI/.
- Stop the server.
- Install the v3 jar.
- Start the server to generate the new
gui/ folder.
- Move old GUI layout/menu settings from
gui.yml into files under gui/.
- Put each sell menu in its own file under
gui/sell_menus/<menu>.yml.
- Run
/sellgui reload.
Important changes:
| Old |
New |
Root gui.yml |
gui/ folder |
| One sell GUI |
Multiple sell menus under gui/sell_menus/ |
| Items sold anywhere |
Items can be locked to one menu with exclusive: true |
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
| File |
Description |
src/main/resources/config.yml |
Default core config |
src/main/resources/gui/sell_menus/default.yml |
Default sell menu |
src/main/resources/gui/sell_menus/fishing.yml |
Example fishing sell menu |
src/main/resources/gui/price_setter.yml |
Price Setter GUI layout |
src/main/resources/gui/price_evaluation.yml |
Price Evaluation GUI layout |
src/main/resources/gui/autosell_settings.yml |
Autosell Settings GUI layout |
src/main/resources/itemprices.yml |
Vanilla item prices |
src/main/resources/mmoitems.yml |
MMOItems prices |
src/main/resources/nexo.yml |
Nexo item prices |
src/main/resources/random-prices.yml |
Random/evaluation prices |
CHANGELOG.md |
v3 changelog |
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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧