
GUIShop v9.4.3c
Minecraft 服务器终极基于 GUI 的商店插件
完全兼容 Paper/Spigot/Folia/Bukkit 1.13 - 1.21.11
概述
GUIShop 是一款功能强大、特性丰富的商店插件,允许服务器管理员创建美观且高度可定制的基于 GUI 的商店。告别令人困惑的告示牌商店和箱子系统。GUIShop 为玩家提供直观的购物体验,同时赋予管理员对价格、物品和布局的完全控制权。
主要特性
- 易于使用的 GUI 系统 - 玩家通过整洁、有序的库存菜单浏览商店
- 多页商店 - 为大型物品目录创建具有无限页面的商店
- 动态定价 - 可选的基于供需关系的定价系统
- 价值显示系统 - 直接在物品描述中显示出售价值(需要 PacketEvents)
- 完整的基于 GUI 的物品编辑器 - 通过直观的 GUI 编辑物品价格、名称、附魔等
- 拖拽式商店构建 - 只需拖拽即可放置和重新排列商店中的物品
- 命令物品 - 出售时可执行命令的命令物品
- 自定义物品支持 - 完全支持附魔、药水、烟花和自定义模型数据
- 原生刷怪笼支持 - 配置并售卖任何实体类型的刷怪笼
- 原生玩家头颅支持 - 使用玩家 UUID 或 Base64 皮肤纹理制作自定义头颅
- PDC 支持 - 使用 Bukkit 的持久化数据容器 API 进行可靠的物品识别
- 单物品权限控制 - 限制特定物品仅供某些玩家组使用
- PlaceholderAPI 支持 - 在商店名称和描述中使用占位符
- Vault 集成 - 兼容任何 Vault 经济插件
- 内置经济系统 - 可选的内部经济系统(无需外部经济插件!)
- 替代出售 GUI - 在不离开商店的情况下出售物品
- 交易日志记录 - 追踪所有购买和销售记录
截图
点击查看截图
主菜单

商店视图

物品编辑器

数量选择器

价值显示

