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
设置与使用
发货箱(销售箱)
发货箱允许玩家以固定价格批量出售物品。
虚拟发货箱
- 在任何方块上放置一个 告示牌。
- 在 第一行 写上
[Here Sell!](正面或背面均可)。
- 右键点击 告示牌以打开虚拟 GUI。
- 放入物品并 关闭界面 即可收到付款。
物理发货箱(自动化)
- 在 箱子、 barrel 或其他容器 上放置一个 告示牌。
- 在 第一行 写上
[Here Sell!]。
- 放入此容器的任何物品(由玩家、漏斗或其他插件如 HereCroppy 放入)将每 5 秒自动出售一次。
- 所有权:放置告示牌的玩家将获得付款。
定价:每堆叠/格子 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 许可证授权。
HereShoppy
A comprehensive economy, shop progression, and item generation plugin for Paper.
Features
- Centralized Economy: A robust Bank API (
HereshoppyAPI) used by other plugins like HereMobby.
- Shop Progression: A quadratic leveling system ($TotalXP = 5N^2 + 15N$) that gates access to higher-tier items.
- Dynamic Shop Pricing: Buy prices scale with the required shop level. Enchantments increase item value by 10% per level.
- Interactive Search & Filter Dashboard: Click the Search anvil to open a comprehensive 54-slot Chest GUI dashboard. Filter items dynamically by name query (via private chat session), starting letter (A-Z selector drawer), category, required level range, or availability. Matches are sorted dynamically (purchasable items first, locked preview items after) for a premium, zero-experience-cost search!
- Shipping Bin: A virtual sales chest accessed via signs labeled
[Here Sell!]. Sell any item for 1 Kroin per stack (plus enchant bonuses).
- Categorized Sales: Items and prices are defined in YAML files within the
sales/ directory.
- Preview Gated Items: View items above your current level right inside their categories as previews. Search results also list all matches, sorting purchasable items first and locked preview items immediately after.
Requirements
- Paper
1.21+ (plugin api-version: '1.21'; built against Paper 1.21.4 API)
- Java
21
Setup & Usage
Shipping Bin (Sales Chest)
The Shipping Bin allows players to sell items in bulk for a flat rate.
Virtual Shipping Bin
- Place a Sign on any block.
- Write
[Here Sell!] on the first line (front or back).
- Right-click the sign to open a virtual GUI.
- Place items inside and close the inventory to receive payment.
Physical Shipping Bin (Automated)
- Place a Sign on a Chest, Barrel, or other Container.
- Write
[Here Sell!] on the first line.
- Any items placed in this container (by players, hoppers, or other plugins like HereCroppy) will be sold automatically every 5 seconds.
- Ownership: The player who placed the sign will receive the payment.
Pricing: 1 Kroin per stack/slot + 10% bonus per enchantment level.
Commands & Permissions
| Command |
Description |
Permission |
/hereshoppy shop (or /hs shop, /shop) |
Open the tiered shop GUI |
hereshoppy.use |
/hereshoppy info (or /hs info) |
View economy stats and leaderboards |
hereshoppy.use |
/hereshoppy reload (or /hs reload) |
Reload configuration files |
hereshoppy.admin |
Configuration
Sales Data (sales/)
Organize items into categories (e.g., weapons_and_shields.yml).
Example entry:
DIAMOND_SWORD:
material: DIAMOND_SWORD
required_shop_level: 20
Player Data (data/players.yml)
Stores balances, XP, and levels for all players.
API for Developers
Plugins can interact with the economy via com.hereshoppy.hereshoppy.api.HereshoppyAPI:
getKroins(UUID uuid)
addKroins(UUID uuid, double amount)
removeKroins(UUID uuid, double amount)
getLevel(UUID uuid)
Recent Changes (v1.2.4)
- Modern Items Catalog Synchronization — Synchronized the shop catalog with the latest Minecraft features (1.21 Tricky Trials & 26.1 "Tiny Takeover" visual/QoL drop), introducing Wind Charge (
WIND_CHARGE) to the mob drops category and the Golden Dandelion (GOLDEN_DANDELION) age-halting flower to the flower category.
- Robust Auto-Merging Configurations — Built-in automated synchronization detects missing default items on plugin startup and safely merges them into existing server configuration files, maintaining custom economy balances.
Previous Changes (v1.2.2)
- Search & Filter Dashboard GUI — Replaced the virtual Anvil search GUI with a comprehensive, highly interactive 54-slot Chest GUI.
- Dynamic Multi-Criteria Filters — Implemented concurrent filtering using Compass (Private Chat Name Search), Paper (A-Z starting letter selector drawer), Chest (Category cycle), Exp Bottle (Level range cycle: 1-20, 21-50, 51-80, 81-100), and Lever (Availability cycle: Purchasable vs Locked).
- Private Chat Capture Session — Captures player name queries privately in chat, cancelling the chat event to prevent broadcasting, then seamlessly re-opens the dashboard.
- Session-Based State Management — Utilizes a non-persistent session-based state tracker associated with the inventory holder, preventing server memory leaks.
Older Changes (v1.2.1)
-
Anvil Search GUI Integration — Replaced the legacy chat-based search prompt with a custom virtual Anvil typing GUI. Typed search terms are captured natively and processed with zero experience cost to the player.
-
Deep Recursive Merging — Replaced the flat key merge utility with a recursive, deep-merge system. Newly introduced default items and property fields are merged seamlessly into existing server .yml configurations without overwriting admin custom edits or being skipped.
-
Smart Search Matching & Preview Sorting — Restructured search results to return matches across keys, materials, potions, and enchants. Matches now sort purchasable items first, followed by locked preview items, providing clear, immersive visual feedback.
-
PersistentDataContainer unique key refactor — Solved a Spigot limitation where multiple items sharing the same Material type (like potions and books) overwrite each other in the shop registry. Tagged GUI items with a NamespacedKey "shop_item_key" for robust click-to-purchase resolution.
-
Massive Potion Catalog — Added an exhaustive selection of potion types (standard 3m, long 8m, strong II) including 1.21 Trial Chamber effects (Infested & Oozing at level 80; Weaving & Wind Charged at level 90) under the single combined potions category.
-
Enchanted Books Section — Added a combined single enchanted book category ranging from basic level 20 utility enchants to level 99 Mace trial enchants (Wind Burst III), presented in the GUI with premium Roman numeral display names.
-
Exclusions — Explicitly kept dragon eggs and music discs out of the shop to preserve exploration incentive.
Version
Current release: 1.2.4
License
Licensed under GNU GPLv3.
评论 0
登录后参与评分
还没有评论,来抢沙发吧