SellGUI

插件

· 作者 NguyenSonhoa

一款面向 MMORPG 的销售系统,无需商店即可使用

0 本站下载 0 关注 更新于 1 周前

最新 3.1.12 · 26.3 · Bukkit / Paper

一键开服(送7天)

SellGUI v3

2028end

快速公告:该项目最初由 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

安装

  1. 下载 SellGUI v3 jar 文件。
  2. 将 jar 文件放入服务器的 plugins/ 文件夹中。
  3. 确保已安装 Vault、NBTAPI 和经济插件。
  4. 重启服务器,以便 SellGUI 生成其配置文件。
  5. 编辑 plugins/SellGUI/ 内的文件。
  6. 编辑配置文件后,运行 /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

工作流程:

  1. 将物品放置在中心槽位。
  2. 使用 GUI 或聊天输入输入价格。
  3. 点击保存以写入价格。

快速命令:

/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 之前的版本升级:

  1. 备份 plugins/SellGUI/ 目录。
  2. 停止服务器。
  3. 安装 v3 jar 文件。
  4. 启动服务器以生成新的 gui/ 文件夹。
  5. 将旧版 gui.yml 中的 GUI 布局/菜单设置移动到 gui/ 下的文件中。
  6. 将每个出售菜单放入 gui/sell_menus/<menu>.yml 对应的独立文件中。
  7. 运行 /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 版本。
  • 相关的经济/物品插件。
  • 相关的配置文件或菜单文件。
  • 控制台错误日志。
  • 复现问题的步骤。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源