命令
玩家命令
/shop, /buy - 打开商店菜单
/sell - 打开出售 GUI
/value, /val - 检查手持物品的购买/出售价值
管理员命令
/gs reload - 重载所有配置文件
/gs edit - 进入主菜单的创建者模式
/gs edit menu - 进入主菜单的创建者模式
/gs edit transaction - 进入交易 GUI 的创建者模式
/gs edit [shop] - 进入特定商店的创建者模式
/gs edit [shop] [page] - 编辑特定商店的特定页面
/gs parsemob <type> - 验证刷怪笼的实体类型
/gs toggleworth - 切换自身的价值显示(仅当前会话有效)
/gs iteminfo - 显示手持物品的综合信息
经济命令
(仅在启用内置经济时可用)
玩家命令:
/bal, /balance, /money - 查看余额
/bal <player> - 查看其他玩家的余额
/pay <player> <amount> - 向玩家转账
/togglepay - 开启/关闭转账通知
管理员命令:
/gs eco give <player> <amount> - 给予玩家金钱
/gs eco take <player> <amount> - 扣除玩家金钱
/gs eco set <player> <amount> - 设置玩家余额
/gs eco balance <player> - 查看玩家余额
/gs eco reset <player> - 重置为初始余额
所有金额均支持缩写:1k, 1.5M, 100B 等。
物品信息命令
/gs iteminfo 命令是一个强大的调试和配置辅助工具。手持任意物品并运行该命令以查看:
- 材质类型和显示名称
- 所有描述行
- 配置就绪格式的附魔(例如
SHARPNESS:5 UNBREAKING:3)
- 配置就绪格式的药水信息(类型、溅射版、延长版、升级版)
- 配置就绪格式的烟花信息(飞行效果、爆炸效果、颜色)
- 所有 PDC(持久化数据容器)值
- 自定义 NBT 数据
这使得配置复杂物品变得非常容易——只需创建你想要的物品,然后使用 /gs iteminfo 获取 shops.yml 所需的精确格式。
权限
guishop.use - 访问商店(默认:op)
guishop.shop.* - 访问所有商店物品(默认:op)
guishop.shop.<shop>.<item> - 访问特定物品
guishop.reload - 重载插件的权限(默认:op)
guishop.creator - 访问游戏内商店编辑器(默认:op)
guishop.value - 访问 /value 命令(默认:true)
guishop.sell - 访问 /sell 命令(默认:true)
guishop.admin - 完整管理员权限(默认:op)
配置
GUIShop 使用多个配置文件以实现最大灵活性:
- config.yml - 通用插件设置、命令、标题、按钮
- shops.yml - 商店布局和物品定义
- menu.yml - 主菜单配置
- messages.yml - 所有插件消息(完全可定制)
- worth.yml - 价值显示系统配置
示例商店物品配置
shops:
Blocks:
pages:
Page0:
'0':
type: SHOP # 物品类型(SHOP、COMMAND、SHOP_SHORTCUT、DUMMY、BLANK)
id: STONE # 材质 ID
buy-price: 10.0 # 购买价格(设为 'false' 则禁用)
sell-price: 5.0 # 出售价格(设为 'false' 则禁用)
shop-name: '&7Stone' # 商店中显示的名称
buy-name: '&7Stone' # 购买后物品显示的名称
shop-lore: # 商店中显示的描述信息
- '&fA basic building block'
enchantments: 'DURA:1 SHARP:2' # 附魔(空格分隔)
quantity: 64 # 给予的堆叠数量
permission: 'shop.vip' # 所需权限(可选)
基于 GUI 的物品编辑器
GUIShop 提供了一个功能强大且完全基于图形用户界面 (GUI) 的物品编辑器,无需手动编辑配置文件。通过直观的点击式菜单配置商店物品的各个方面。
工作原理
- 使用
/gs edit(用于菜单)或 /gs edit <shop>(用于特定商店)进入创建者模式
- 左键点击以拖放物品——在商店内移动物品、重新排列位置,或将背包中的新物品放置到商店中
- 右键点击或 Shift+点击任意物品以打开物品编辑器 GUI
- 点击任何设置项,通过聊天输入或嵌套选择 GUI 进行修改
- 关闭库存界面时自动保存更改
创建者模式控制
左键点击 - 拾取 / 放置物品(可在商店与背包之间操作)
右键点击 - 打开被点击物品的物品编辑器
Shift+点击 - 打开被点击物品的物品编辑器
导航按钮(分页、返回、余额):
左键点击 - 拾取并移动按钮
右键点击 - 打开该按钮的物品编辑器
Shift+点击 - 激活按钮(切换页面、返回等)
物品编辑器功能
- 购买/出售价格 - 支持缩写格式(如 1k, 1.5M, 100B)设置价格
- 物品类型 - 在 SHOP、COMMAND、SHOP_SHORTCUT 和 DUMMY 类型之间切换
- 显示名称 - 设置商店显示名称和购买后物品名称
- 自定义描述 - 为物品添加描述性 Lore 行
- 附魔 - 通过可视化附魔选择器添加/移除附魔
- 药水效果 - 通过 GUI 配置药水类型、持续时间和等级
- 烟花属性 - 设置飞行持续时间、爆炸形状、颜色和效果
- 刷怪笼怪物类型 - 从可视化实体选择器中选择怪物类型
- 命令 - 配置购买时执行的命令
- 权限 - 为每个物品设置所需权限
- 数量 - 设置购买时给予的堆叠数量
物品编辑器截图
物品编辑器主视图

附魔选择器

药水编辑器

