PlayerShops GUI [BSP] - Allow players to create public shops - PlayerShops GUI [BSP] - 玩家商店插件

PlayerShops GUI 是一款让玩家轻松创建和管理个人商店的插件。通过直观的库存界面，玩家可以买卖物品，无需复杂指令，所有操作都在 GUI 中完成。本插件是 BossShopPro 的扩展，需要先安装 BossShopPro 才能运行。

💡重要提示

• 近期更新仅支持 **1.13.* 及以上** 的 Spigot 版本。
• 如果您使用更旧的 Spigot 版本，请下载 PlayerShops GUI v1.2.2。

🎮核心特性

• 直观易用：所有操作通过 GUI 完成，几乎无需指令。
• 开箱即用：安装后即可使用，所有内容均可按需配置。
• 玩家商店：允许玩家创建自己的公共商店并出售物品。
• 多种货币：支持金钱（需 Vault）、积分（Points）和经验值（Exp）。
• 商店列表：在一个总览 GUI 中浏览所有已开放的商店。
• 商店排名：可配置的商店排序系统。
• 权限排序：可根据玩家权限对商店进行排序。
• 租赁广告位：玩家可以花钱租赁更好的商店展示位置。
• 仅显示在线玩家商店：可选功能，可隐藏离线玩家的商店。
• 购买额外槽位：玩家可以购买更多的商店物品槽位。
• 自定义商店名称：允许玩家为自己的商店命名。
• 交易税：可从每笔交易中抽取一定比例的税费。
• 价格限制：可设置物品的最低和最高售价。
• 物品黑名单：可禁止特定物品被出售。
• 告示牌支持：可通过点击告示牌快速访问商店。
• 购买通知：当商店物品被购买时，店主会在一次访问结束后收到汇总通知，而非每笔交易都通知。

商店图标

• 每个商店都有一个图标。
• 可选功能：使用玩家头颅作为图标（每次打开商店列表时需刷新，可能导致卡顿）。
• 允许玩家自行选择图标，或根据商店规模自动分配图标。
• GUI 中每个物品和组件的外观均可自定义。
• 所有消息和文本均可配置。

告示牌示例

（点击可直接访问玩家商店，此为可选功能）

[PlayerShop]

或用于打开商店列表

[PlayerShops]

🔧指令列表

玩家指令

• /playershops - 打开主 PlayerShops GUI。
• /playershops <玩家名> - 直接打开指定玩家的商店（也可通过商店列表访问）。
• 别名：
• /ps
• /playershop

管理员指令

• /psadmin create <玩家名> - 为指定玩家创建商店。
• /psadmin delete <玩家名> - 删除指定玩家的商店。
• /psadmin save <玩家名> - 保存指定玩家的商店并退出编辑模式（如果该商店当前处于编辑模式）。

✨权限节点

默认情况下权限是禁用的（管理员指令除外）。您可以在 config.yml 中设置 EnablePermissions: true 来启用它们。

• PlayerShops.open - 允许打开主 PlayerShops GUI。
• PlayerShops.create - 允许创建商店。
• PlayerShops.buyslot - 允许购买额外的商店槽位。
• PlayerShops.rent - 允许租赁更好的商店列表位置。
• PlayerShops.selecticon - 允许选择商店图标（需要在配置文件中设置 ShopIcon.AllowIconSelection: true）。
• PlayerShops.createSign - 允许创建指向自己商店的告示牌。
• PlayerShops.createSign.other - 允许创建指向任何玩家商店的告示牌。
• PlayerShops.admin - 使用管理员指令所需的权限。

⭐配置摘要

以下为 config.yml 中的关键配置项概述：

基础设置

• PriceType：使用的货币类型，支持 "Money"（需 Vault）、"Points" 和 "Exp"。
• EnablePermissions：是否启用权限系统。

商店创建

• ShopCreation.Price：创建商店的费用。
• ShopCreation.Slots：初始商店槽位数量。
• ShopEditDelay：两次商店编辑之间的延迟秒数（防止卡顿）。

槽位购买

• SlotPurchase.Enabled：是否允许玩家购买额外槽位。
• SlotPurchase.Price：每次购买的价格（可使用变量计算，如 %playershops_slots_current% * 100 - 800）。
• SlotPurchase.TotalLimit：槽位总数上限。

租赁系统

• Renting.Enabled：是否启用租赁系统。
• Renting.Price：每次租赁的价格。
• Renting.Period：租赁周期时长（秒）。设为 -1 则余额永久有效。
• Renting.PeriodDecrease：每个周期从租赁余额中扣除的金额。
• Renting.SortAfterRentAmount：是否根据租赁余额对商店进行排序。

商店排名

• ShopRanking.List：定义商店的排名顺序列表。可填入权限节点或 "renting"。玩家将获得其符合条件的最高排名。

其他设置

• ListOnlinePlayerShopsOnly：是否只显示在线玩家的商店。
• Tax：交易税率（百分比，1.00 表示 100%）。
• Price.Minimum / Price.Maximum：物品售价下限/上限。
• PreventSellingPluginItems：是否防止玩家出售其他插件的物品（可能与其他插件不兼容）。

商店图标

• ShopIcon.UsePlayerHeads：是否使用玩家头颅作为图标（不推荐，可能导致卡顿）。
• ShopIcon.AllowIconSelection：是否允许玩家自行选择图标。
• ShopIcon.List：可用的图标列表及其所需的权限或商店槽位数量。

声音

• Sound.PlayerPurchasedFromYou：当有玩家从你的商店购买物品时播放的声音。格式：<声音名称>:<音量>:<音高>。设为 '' 可关闭。

告示牌

• Signs.Enabled：是否启用告示牌功能。
• Signs.PlayerShopText：指向单个玩家商店的告示牌首行文本。
• Signs.ShopListingText：指向商店列表的告示牌首行文本。