PlayerShop #1 - PlayerShop #1

这是一个用于创建玩家商店箱子的插件，支持自定义合成、全息显示以及基础经济集成。下面整理了它的功能、依赖、安装方式、权限与默认配置内容，便于在插件目录中快速查看。

💡链接

• Discord 支持：Click Here
• 捐赠：click Here
• 作者主页：click Here

⭐插件简介

工作方式

• 通过合成来创建一个玩家商店箱子。
• 可在 config.yml 中进行编辑和自定义。
• 当前没有任何命令。
• 如果你需要帮助，可以加入作者的 Discord。

展示内容

• Hologram
• Place Shop (Java)
• Place Shop (Geyser - Bedrock)
• Sell Items
• Buy Items
• Custom Craft Chest

视频

• Spoiler: Videos

✨依赖

必需依赖

• PacketEvents
• Vault
• A Vault Compatible Economy Plugin

可选软依赖

• Floodgate
• WorldGuard
• 需要在 config.yml 中启用
• PlaceholderAPI

PlaceholderAPI 变量

• %playershop_shop_count%
• %playershop_shop_max%

🎮安装方法

• 仅支持 Spigot、Paper 等服务端。

安装步骤

• 1. 将 PlayerShop.jar 和所需依赖一起放入 plugins 文件夹
• 2. 启动服务器
• 3. 编辑配置文件（如果你需要）
• 4. 如果你在第 3 步修改了配置，请重启服务器

🔧权限

• playershop.use

⭐配置说明

`config.yml`

############################################################
# +------------------------------------------------------+ #
# |                      PlayerShop                      | #
# |     Creator: AG4                                     | #
# |     Website: https://ag4dev.xyz/                     | #
# |     Discord: https://discord.gg/ZehW4qTTkC           | #
# +------------------------------------------------------+ #
############################################################
Enabled-Worlds:
  - 'world'
  - 'shop'

#It is recommended to enable it if you do not use a private world.
#If you disable it, the default chest will be used
Craft:
  Enable: true
  Name: "&c&k* &a&lPlayerShop &c&k*"
  Items-Craft: EMERALD

#Placeholders:
# - {price} for the shop price
# - {item} for the current item name
# - {current-lore} for the current item lore
GUI:
  Title: "&8&l{player} &c&lSHOP &7({price}$)"
  Item:
    Name: "&f{item} &7- &a{price}$"
    Lore:
      - "{current-lore}"
      - ""
      - "&aPrice: &f{price}$"

#It does not work if you have Disable Craft (Please Enable Craft Section to use permission)
# - playershop.use
Permission:
  Enable: false

#Placeholders:
# - {price} for the price
# - {item} for the item name
Hologram:
  Enable: true
  Second-Line: "&a{price}$"

#WorldGuard & WorldEdit plugins required !!!
# Flag Name = playershop
WorldGuard:
  Enable: false

#first give permission to player , playershop.<group>
#If you want no limit set it to 0
Group:
  default: 5
  vip: 10
  mvp: 15

## If you want to disable checking for some variables just delete the variable
## Available variables ->
## > DisplayName
## > Material
## > Lore
## > CustomModelData
BlackListItems:
  FirstExample:
    DisplayName: "&dBarrier"
    Material: "barrier"
    Lore: "&fSome text that will be searched in each line."
    CustomModelData: "0"
  SecondExample:
    Material: "command_block"
    Lore: "&fSome text that will be searched in each line."

#send the plugin link when typing /playershop
#If it is set to false, just OP get the link
Plugin-Link: true

#Check for plugin updates
Update-Check: true

配置要点

• Enabled-Worlds
• 允许启用插件的世界列表：
• 'world'
• 'shop'

• Craft
• 控制玩家商店箱子的合成功能
• Enable: true 表示启用
• Name 为物品显示名称
• Items-Craft: EMERALD 为合成材料

• GUI
• 自定义商店界面标题和物品显示方式
• 可用占位符：

- `{player}`

- `{price}`

- `{item}`

- `{current-lore}`

• Permission
• Enable: false
• 说明中指出：若关闭 Craft，权限功能将不会生效
• 对应权限：

- `playershop.use`

• Hologram
• 控制全息显示
• Enable: true
• 第二行内容为："&a{price}$"

• WorldGuard
• Enable: false
• 需要 WorldGuard 与 WorldEdit
• Flag 名称：

- `playershop`

• Group
• 先给玩家对应权限：

- `playershop.<group>`

• 用于限制每个组可创建的商店数量
• 设置为 0 表示无限制
• 默认示例：

- `default: 5`

- `vip: 10`

- `mvp: 15`

• BlackListItems
• 可用于屏蔽某些物品
• 可检测变量：

- `DisplayName`

- `Material`

- `Lore`

- `CustomModelData`

• 如果想禁用某项检测，直接删除对应变量即可

• Plugin-Link
• 输入 /playershop 时发送插件链接
• 如果设为 false，则只有 OP 能看到链接

• Update-Check
• 检查插件更新

🎮语言文件

`lang.yml`

Broadcast-Purchases: '&aYou got &6{price}$ &afrom the playershop.'
GUI-Price: '&6{price}$'
GUI-Error-Money: '&cYou don''t have enough money'
GUI-Buy: '&aYou purchased the item for &6{price}$'
GUI-Item-Not-Exist-Default: '&cItem not Exist Anymore'
GUI-Inventory-Is-Full: '&cShop container is full'
Price-Setting: '&aPrice set to &6{price}$'
Place-Message: '&6&lPlayerShop placed.'
Break-Message: '&6PlayerShop &cbroken.'
Error-Permission: '&cYou don''t have Permission'
Error-Place: '&cYou cannot place it here'
Error-Place_Max: '&cYou cannot place more then {max} shop'
Error-Place-Merge: '&cYou are not allowed merge playershop'
Error-Place-WorldGuard-Flag: '&cYou are not allowed to place it in this area'
Error-Shop-Not-Ready-Owner: '&cShop is not Ready ( &eShift + right-click&c ) '
Error-Shop-Not-Ready-Default: '&cShop is not Ready'
Error-Price-Enter: '&cPlease Enter Price'
Error-Price-0: '&cYou cannot set price to &60$'
Error-Item-BlackListed: '&cThe item is blacklisted'
Sign-Line2: '&7^^^^^^^^^^^^^^^^'
Sign-Line3: '&aEnter Price'
Sign-Line4: '&6<Price>'
Form-Title: '&ePlayerShop'
Form-Input-1: '&aPrice'
Form-Input-2: '&7Enter Price'
Placeholder_Shop_Count: '&6{count}'
Placeholder_Shop_Max: '&6{count}'
Placeholder_Shop_Unlimited: '&6X'

❓常见说明

• 当前没有命令可用。
• 插件支持 Java 放置商店。
• 插件也提到了 Geyser - Bedrock 放置商店支持。
• 如果你不使用私有世界，配置中建议启用世界限制。
• 若禁用合成功能，将使用默认箱子。
• 如需帮助，请加入作者的 Discord。

✨自定义插件与捐赠

• WANT CUSTOM PLUGINS ? > FIVERR <
• 作者表示会免费持续开发和维护此插件。
• 如果这个插件帮助了你的服务器，并且你愿意通过捐赠一两美元来支持作者，请点击下方的 Donate 按钮。