价值显示系统
GUIShop 包含一个强大的价值显示功能,可直接在物品描述中显示出售价值。该系统使用数据包操作仅在客户端侧显示价值,这意味着你的实际物品永远不会被修改。
要求: PacketEvents 插件
价值显示配置 (worth.yml)
enabled: true
format: "&7Worth: &a%worth%"
position: BOTTOM
add-blank-line: true
only-show-sellable: true
not-sellable-format: "&7Worth: &cNot sellable"
# 在特定库存界面隐藏价值
blacklisted-inventories:
- "Auction House"
- "Crate Preview"
# 在具有特定名称的物品上隐藏价值
blacklisted-item-names:
- "Crate Key"
- "Vote Token"
# 在装备的盔甲上隐藏价值
hide-armor-slots: true
高级物品类型
命令物品
出售并在购买时执行命令。使用占位符如 {PLAYER_NAME}、{PLAYER_UUID}、{PLAYER_WORLD} 或任何 PlaceholderAPI 占位符:
'19':
type: COMMAND
id: NETHER_STAR
shop-name: '&6VIP Rank'
buy-price: 10000
sudo: false # 以控制台身份运行(默认)或以玩家身份运行(true)
commands:
- 'lp user {PLAYER_NAME} parent set vip'
- 'broadcast {PLAYER_NAME} purchased VIP!'
可用占位符:
| 占位符 |
描述 |
{PLAYER_NAME} |
玩家名称 |
{PLAYER_UUID} |
玩家 UUID |
{PLAYER_WORLD} |
玩家当前所在世界 |
{PLAYER_BALANCE} |
玩家经济余额 |
所有占位符也支持 %placeholder% 格式。如果安装了 PAPI,也支持 PlaceholderAPI 占位符。
Sudo 模式: 将 sudo: true 设置为以玩家身份而非控制台身份运行命令。适用于检查玩家权限或仅限玩家执行的命令。
附魔书
'20':
type: SHOP
id: ENCHANTED_BOOK
buy-price: 1000
enchantments: 'SHARP:5 FIRE_ASPECT:2'
药水
通过 potion-info 部分配置药水。支持普通药水、喷溅药水和滞留药水。
# 普通药水(加速 II)
'21':
type: SHOP
id: POTION
buy-price: 500
potion-info:
type: SPEED
splash: false
lingering: false
extended: true
upgraded: false
# 喷溅药水(治疗 II)
'22':
type: SHOP
id: SPLASH_POTION
buy-price: 600
potion-info:
type: HEALING
splash: true
lingering: false
extended: false
upgraded: true
# 滞留药水
'23':
type: SHOP
id: LINGERING_POTION
buy-price: 700
potion-info:
type: POISON
splash: false
lingering: true
extended: true
upgraded: false
药水信息字段:
| 字段 |
描述 |
type |
药水效果(SPEED, HEALING, STRENGTH, POISON 等) |
splash |
是否为喷溅药水 |
lingering |
是否为滞留药水 |
extended |
持续时间延长版本 |
upgraded |
II 级/更强效果版本 |
刷怪笼
支持任意有效实体类型的原生刷怪笼(使用 /gs parsemob <type> 进行验证):
'22':
type: SHOP
id: SPAWNER
buy-price: 50000
mob-type: ZOMBIE
shop-name: '&6僵尸刷怪笼'
烟花
'23':
type: SHOP
id: FIREWORK_ROCKET
buy-price: 100
firework-info:
flight: 2
explosions:
- shape: ball_large
flicker: true
trail: true
colors: [11743532, 2437522]
fade-colors: [1973019, 15790320]
玩家头颅
支持玩家 UUID 或 Base64 皮肤纹理:
# 使用玩家 UUID
'24':
type: SHOP
id: PLAYER_HEAD
buy-price: 1000
skull-uuid: 'player-uuid-here'
# 使用 Base64 皮肤纹理(来自 minecraft-heads.com 等)
'25':
type: SHOP
id: PLAYER_HEAD
buy-price: 500
skull-uuid: 'eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvYWJjMTIzIn19fQ=='
统计与 PlaceholderAPI
GUIShop 会追踪玩家的商店统计数据,并与 PlaceholderAPI 集成,以便在计分板、全息图和聊天中使用。
追踪的统计数据
- 总消费金额(从商店购买)
- 总赚取金额(出售物品)
- 总购买/出售物品数量
- 每位玩家购买最多的前 3 种物品
- 每位玩家出售最多的前 3 种物品
可用的占位符
%guishop_total_spent% - 消费金额(带千位分隔符)
%guishop_total_spent_formatted% - 消费金额(缩写格式:1.5M)
%guishop_total_earned% - 赚取金额(带千位分隔符)
%guishop_total_earned_formatted% - 赚取金额(缩写格式)
%guishop_items_bought% - 购买物品数量
%guishop_items_bought_formatted% - 购买物品数量(缩写格式)
%guishop_items_sold% - 出售物品数量
%guishop_items_sold_formatted% - 出售物品数量(缩写格式)
%guishop_top_bought_1% - #1 最购买的物品 (材质: 数量)
%guishop_top_sold_1% - #1 最出售的物品 (材质: 数量)
统计数据存储在 SQLite 数据库中 (plugins/GUIShop/Data/player_statistics.db)。
动态定价系统
GUIShop 内置了供需经济系统,使物品价格根据交易活动而波动。
工作原理
- 当物品被购买时:供应减少 → 价格上涨
- 当物品被出售时:供应增加 → 价格下跌
- 随时间推移:价格逐渐恢复正常基准值
配置
在 config.yml 中启用:
dynamic-pricing: true
在 dynamicpricing.yml 中配置:
price-change-per-item: 0.01 # 每件物品变动 1%
max-price-multiplier: 2.0 # 最高可达基准价的 200%
min-price-multiplier: 0.5 # 最低降至基准价的 50%
normalization-rate: 0.001 # 价格回归正常的速度
normalization-interval: 300 # 每次归零调整之间的间隔秒数
单物品覆盖配置
为特定物品设置不同的波动性参数:
item-overrides:
DIAMOND:
price-change-per-item: 0.005 # 更稳定(每件物品变动 0.5%)
max-price-multiplier: 1.5
min-price-multiplier: 0.75
关联定价
使物品影响其他物品的价格——非常适合合成关系:
item-overrides:
DIAMOND_BLOCK:
affects:
DIAMOND: 9.0 # 1 个方块 = 合成需要 9 颗钻石
DIAMOND_ORE: 1.0 # 同时也影响矿石价格
BREAD:
affects:
WHEAT: 3.0 # 1 个面包 = 合成需要 3 个小麦
当玩家购买 1 个 DIAMOND_BLOCK 时,DIAMOND 的价格变化相当于购买了 9 颗钻石。这基于合成配方创建了真实的经济关系!
单物品控制
将特定物品排除在动态定价之外:
'0':
id: DIAMOND
buy-price: 100
sell-price: 50
dynamic: false # 使用静态定价
管理员命令
| 命令 |
描述 |
/gs market status |
查看系统状态 |
/gs market info <item> |
检查物品的市场状态 |
/gs market reset <item> |
重置物品至基准价 |
/gs market resetall |
重置所有价格 |
开发者 API
GUIShop 提供了全面的 API,供开发者进行集成:
API 示例
// 检查物品是否可以出售
boolean canSell = GUIShopAPI.canBeSold(itemStack);
// 获取买入/卖出价格
BigDecimal buyPrice = GUIShopAPI.getBuyPrice(itemStack, quantity);
BigDecimal sellPrice = GUIShopAPI.getSellPrice(itemStack, quantity);
// 以编程方式出售物品
GUIShopAPI.sellItems(player, SellType.COMMAND, items);
// 价值显示 API
BigDecimal worth = GUIShopAPI.getItemWorth(itemStack);
BigDecimal stackWorth = GUIShopAPI.getStackWorth(itemStack);
// 按玩家切换价值显示
GUIShopAPI.toggleWorthForPlayer(player);
GUIShopAPI.enableWorthForPlayer(player);
GUIShopAPI.disableWorthForPlayer(player);
// 用于持久化按玩家价值设置的钩子
GUIShopAPI.setExternalWorthCheck(player -> {
return myPlugin.hasWorthDisabled(player.getUniqueId());
});
完整的 API 文档请参阅 Wiki。
依赖项
必需:
可选:
- Economy Plugin(EssentialsX、CMI 等)- 或者使用 GUISShop 内置的经济系统!
- PacketEvents(用于价值显示功能)
Folia 支持:
GUIShop 完全支持 Folia —— Paper 的区域化多线程分支,旨在提升大型服务器的性能。无需额外配置!
注意: GUIShop 包含其自身的经济系统!在 economy.yml 中启用它,即可将 GUIShop 用作服务器的经济系统,无需 EssentialsX 或其他类似插件。
安装
- 下载 GUIShop 并将其放入你的 plugins(插件)文件夹中
- 安装 Vault 和经济类插件(如 EssentialsX、CMI 等)——或者启用 GUIShop 内置的经济系统
- (可选)安装 PacketEvents 以显示物品价值
- (可选)安装 PlaceholderAPI 以支持占位符
- 重启服务器
- 在
plugins/GUIShop/shops.yml 中配置商店
- 使用
/gs reload 应用更改
支持
由 pablo67340 开发
如果你喜欢 GUIShop,请考虑留下评价!

