hShop

插件

· 作者 hodakazy

一个高度可定制且异常易用的商店插件。

0 本站下载 0 关注 更新于 7 个月前

需要前置:LuckPerms

最新 1.0.0 · 1.21.11 · Bukkit / Paper

一键开服(送7天)

Hshop title image

hShop

一款功能完全可定制的 GUI 商店插件,支持多货币、单物品冷却时间、购买限制以及简洁的装饰系统。


什么是 hShop?

hShop 是一款我开发的商店插件,因为我对那些让简单事情变得复杂的臃肿替代品感到厌倦。它使用基于文件的分类(每个分类对应一个 yml 文件),因此添加新的商店部分就像将新文件放入 categories/ 文件夹一样简单。

每个分类中的每个物品都是完全可配置的:买入价格、卖出价格、冷却时间、每位玩家的限制、货币类型、槽位位置、附魔、标志等。该插件旨在保持代码的可读性和易编辑性。


功能特性

  • 基于文件的分类 - 每个分类都有自己独立的 .yml 文件,只需放入并重新加载即可
  • 双货币支持 - 物品可以使用 Vault 或 hShards 作为货币,支持按物品配置
  • 购买限制 - 限制玩家购买特定物品的次数(重置由管理员控制)
  • 单物品冷却时间 - 为任何单个物品设置秒数单位的冷却时间
  • 确认购买菜单 - 可选的确认界面,在购买生效前进行二次确认
  • 装饰系统 - 通过装饰 yml 文件完全自定义菜单外观,包括填充物、边框布局、导航按钮等
  • 自定义图标槽位 - 将分类图标固定到主菜单的特定槽位,或将其保留在 AUTO 模式
  • 分页功能 - 分类页面自动分页,并支持配置“下一页/上一页”按钮
  • 出售支持 - 玩家可以通过商店 GUI、/sellhand 命令或 /sellall 命令将物品卖回商店
  • 全局出售倍率 - 通过单个配置值在整个服务器上缩放所有出售价格
  • 分类权限控制 - 通过特定的权限节点限制整个分类的访问
  • 音效 - 可配置打开菜单、成功购买、出售失败等操作的音效
  • 交易日志 - 所有的买入和卖出操作都会记录到文件中
  • PlaceholderAPI 支持 - 通过 hShards 集成实现
  • 完全异步安全 - 数据操作不会卡顿你的主线程

依赖要求

依赖项 是否必需
Paper 1.21+ ✅ 必需
Vault ✅ 必需
hShards ⭐ 软依赖(用于 HSHARDS 货币)
PlaceholderAPI ⭐ 软依赖

命令列表

命令 描述 所需权限
/hshop 打开主商店 hshop.use
/hshop <category> 直接打开特定分类 hshop.use
/sellhand 出售你手中拿着的物品 hshop.use
/sellall 出售背包中所有符合条件的物品 hshop.use
/hshopa reload 重新加载插件 hshop.admin
/hshopa toggle shop 开启/关闭商店功能 hshop.admin
/hshopa toggle buy <category> <item> 切换某物品的购买状态 hshop.admin
/hshopa toggle sell <category> <item> 切换某物品的出售状态 hshop.admin
/hshopa createcategory <id> 创建新分类 hshop.admin
/hshopa deletecategory <id> 删除分类 hshop.admin
/hshopa createitem <category> <id> <material> 向分类中添加物品 hshop.admin
/hshopa deleteitem <category> <id> 移除物品 hshop.admin
/hshopa giveitem <player> <category> <item> <amount> 给予玩家商店物品 hshop.admin
/hshopa setprice <category> <item> buy|sell <price> 修改价格 hshop.admin
/hshopa setlimit <category> <item> <limit> 修改购买限制数量 hshop.admin
/hshopa setcooldown <category> <item> <seconds> 修改冷却时间 hshop.admin
/hshopa resetlimit <player> <category> <item> 重置玩家的购买限制计数 hshop.admin
/hshopa resetcooldown <player> <category> <item> 重置玩家的物品冷却时间 hshop.admin
/hshopa info <category> [item] 查看分类或物品详情 hshop.admin

绕过权限

权限节点 效果
hshop.bypass.cooldown 跳过物品购买冷却时间
hshop.bypass.limit 跳过购买数量限制
hshop.bypass.sell 跳过出售限制

分类配置

每个分类位于 plugins/hShop/categories/<name>.yml。以下是一个典型的配置示例:

display-name: "&aWeapons"
icon: DIAMOND_SWORD
icon-slot: AUTO        # 或者像 13 这样的槽位数字
icon-lore:
  - "&7Buy and sell weapons."
  - "&8Items: &7{item_count}"
  - "&eClick to open!"
decoration: default
title: "&8» &a{category_name} &8« &7({page}/{total_pages})"
rows: 6
sort: 1
enabled: true
permission: ""

items:
  diamond_sword:
    name: "&b&lDiamond Sword"
    material: DIAMOND_SWORD
    amount: 1
    slot: AUTO
    currency: VAULT
    lore:
      - "&8Buy: &a{buy_price} {currency}"
      - "&8Sell: &c{sell_price} {currency}"
    buy:
      enabled: true
      price: 250.0
      limit: -1
      cooldown: -1
    sell:
      enabled: true
      price: 100.0

物品描述占位符

这些占位符可以在任何物品的 lore 列表中使用:

占位符 描述
{buy_price} 物品的买入价格
{sell_price} 物品的卖出价格
{currency} 货币显示名称
{currency_type} 货币类型 (VAULT 或 HSHARDS)
{buy_limit} 最大购买限制 (-1 = ∞)
{buy_limit_remaining} 玩家还可以购买的数量
{cooldown_remaining} 剩余的冷却时间
{buy_status} 彩色显示的购买状态
{sell_status} 彩色显示的出售状态

多货币支持

hShop 支持同时使用两种货币。每个物品都可以拥有自己的货币类型,有些物品消耗 Vault 货币,另一些消耗 hShards,它们可以在同一个分类中共存。通过 currency: VAULT 或 currency: HSHARDS 按物品进行设置。

如果服务器上安装了 hShards 插件,集成将是自动的。


与 hShards 完美配合

hShop 与 hShards 搭配使用,为你的服务器提供第二套经济系统。玩家通过出售物品、从管理员处获得或借助利息系统赚取碎片(shards),然后在商店中使用这些碎片购买特殊物品,这些物品的价格以 HSHARDS 而非常规货币计算。


由 hodakazy 的 hPlugins 制作

本插件中使用的词汇灵感来源于 zShop,例如装饰和分页功能

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源