HereShoppy

插件

· 作者 Merlointhesky

一个 Paper 服务器插件,添加了一个商店,需要越来越频繁地使用它才能解锁新物品!

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

最新 1.2.4 · 26.1.2 · Bukkit / Paper

一键开服(送7天)

HereShoppy

一款适用于 Paper 的综合经济、商店进阶及物品生成插件。

功能特性

  • 集中式经济系统:强大的银行 API(HereshoppyAPI),被其他插件如 HereMobby 所使用。
  • 商店进阶系统:采用二次方等级体系($TotalXP = 5N^2 + 15N$),限制玩家访问更高级别的物品。
  • 动态商店定价:购买价格随所需商店等级提升而增加。附魔每增加一级,物品价值提高 10%。
  • 交互式搜索与过滤面板:点击搜索铁砧以打开一个全面的 54 格箱子 GUI 面板。通过名称查询(通过私聊会话)、首字母(A-Z 选择抽屉)、类别、所需等级范围或可用性动态过滤物品。匹配结果会动态排序(可购买的物品排在前面,锁定预览物品排在后面),提供高端且零经验成本的搜索体验!
  • 发货箱:一种通过标有 [Here Sell!] 的告示牌访问的虚拟销售箱子。每堆叠(stack)出售任何物品获得 1 Kroin(加上附魔加成)。
  • 分类销售:物品和价格在 sales/ 目录内的 YAML 文件中定义。
  • 预览 gated 物品:可以在其所属类别中直接预览超出当前等级的物品。搜索结果也会列出所有匹配项,将可购买的物品排在最前,紧接着是锁定预览物品。

依赖要求

  • Paper 1.21+ (插件 api-version: '1.21'; 基于 Paper 1.21.4 API 构建)
  • Java 21

设置与使用

发货箱(销售箱)

发货箱允许玩家以固定价格批量出售物品。

虚拟发货箱

  1. 在任何方块上放置一个 告示牌。
  2. 在 第一行 写上 [Here Sell!](正面或背面均可)。
  3. 右键点击 告示牌以打开虚拟 GUI。
  4. 放入物品并 关闭界面 即可收到付款。

物理发货箱(自动化)

  1. 在 箱子、 barrel 或其他容器 上放置一个 告示牌。
  2. 在 第一行 写上 [Here Sell!]。
  3. 放入此容器的任何物品(由玩家、漏斗或其他插件如 HereCroppy 放入)将每 5 秒自动出售一次。
  4. 所有权:放置告示牌的玩家将获得付款。

定价:每堆叠/格子 1 Kroin + 每级附魔额外 10% 奖励。

命令与权限

命令 描述 权限
/hereshoppy shop (或 /hs shop, /shop) 打开分层商店 GUI hereshoppy.use
/hereshoppy info (或 /hs info) 查看经济统计数据和排行榜 hereshoppy.use
/hereshoppy reload (或 /hs reload) 重新加载配置文件 hereshoppy.admin

配置

销售数据 (sales/)

将物品组织到各个类别中(例如 weapons_and_shields.yml)。 示例条目:

DIAMOND_SWORD:
  material: DIAMOND_SWORD
  required_shop_level: 20

玩家数据 (data/players.yml)

存储所有玩家的余额、经验和等级。

开发者 API

插件可以通过 com.hereshoppy.hereshoppy.api.HereshoppyAPI 与经济系统进行交互:

  • getKroins(UUID uuid)
  • addKroins(UUID uuid, double amount)
  • removeKroins(UUID uuid, double amount)
  • getLevel(UUID uuid)

近期更改 (v1.2.4)

  • 现代物品目录同步 — 使商店目录与最新的 Minecraft 功能(1.21 Tricky Trials 及 26.1 "Tiny Takeover" 视觉/QoL 更新)保持同步,在生物掉落物类别中引入了 风弹 (WIND_CHARGE),在花类别中引入了能阻止生长的 金盏花 (GOLDEN_DANDELION)。
  • 强大的自动合并配置 — 内置的自动同步机制会在插件启动时检测缺失的默认物品,并将其安全地合并到现有的服务器配置文件中,从而保留自定义的经济余额。

之前的更改 (v1.2.2)

  • 搜索与过滤面板 GUI — 用全面且高度互动的 54 格箱子 GUI 取代了虚拟铁砧搜索 GUI。
  • 动态多条件过滤器 — 实现了并发过滤功能,使用指南针(私聊名称搜索)、纸(A-Z 首字母选择抽屉)、箱子(类别循环)、经验瓶(等级范围循环:1-20, 21-50, 51-80, 81-100)和拉杆(可用性循环:可购买 vs 锁定)。
  • 私聊捕获会话 — 在聊天中私密捕获玩家名称查询,取消聊天事件以防止广播,然后无缝重新打开面板。
  • 基于会话的状态管理 — 利用与库存持有者关联的非持久性基于会话的状态跟踪器,防止服务器内存泄漏。

更早的更改 (v1.2.1)

  • 铁砧搜索 GUI 集成 — 用自定义虚拟铁砧输入 GUI 取代了传统的基于聊天的搜索提示。输入的搜索词被原生捕获,并以零经验成本进行处理。

  • 深层递归合并 — 用递归深度合并系统取代了扁平键合并工具。新引入的默认物品和属性字段会无缝合并到现有的服务器 .yml 配置中,不会覆盖管理员的自定义编辑或被跳过。

  • 智能搜索匹配与预览排序 — 重构搜索结果以跨键、材质、药水及附魔返回匹配项。现在匹配结果将可购买的物品排在最前,随后是锁定预览物品,提供清晰且沉浸式的视觉反馈。

  • PersistentDataContainer 唯一键重构 — 解决了 Spigot 的一个限制:在商店注册表中,共享相同 Material 类型(如药水与书籍)的多个物品会相互覆盖。现在通过 NamespacedKey "shop_item_key" 为 GUI 物品打上标签,以实现稳健的点击购买解析。

  • 大量药水目录 — 添加了详尽的药水类型选择(标准 3 分钟、延长 8 分钟、强力 II),包括 1.21 试炼 chambers 的效果(第 80 级的受侵染与黏液;第 90 级的编织与充风),统一归入 potions 分类下。

  • 附魔书专区 — 新增了一个合并的单类附魔书分类,涵盖从基础 20 级实用附魔到 99 级战锤试炼附魔(风爆 III),并在 GUI 中以高级罗马数字显示名称呈现。

  • 排除项 — 明确将龙蛋和音乐唱片排除在商店之外,以保留探索激励。

版本

当前发布:1.2.4

许可协议

本资源依据 GNU GPLv3 许可证授权。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源