QuickSell - 监狱商店插件

QuickSell 是一款流行的商店插件，尤其适用于监狱服务器。它允许玩家以多种方式向服务器出售物品，并内置轻量级的增益系统，不仅能创建出售倍率增益，还能支持经验、mcMMO 等多种增益效果。

💡重要说明

• 原作者 mrCookieSlime/TheBusyBiscuit 已停止维护此插件，但这并不意味着 QuickSell 已停止开发。
• 插件源码已在 GitHub 上开源。如果你是或认识有能力的插件开发者，欢迎通过提交 Pull Request 来为此项目贡献代码，使其保持活力。

🎮核心功能

• 简易商店创建与管理：支持通过游戏内编辑器轻松创建和管理商店。
• 增益系统：可创建和管理增益效果，包括适用于 PrisonGems 的宝石增益或 mcMMO 增益等。
• 传统出售牌：提供轻量级 GUI 的出售告示牌（出售、估价、取消）。
• 一键出售：支持出售全部物品的告示牌和命令。
• NPC 商人：集成 Citizens，可设置商人 NPC。
• 价格总览：提供清晰的价格概览界面。
• 更多功能：持续更新与扩展。

🔧基础使用

出售物品

玩家可以通过以下方式使用出售功能

• 执行命令 /sell（可在配置中禁用）。
• 使用 [Sell] 告示牌。

使用后会打开一个 GUI 界面

• 绿色染色玻璃：确认交易，出售 GUI 中的所有物品。
• 黄色染色玻璃：预估出售这些物品可获得的收益。
• 红色染色玻璃：取消交易，所有物品将返还给玩家。

只需将想出售的物品放入 GUI 即可完成操作，非常简单。

一键出售全部

玩家可以通过以下方式使用一键出售功能

• 执行命令 /sellall（可在配置中禁用）。
• 使用 [Sell All] 告示牌。

此功能不会打开 GUI，而是直接扫描玩家库存中所有可出售给当前商店的物品并自动出售。

• 如果安装了 PrisonUtils，插件还会扫描玩家的背包。

🔧进阶功能

自动出售

注意：此功能需要安装 PrisonUtils！

• 玩家可通过执行 /autosell 来切换自动出售功能。
• 此功能会尝试自动出售玩家挖掘的所有方块。
• 为避免刷屏，每次出售不会发送提示消息，但每出售一定数量的方块后，会汇总显示近期出售情况。

价格查询

• 执行命令 /prices <商店名称>。
• 左击出售告示牌、一键出售告示牌或 NPC 商人。

此功能会清晰展示指定商店可收购的物品及其价格。

NPC 商人

注意：此功能需要安装 Citizens！

• 可以使用命令将任意 Citizens NPC 链接到商店：

/quicksell linknpc <商店名称> <sell/sellall>

• 链接后，右键点击该 NPC 会像点击出售或一键出售告示牌一样触发对应功能。

✨插件扩展与集成

QuickSell 支持与以下插件集成以扩展功能：

• PrisonUtils (mrCookieSlime)：允许在出售全部和命令中使用背包，并支持挖掘时自动出售。
• PrisonGems (mrCookieSlime)：允许创建宝石增益。
• mcMMO (drtshock, t00thpick1, TfT_02)：允许创建 mcMMO 经验增益。
• Citizens (fullwall)：允许设置 NPC 商人。
• PickaxeSell (TOX1C)：允许右键点击镐来出售所有物品。
• QS Permission Boosters (MrEminent42)：允许根据玩家权限（等级）给予 QuickSell 增益。
• QS Sell-Command Permissions (MrEminent42)：为 /sell 和 /sellall 命令添加权限需求。

🎮命令与权限

命令列表

• /sell [商店名称]

打开出售物品的库存界面。命令本身无需权限，但访问商店需要对应权限，详见配置部分。

• /sellall [商店名称]

将库存中所有物品出售给指定商店。命令本身无需权限，但访问商店需要对应权限。

• /booster <类型/all> <玩家名> <倍率> <持续时间(分钟)>

示例：/booster mrCookieSlime 2 1 将为全服玩家启用 2 倍交易增益，持续 1 分钟。可连接至 Buycraft 以实现合规盈利。

所需权限：QuickSell.booster

• /pbooster <类型/all> <玩家名> <倍率> <持续时间(分钟)>

示例：/booster mrCookieSlime 2 1 将仅为 mrCookieSlime 启用 2 倍交易增益，持续 1 分钟。可连接至 Votifier 等。

所需权限：QuickSell.booster

• /boosters

列出所有当前激活的增益效果。

• /quicksell

显示帮助信息。

所需权限：QuickSell.manage

• /quicksell reload

重载插件配置。

所需权限：QuickSell.manage

• /quicksell editor

打开游戏内商店编辑器。

所需权限：QuickSell.manage

• /quicksell stopboosters [玩家名]

停止所有全局增益。添加玩家参数可停止该玩家的所有私人增益。

所需权限：QuickSell.manage