GUIShop v9.4.3c
The Ultimate GUI-Based Shop Plugin for Minecraft Servers
Fully compatible with Paper/Spigot/Folia/Bukkit 1.13 - 1.21.11
Overview
GUIShop is a powerful, feature-rich shop plugin that allows server owners to create beautiful GUI-based shops with extensive customization options. Say goodbye to confusing sign shops and chest-based systems. GUIShop provides players with an intuitive shopping experience while giving administrators complete control over pricing, items, and layout.
Key Features
- Easy-to-Use GUI System - Players browse shops through clean, organized inventory menus
- Multi-Page Shops - Create shops with unlimited pages for large item catalogs
- Dynamic Pricing - Optional supply/demand based pricing system
- Worth Display System - Shows item sell values directly in item lore (requires PacketEvents)
- Full GUI-Based Item Editor - Edit item prices, names, enchantments, and more through an intuitive GUI
- Drag-and-Drop Shop Building - Place and rearrange items in shops by simply dragging them
- Command Items - Sell commands that execute when purchased
- Custom Items - Full support for enchantments, potions, fireworks, and custom model data
- Native Spawner Support - Configure and sell mob spawners with any entity type
- Native Player Head Support - Use player UUIDs or Base64 skin textures for custom heads
- PDC Support - Uses Bukkit's Persistent Data Container API for reliable item identification
- Per-Item Permissions - Restrict specific items to certain player groups
- PlaceholderAPI Support - Use placeholders in shop names and lores
- Vault Integration - Works with any Vault-compatible economy plugin
- Built-In Economy - Optional internal economy system (no external economy plugin needed!)
- Alternate Sell GUI - Sell items without leaving the shop
- Transaction Logging - Track all purchases and sales
Screenshots
Click to view screenshots
Main Menu

