
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,例如装饰和分页功能
你是这个资源的作者?登录后可认领此资源。
相似资源
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
ExyliaPlugins 的库。
通过对话框或铁砧界面帮助你的 Anthme
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