SellGUI - 简易自定义售卖菜单

SellGUI 是一款简单易用的 GUI 菜单插件，允许玩家以可配置的价格出售物品。它高度可定制，支持自定义物品、附魔定价、权限奖励和多种销售方式。

💡重要须知

• 本插件必须搭配 Vault 经济插件使用。
• 基于 uShop by MasterCake 开发。

🎮功能特性

• 自定义物品支持：为任意物品设定售价。
• Essentials 价格集成：可直接使用 Essentials 的价格配置。
• 高度可定制：可自定义菜单物品、消息和布局。
• 附魔支持：可为附魔物品设置额外价格加成或倍率。
• 告示牌商店：通过点击告示牌打开销售菜单。
• 交易日志：可记录所有交易。
• 可配置精度：可设置价格显示的小数位数。
• 权限奖励与倍率：根据玩家权限提供额外的出售价格加成。
• SellAll 命令：提供快速出售整个背包物品的命令，无需打开菜单。

🔧命令与权限

命令

• /sellgui - 打开销售菜单。
• 权限：sellgui.use
• /sellgui reload - 重载插件配置。
• 权限：sellgui.reload
• /sellall - 快速出售背包内所有有价值的物品。
• 权限：sellgui.sellall
• /sellgui <玩家名> - 为其他玩家打开销售菜单（控制台也可用）。
• 权限：sellgui.others
• /customitems - 打开自定义物品定价菜单。
• 权限：sellgui.customitems
• /customitems <价格> - 获取用于设定价格的物品。

权限

• sellgui.usesign - 允许玩家使用告示牌打开 SellGUI。
• sellgui.createsign - 允许玩家创建 SellGUI 告示牌。

❓常见问题

问：如何添加自定义物品？

• 执行 /customitems <价格> 获取价格物品。
• 执行 /customitems 打开自定义物品菜单。
• 在顶部格子放入你的自定义物品，在底部格子放入对应的价格物品。
• 注意：删除自定义物品后，请重新检查价格。

问：如何添加附魔定价？

• 请查看下方配置部分的 item prices.yml 文件说明。

问：如何使用菜单而不是 /sell 命令？

• 在服务器的 commands.yml 文件中为 /sellgui 设置一个别名（例如 /sell）。

问：如何制作一个告示牌商店？

• 创建一个告示牌，在第一行写上 [sellgui] 即可。

问：如何添加自定义菜单物品？

• 请查看 custom menu items.yml 文件中的示例进行配置。

⭐配置说明

config.yml

# 菜单配置
menu-size: 54 # 菜单大小，必须是9的倍数，最大54
menu-filler-location: 'bottom' # 填充玻璃板的位置：bottom, left, right, top, round, none
menu-filler-type: 'BLACK_STAINED_GLASS_PANE' # 填充物材质，参考 Material 列表

# 出售按钮配置
sell-item: 'EMERALD' # 出售按钮的材质
sell-item-glimmer: true # 出售按钮是否发光（附魔效果）
sell-item-location: 'middle' # 出售按钮位置：left, middle, right
sell-item-side: 'bottom' # 出售按钮侧边：top, left, bottom, right（仅当填充为 none 或 round 时有效）

# 确认按钮配置
confirm-item: 'EMERALD_BLOCK' # 确认按钮材质
confirm-item-glimmer: true # 确认按钮是否发光

# 功能开关
close-after-sell: true # 出售后关闭菜单
use-essentials-price: false # 是否使用 Essentials 的价格
drop-items-on-close: false # 关闭菜单时是否丢弃物品（为 false 则尝试放回背包）
prevent-custom-item-selling: false # 是否禁止出售带有 ItemMeta（自定义名称、附魔、描述）的物品（可通过自定义物品定价绕过）
log-transactions: false # 是否记录交易日志
round-places: true # 是否对价格进行四舍五入
places-to-round: 2 # 四舍五入的小数位数
sell-all-command-sell-enchanted: false # 使用 /sellall 时是否出售附魔物品

item prices.yml

# 附魔固定价格加成
flat-enchantment-bonus:
- 'SHARPNESS:1:3' # 为任何带有 锋利 I 的物品增加 3.0 价格
# 格式：- '附魔名:等级:加成金额'

# 附魔价格倍率加成
multiplier-enchantment-bonus:
- 'AQUA_AFFINITY:2:1.5' # 将带有 水下速掘 II 的物品价格乘以 1.5
# 格式：- '附魔名:等级:倍率' （在固定加成后应用）

lang.yml

# 菜单文本与消息
menu-title: '&e&lSell Menu' # 菜单标题
menu-pane-name: '' # 填充物品的名称
sell-item-name: '&a&lSell Items' # 出售按钮名称
sell-item-lore: # 出售按钮描述
- '&7Add your items above to sell'
- '&dNo Refunds!'
not-a-command: 'Not a valid command!' # 无效命令提示
confirm-item-name: '&e&lClick to Confirm' # 确认按钮名称
item-total-format: '&7%amount%&r&7x %item%&f: &6&l$&a&l%total%' # 物品总价显示格式（占位符：%amount%, %total%, %item%, %price%）
total-format: '&f&lTotal: $&r&b%total%' # 总价显示格式（占位符：%total%）
sold-message: '&7Sold items for &e&l$&r&f%total%' # 出售成功消息（占位符：%total%）
sellall-confirm-message: '&cAre you sure you want to sell your inventory? Anything with worth will be sold and there are no refunds. To confirm please type &e/sellall confirm' # /sellall 确认消息
sign-lines: # 告示牌文本
- '&aSell Items'
- 'Right Click'
- 'to'
- 'Sell Items'

custom menu items.yml

# 示例：
# example:
#   material: STONE
#   name: "&c&lExample Custom Item"
#   glimmer: true
#   slot: 45
#   lore:
#     - "Sample Lore"
#     - "Optional"
#   commands:
#     - "broadcast example item broadcast"
#     - "minecraft:give %player% minecraft:stone 1"
#
# [标签]: = 可以是任意名称，游戏内不使用
#   material: [材质名] = 参考 Material 列表
#   name: "[名称]" = 物品显示名称
#   glimmer: [布尔值] = true 或 false，为 true 时物品发光
#   slot: [数字] = 物品在菜单中的槽位 (0-53)
#   lore: = 物品描述列表，可为空。若无描述，写为 "lore: " 且不跟任何字符串
#     - "[行内容]"
#   commands: = 点击物品后由控制台执行的命令列表
#     - "[命令]"
#
# 要添加多个自定义物品，请用不同标签重复上述格式。

感谢您的下载！如果喜欢本插件，请给予评分支持。