Shop View

Item Editor

Quantity Selector

Worth Display

Commands
Player Commands
/shop, /buy - Open the shop menu
/sell - Open the sell GUI
/value, /val - Check the buy/sell value of held item
Admin Commands
/gs reload - Reload all configuration files
/gs edit - Enter creator mode for the main menu
/gs edit menu - Enter creator mode for the main menu
/gs edit transaction - Enter creator mode for the transaction GUI
/gs edit [shop] - Enter creator mode for a specific shop
/gs edit [shop] [page] - Edit a specific page of a shop
/gs parsemob <type> - Validate a mob type for spawners
/gs toggleworth - Toggle worth display for yourself (session only)
/gs iteminfo - Display comprehensive info about held item
Economy Commands
(Only available when internal economy is enabled)
Player Commands:
/bal, /balance, /money - Check your balance
/bal <player> - Check another player's balance
/pay <player> <amount> - Send money to a player
/togglepay - Toggle payment notifications on/off
Admin Commands:
/gs eco give <player> <amount> - Give money to a player
/gs eco take <player> <amount> - Take money from a player
/gs eco set <player> <amount> - Set a player's balance
/gs eco balance <player> - Check a player's balance
/gs eco reset <player> - Reset to starting balance
All amounts support abbreviations: 1k, 1.5M, 100B, etc.
Item Info Command
The /gs iteminfo command is a powerful debugging and configuration helper. Hold any item and run the command to see:
- Material type and display name
- All lore lines
- Enchantments in config-ready format (e.g.,
SHARPNESS:5 UNBREAKING:3)
- Potion info in config-ready format (type, splash, extended, upgraded)
- Firework info in config-ready format (flight, explosions, colors)
- All PDC (Persistent Data Container) values
- Custom NBT data
This makes it easy to configure complex items - just create the item you want, then use /gs iteminfo to get the exact format needed for your shops.yml.
Permissions
guishop.use - Access to the shop (default: op)
guishop.shop.* - Access to all shop items (default: op)
guishop.shop.<shop>.<item> - Access to specific items
guishop.reload - Permission to reload the plugin (default: op)
guishop.creator - Access to the in-game shop editor (default: op)
guishop.value - Access to /value command (default: true)
guishop.sell - Access to /sell command (default: true)
guishop.admin - Full admin access (default: op)
Configuration
GUIShop uses several configuration files for maximum flexibility:
- config.yml - General plugin settings, commands, titles, buttons
- shops.yml - Shop layouts and item definitions
- menu.yml - Main menu configuration
- messages.yml - All plugin messages (fully customizable)
- worth.yml - Worth display system configuration
Example Shop Item Configuration
shops:
Blocks:
pages:
Page0:
'0':
type: SHOP # Item type (SHOP, COMMAND, SHOP_SHORTCUT, DUMMY, BLANK)
id: STONE # Material ID
buy-price: 10.0 # Price to buy (or 'false' to disable)
sell-price: 5.0 # Price to sell (or 'false' to disable)
shop-name: '&7Stone' # Display name in shop
buy-name: '&7Stone' # Name on purchased item
shop-lore: # Lore shown in shop
- '&fA basic building block'
enchantments: 'DURA:1 SHARP:2' # Enchantments (space separated)
quantity: 64 # Stack size to give
permission: 'shop.vip' # Required permission (optional)
GUI-Based Item Editor
GUIShop features a powerful, fully GUI-based item editor that eliminates the need for manual config editing. Configure every aspect of shop items through intuitive click-based menus.
How It Works
- Enter creator mode with
/gs edit (for menu) or /gs edit <shop> (for shops)
- Left-click to drag and drop items - move items within the shop, rearrange positions, or place new items from your inventory into the shop
- Right-click or Shift+click any item to open the Item Editor GUI
- Click on any setting to modify it through chat input or nested selection GUIs
- Changes save automatically when you close the inventory
Creator Mode Controls
Left-click - Pick up / place items (works between shop and your inventory)
Right-click - Open Item Editor for the clicked item
Shift+click - Open Item Editor for the clicked item
Navigation Buttons (pagination, back, balance):
Left-click - Pick up and move the button
Right-click - Open Item Editor for the button
Shift+click - Activate the button (navigate pages, go back, etc.)
Item Editor Features
- Buy/Sell Prices - Set prices with support for abbreviated formats (1k, 1.5M, 100B)
- Item Type - Switch between SHOP, COMMAND, SHOP_SHORTCUT, and DUMMY types
- Display Names - Set shop display name and purchased item name
- Custom Lore - Add descriptive lore lines to items
- Enchantments - Add/remove enchantments through a visual enchantment picker
- Potion Effects - Configure potion type, duration, and amplifier via GUI
- Firework Properties - Set flight duration, explosion shapes, colors, and effects
- Spawner Mob Type - Select mob type from a visual entity picker
- Commands - Configure commands to run on purchase
- Permissions - Set required permissions per item
- Quantity - Set stack size given on purchase
Item Editor Screenshots
Item Editor Main View