• /prices <商店名称>

查看指定商店可收购的物品列表。

所需权限：QuickSell.prices

权限说明

• 创建告示牌需要权限：QuickSell.sign.create

🎮告示牌设置

注意：所有空行都可以替换为你自定义的文本，例如：“$32.5/ea”、“点击打开”等。

• 标准出售牌

  [Sell]
  [商店名称]

此告示牌会像执行 /sell 一样打开商店 GUI。第二行可指定商店。

• 一键出售牌

  [Sell All]
  [商店名称]

此告示牌会尝试将你所有的物品出售给指定商店。

• 指定类型出售牌

  [Sell All]
  [物品类型]
  [商店名称]

此告示牌会将指定类型的所有物品出售给指定商店。

• 简化出售牌

如果将配置项 open-only-shop-with-permission 设置为 true，你甚至可以只写 Sell All，而不管其他行是什么内容。这将自动打开你拥有权限的最高等级商店。

🎮配置详解

options:
  auto-update: true          # 插件是否自动更新
  sell-gui-rows: 3           # 出售 GUI 的行数
  locked-item: STAINED_GLASS_PANE-14 # 商店不可访问时显示的物品
  sign-prefix: '&7[&eSell&7]'        # 出售告示牌的前缀。更改后，创建告示牌时第一行也需匹配此外观。
  sellall-sign-prefix: '&a&oSellAll' # 一键出售告示牌的前缀，规则同上。
  pregenerate-all-item-prices: false # 是否在配置中预生成所有物品价格
  enable-menu-line: false    # 是否在 GUI 中添加“出售”、“估价”、“取消”按钮
  enable-commands: true      # 是否启用 /sell 和 /sellall 命令

boosters:
  extension-mode: false      # 启用后，若激活一个 2 倍增益时已有另一个 2 倍增益在运行，则会延长现有增益时间而非叠加。
  refresh-every: 10          # 检查增益是否失效的间隔时间（秒）

commands-on-sell:            # 出售物品时执行的命令。支持变量 {PLAYER} 和 {MONEY}
  - say {PLAYER} just sold something and got ${MONEY}
  - title {PLAYER} title {text:"+ ",color:green,bold:true,underlined:false,italic:false,strikethrough:false,obfuscated:false,extra:[{text:"${MONEY}",color:gold,bold:true,underlined:false,italic:false,strikethrough:false,obfuscated:false}]}

sound:
  enabled: true              # 出售时是否播放音效
  sound: ORB_PICKUP          # 播放的音效类型

# 以下部分不建议手动修改，请使用 /quicksell editor 进行编辑。
list:
  - A                        # 将所有新商店添加到此列表，插件会像下面一样生成对应配置节。
  - ''                       # 添加 '' 可在 GUI 中创建空位以分隔商店。

shops:
  A:                         # 商店 A 的配置节
    name: '&aA-Shop'         # 商店名称
    itemtype: CHEST          # 商店在 GUI 中显示的物品
    amount: 64               # 此商店的所有价格将除以这个数字。（例如：如果你设置 1 个圆石价格为 $64，玩家实际只能得到 $1）
    lore:                    # 商店描述
      - ''
      - '&aYoucanalsoaddalittledescriptiontoyourShophere' # 支持颜色代码！
    permission: QuickSell.shop.A # 使用此商店所需的权限，设为 '' 则无需权限。
    price:                   # 此商店的物品价格
      STONE: 0.0             # 0.0 表示不可出售。
      GRASS: 10.2            # 指定出售此材料物品可获得的单价。
      STAINED_CLAY-2: 3.5    # 通过附加 -{META-ID} 可为特定元数据物品设置价格。
      DIAMOND_SWORD-&cSoulbound Sword: 100.32 # 也可指定显示名称，支持颜色代码。
  C:                         # 另一个商店 C
    name: '&aCisawesome'
    itemtype: SPONGE
    amount: 1
    lore: []
    permission: ''
    price:
      SPONGE: 10.0
    inheritance:             # 此列表将从下方列出的商店导入所有价格。注意：列表中越靠下的商店，其价格优先级越低。
      - A                    # 优先级低于 C
      - B                    # 优先级低于 A

✨开发者 API

QuickSell 为开发者提供了轻量级的 API，可用于创建自定义扩展。

插件提供了大量方法，具体请参考 API 文档。

❓插件统计与更新

自动更新

• 本插件使用自动更新器，以确保你始终使用最新且最稳定的版本。
• 若不想启用自动更新，可在配置文件中修改：

options -> auto-update: true/false

统计指标 (Metrics)

插件使用统计系统收集以下匿名信息

• 唯一标识符
• 服务器的 Java 版本
• 服务器是否处于离线模式
• 插件版本
• 服务器版本
• 操作系统版本/名称与架构
• CPU 核心数
• 在线玩家数
• Metrics 版本

如何退出统计：

编辑 plugins/Plugin Metrics/config.yml 文件，将 opt-out 改为 true 即可。