Enchantment Selector

Potion Editor

Worth Display System
GUIShop includes a powerful worth display feature that shows item sell values directly in the item lore. This uses packet manipulation to display worth client-side only, meaning your actual items are never modified.
Requirements: PacketEvents plugin
Worth Display Configuration (worth.yml)
enabled: true
format: "&7Worth: &a%worth%"
position: BOTTOM
add-blank-line: true
only-show-sellable: true
not-sellable-format: "&7Worth: &cNot sellable"
# Hide worth in specific inventories
blacklisted-inventories:
- "Auction House"
- "Crate Preview"
# Hide worth on items with specific names
blacklisted-item-names:
- "Crate Key"
- "Vote Token"
# Hide worth on equipped armor
hide-armor-slots: true
Advanced Item Types
Command Items
Sell commands that execute when purchased. Use placeholders like {PLAYER_NAME}, {PLAYER_UUID}, {PLAYER_WORLD}, or any PlaceholderAPI placeholder:
'19':
type: COMMAND
id: NETHER_STAR
shop-name: '&6VIP Rank'
buy-price: 10000
sudo: false # Run as console (default) or as player (true)
commands:
- 'lp user {PLAYER_NAME} parent set vip'
- 'broadcast {PLAYER_NAME} purchased VIP!'
Available Placeholders:
| Placeholder |
Description |
{PLAYER_NAME} |
Player's name |
{PLAYER_UUID} |
Player's UUID |
{PLAYER_WORLD} |
Player's current world |
{PLAYER_BALANCE} |
Player's economy balance |
All placeholders also work in %placeholder% format. PlaceholderAPI placeholders are also supported if PAPI is installed.
Sudo Mode: Set sudo: true to run commands as the player instead of console. Useful for commands that check player permissions or are player-only.
Enchanted Books
'20':
type: SHOP
id: ENCHANTED_BOOK
buy-price: 1000
enchantments: 'SHARP:5 FIRE_ASPECT:2'
Potions
Configure potions with the potion-info section. Supports regular, splash, and lingering potions.
# Regular Potion (Extended Speed)
'21':
type: SHOP
id: POTION
buy-price: 500
potion-info:
type: SPEED
splash: false
lingering: false
extended: true
upgraded: false
# Splash Potion (Healing II)
'22':
type: SHOP
id: SPLASH_POTION
buy-price: 600
potion-info:
type: HEALING
splash: true
lingering: false
extended: false
upgraded: true
# Lingering Potion
'23':
type: SHOP
id: LINGERING_POTION
buy-price: 700
potion-info:
type: POISON
splash: false
lingering: true
extended: true
upgraded: false
Potion Info Fields:
| Field |
Description |
type |
Potion effect (SPEED, HEALING, STRENGTH, POISON, etc.) |
splash |
Whether it's a splash potion |
lingering |
Whether it's a lingering potion |
extended |
Extended duration version |
upgraded |
Level II/stronger effect version |
Spawners
Native spawner support with any valid entity type (use /gs parsemob <type> to validate):
'22':
type: SHOP
id: SPAWNER
buy-price: 50000
mob-type: ZOMBIE
shop-name: '&6Zombie Spawner'
Fireworks
'23':
type: SHOP
id: FIREWORK_ROCKET
buy-price: 100
firework-info:
flight: 2
explosions:
- shape: ball_large
flicker: true
trail: true
colors: [11743532, 2437522]
fade-colors: [1973019, 15790320]
Player Heads
Support for player UUIDs or Base64 skin textures:
# Using player UUID
'24':
type: SHOP
id: PLAYER_HEAD
buy-price: 1000
skull-uuid: 'player-uuid-here'
# Using Base64 skin texture (from minecraft-heads.com, etc.)
'25':
type: SHOP
id: PLAYER_HEAD
buy-price: 500
skull-uuid: 'eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvYWJjMTIzIn19fQ=='
Statistics & PlaceholderAPI
GUIShop tracks player shop statistics and integrates with PlaceholderAPI for use in scoreboards, holograms, and chat.
Tracked Statistics
- Total money spent (buying from shops)
- Total money earned (selling items)
- Total items bought/sold
- Top 3 most bought items per player
- Top 3 most sold items per player
Available Placeholders
%guishop_total_spent% - Money spent (with commas)
%guishop_total_spent_formatted% - Money spent (abbreviated: 1.5M)
%guishop_total_earned% - Money earned (with commas)
%guishop_total_earned_formatted% - Money earned (abbreviated)
%guishop_items_bought% - Items purchased count
%guishop_items_bought_formatted% - Items purchased (abbreviated)
%guishop_items_sold% - Items sold count
%guishop_items_sold_formatted% - Items sold (abbreviated)
%guishop_top_bought_1% - #1 most bought item (Material: Qty)
%guishop_top_sold_1% - #1 most sold item (Material: Qty)
Statistics are stored in SQLite (plugins/GUIShop/Data/player_statistics.db).
Dynamic Pricing System
GUIShop includes a built-in supply/demand economy system that makes item prices fluctuate based on trading activity.
How It Works
- When items are bought: Supply decreases → prices increase
- When items are sold: Supply increases → prices decrease
- Over time: Prices gradually normalize back to base values
Configuration
Enable in config.yml:
dynamic-pricing: true
Configure in dynamicpricing.yml:
price-change-per-item: 0.01 # 1% change per item
max-price-multiplier: 2.0 # Up to 200% of base price
min-price-multiplier: 0.5 # Down to 50% of base price
normalization-rate: 0.001 # How fast prices return to normal
normalization-interval: 300 # Seconds between normalization ticks
Per-Item Overrides
Configure different volatility settings for specific items:
item-overrides:
DIAMOND:
price-change-per-item: 0.005 # More stable (0.5% per item)
max-price-multiplier: 1.5
min-price-multiplier: 0.75
Linked Pricing
Make items affect other items' prices - perfect for crafting relationships:
item-overrides:
DIAMOND_BLOCK:
affects:
DIAMOND: 9.0 # 1 block = 9 diamonds in crafting
DIAMOND_ORE: 1.0 # Also affects ore prices
BREAD:
affects:
WHEAT: 3.0 # 1 bread = 3 wheat in crafting
When a player buys 1 DIAMOND_BLOCK, DIAMOND prices change as if 9 diamonds were bought. This creates realistic economic relationships based on crafting recipes!
Per-Item Control
Exempt specific items from dynamic pricing:
'0':
id: DIAMOND
buy-price: 100
sell-price: 50
dynamic: false # Uses static pricing
Admin Commands
| Command |
Description |
/gs market status |
View system status |
/gs market info <item> |
Check item's market status |
/gs market reset <item> |
Reset item to base price |
/gs market resetall |
Reset all prices |
Developer API
GUIShop provides a comprehensive API for developers to integrate with:
API Examples
// Check if an item can be sold
boolean canSell = GUIShopAPI.canBeSold(itemStack);
// Get buy/sell prices
BigDecimal buyPrice = GUIShopAPI.getBuyPrice(itemStack, quantity);
BigDecimal sellPrice = GUIShopAPI.getSellPrice(itemStack, quantity);
// Sell items programmatically
GUIShopAPI.sellItems(player, SellType.COMMAND, items);
// Worth Display API
BigDecimal worth = GUIShopAPI.getItemWorth(itemStack);
BigDecimal stackWorth = GUIShopAPI.getStackWorth(itemStack);
// Per-player worth toggle
GUIShopAPI.toggleWorthForPlayer(player);
GUIShopAPI.enableWorthForPlayer(player);
GUIShopAPI.disableWorthForPlayer(player);
// Hook for persistent per-player worth settings
GUIShopAPI.setExternalWorthCheck(player -> {
return myPlugin.hasWorthDisabled(player.getUniqueId());
});
Full API documentation available on the Wiki.
Dependencies
Required:
Optional:
- Economy Plugin (EssentialsX, CMI, etc.) - OR use GUIShop's built-in economy!
- PacketEvents (for worth display feature)
Folia Support:
GUIShop fully supports Folia - Paper's regionized multithreading fork for improved performance on large servers. No additional configuration required!
- PlaceholderAPI (for placeholder support)
Note: GUIShop includes its own economy system! Enable it in economy.yml to use GUIShop as your server's economy without needing EssentialsX or similar plugins.
Installation
- Download GUIShop and place it in your plugins folder
- Install Vault and an economy plugin (EssentialsX, CMI, etc.) - OR enable GUIShop's internal economy
- (Optional) Install PacketEvents for worth display
- (Optional) Install PlaceholderAPI for placeholder support
- Restart your server
- Configure shops in
plugins/GUIShop/shops.yml
- Use
/gs reload to apply changes
Support
Developed by pablo67340
If you enjoy GUIShop, please consider leaving a review!
评论 0
登录后参与评分
还没有评论,来抢沙发吧