Genius Shop
一个完全通过 Minecraft 菜单运行的可配置经济商店插件!
创建商店、添加物品、配置价格、控制库存,并让玩家使用服务器上的 Vault 经济系统进行购买或出售。商店可以通过 YAML 文件或内置的可视化网页编辑器进行编辑。
Genius Shop 需要 Minecraft 1.21 或更高版本、Java 21、Vault 以及一个兼容 Vault 的经济插件。
安装步骤
- 设置基于 Bukkit 的服务器,如 Paper、Purpur 或 Spigot。推荐使用 Paper。
- 安装 Vault。
- 安装一个兼容 Vault 的经济插件,例如 EssentialsX。
- 从本页下载 Genius Shop。
- 将插件文件放入服务器的
plugins文件夹中。 - 重启服务器。
- 运行
/shop打开商店菜单。
商店数据存储在以下路径:
plugins/Genius-Shop/shops/
菜单布局和消息也可以在生成的配置文件中修改。
主要功能
构建您自己的商店
根据服务器需求创建任意数量的商店和分类。每个商店都可以拥有独立的名称、图标、大小、布局、物品、价格、权限和可用时间表。
物品可以设置为仅购买、仅出售或支持双向交易。
控制价格和库存
使用固定价格或启用动态定价,价格会随买卖行为自动调整。
您还可以配置:
- 全局库存限制
- 玩家购买限制
- 最低和最高价格
- 自动库存重置
- 限时商店和物品
- 基于物品名称和描述(lore)的出售要求
通过浏览器编辑商店
不想通过 YAML 管理所有内容?
运行 /shop editor 生成内置网页编辑器的登录链接。它提供可视化的商店编辑功能和类似 Minecraft 风格的菜单预览。
新的登录位置必须在游戏内确认后才能访问编辑器。
自定义您的菜单
商店菜单、购买确认界面、出售菜单以及批量出售界面均可自定义。
名称和描述支持旧版颜色代码、HEX 颜色、文本样式和多色渐变。
使用 Minecraft 物品数据
Genius Shop 支持标准材料之外的更多类型。商店中可以包含配置好的药水、附魔箭、刷怪笼、附魔、名称、描述以及其他物品数据。
游戏中手持的物品可以导出并导入到网页编辑器中。
与您的服务器连接
Genius Shop 包括对以下功能的支持:
- Vault 经济系统
- Discord 交易通知
- SmartSpawner
- Floodgate
- bStats 统计
- 自动更新检查
- 带有自定义事件的开发者 API
主要命令
/shop— 打开主商店/shop sell— 打开批量出售菜单/shop editor— 生成网页编辑器登录链接/shop exportitem— 导出当前手持的物品/shop reload— 重载 Genius Shop/shop wiki— 打开插件文档/shop validate-prices— 检查已配置的价格/shop resetstock— 重置全局、商店或物品库存
管理命令需要相应的权限或 geniusshop.admin。
常见问题解答
使用 Genius Shop 需要什么?
您需要运行 Java 21 或更高版本的 Minecraft 1.21+ 基于 Bukkit 的服务器。必须安装 Vault 和一个兼容的经济插件。
推荐使用 Paper 或 Purpur,但也支持 Spigot。
Vault 是一个经济插件吗?
不是。Vault 用于将 Genius Shop 连接到您的经济插件。您必须同时安装 Vault 和经济提供商(如 EssentialsX)。
我必须使用网页编辑器吗?
不需要。每个商店都可以通过 YAML 文件直接创建和编辑。网页编辑器是可选的。
我可以创建多个商店吗?
可以。在 plugins/Genius-Shop/shops/ 中添加额外的 YAML 文件即可。每个文件可以包含一个单独的商店或分类。
商店可以要求权限吗?
可以。权限可以分配给整个商店或单个物品。支持自定义节点,例如 rank.vip。
玩家可以出售物品吗?
可以。物品可以配置为仅购买、仅出售或两者皆可。Genius Shop 还包含一个批量出售菜单,可通过 /shop sell 打开。
库存可以自动重置吗?
可以。库存可以在配置的时间间隔后重置,或者按照每日、每周、每月或每年的计划重置。
在哪里可以获得帮助?
在游戏中使用 /shop wiki 打开文档。如果仍然需要帮助,请加入本项目页面链接的支持 Discord。
我发现了一个错误或有一个功能建议
请通过项目的 Issue Tracker 或支持 Discord 报告。请提供您的 Genius Shop 版本、服务器软件、Minecraft 版本以及任何相关的控制台错误信息。
可选集成
- SmartSpawner — 额外的刷怪笼支持
- Floodgate — 改善 Bedrock 玩家的体验
统计数据
Genius Shop 使用 bStats 收集匿名使用统计数据。
Genius Shop
A configurable economy shop that runs entirely through Minecraft menus!
Create shops, add items, configure prices, control stock, and let players buy or sell using your server’s Vault economy. Shops can be edited through YAML files or the included visual web editor.
Genius Shop requires Minecraft 1.21 or newer, Java 21, Vault, and a Vault-compatible economy plugin.
Installation
- Set up a Bukkit-based server such as Paper, Purpur, or Spigot. Paper is recommended.
- Install Vault.
- Install a Vault-compatible economy plugin such as EssentialsX.
- Download Genius Shop from this page.
- Place the plugin file in your server’s
pluginsfolder. - Restart the server.
- Run
/shopto open the shop menu.
Shops are stored in:
plugins/Genius-Shop/shops/
Menu layouts and messages can also be changed in the generated configuration files.
Highlights
Build your own shops
Create as many shops and categories as your server needs. Each shop can have its own name, icon, size, layout, items, prices, permissions, and availability schedule.
Items can be purchased, sold, or configured to support both actions.
Control prices and stock
Use fixed prices or enable dynamic pricing that responds to purchases and sales.
You can also configure:
- Global stock limits
- Player purchase limits
- Minimum and maximum prices
- Automatic stock resets
- Time-restricted shops and items
- Selling requirements based on item names and lore
Edit shops from your browser
Don’t want to manage everything through YAML?
Run /shop editor to generate a login link for the built-in web editor. It provides visual shop editing and a Minecraft-style preview of your menus.
New login locations must be confirmed in game before they can access the editor.
Design your own menus
Shop menus, purchase confirmations, selling menus, and the bulk-selling interface can all be customized.
Names and lore support legacy colour codes, HEX colours, text styles, and multi-colour gradients.
Use Minecraft item data
Genius Shop supports more than standard materials. Shops can contain configured potions, tipped arrows, spawners, enchantments, names, lore, and other item data.
Items held in game can be exported and imported into the web editor.
Connect it to your server
Genius Shop includes support for:
- Vault economies
- Discord transaction notifications
- SmartSpawner
- Floodgate
- bStats metrics
- Automatic update checks
- A developer API with custom events
Main commands
/shop— open the main shop/shop sell— open the bulk-selling menu/shop editor— generate a web editor login link/shop exportitem— export the item you are holding/shop reload— reload Genius Shop/shop wiki— open the plugin wiki/shop validate-prices— check configured prices/shop resetstock— reset global, shop, or item stock
Administrative commands require their corresponding permissions or geniusshop.admin.
Frequently asked questions
What do I need to use Genius Shop?
You need a Minecraft 1.21+ Bukkit-based server running Java 21 or newer. Vault and a compatible economy plugin are required.
Paper or Purpur is recommended, but Spigot is also supported.
Is Vault an economy plugin?
No. Vault connects Genius Shop to your economy plugin. You must install both Vault and an economy provider such as EssentialsX.
Do I have to use the web editor?
No. Every shop can be created and edited directly through YAML files. The web editor is optional.
Can I create multiple shops?
Yes. Add additional YAML files to plugins/Genius-Shop/shops/. Each file can contain a separate shop or category.
Can shops require permissions?
Yes. Permissions can be assigned to entire shops or individual items. Custom nodes such as rank.vip are supported.
Can players sell items?
Yes. Items can be configured as buy-only, sell-only, or both. Genius Shop also includes a bulk-selling menu opened with /shop sell.
Can stock reset automatically?
Yes. Stock can reset after configurable intervals or on daily, weekly, monthly, or yearly schedules.
Where can I get help?
Use /shop wiki in game to open the documentation. If you still need help, join the support Discord linked on this project page.
I found a bug or have a feature request
Please report it through the project’s issue tracker or support Discord. Include your Genius Shop version, server software, Minecraft version, and any relevant console errors.
Optional integrations
- SmartSpawner — additional spawner support
- Floodgate — improvements for Bedrock players
Statistics
Genius Shop uses bStats to collect anonymous usage statistics.
下载 Genius-Shop
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Genius-Shop
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Genius-Shop
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Genius-Shop
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Genius-Shop
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Genius-Shop
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Genius-Shop
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Genius-Shop
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Genius-Shop
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Genius-Shop
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
Genius Shop v1.6.0 - 经济安全、高级定价与 Web 编辑器重构
新增
- 单项价格模式切换(
buy-price-per-item、sell-price-per-item),用于指定价格适用于单个物品还是配置的數量。 - 价格公式规则(
buy-price-formula、sell-price-formula),配备支持数学运算符和函数(min、max、abs、round、floor、ceil、pow)的安全服务端评估器。 - 经济安全保护措施,包括最大交易限额、可选的单价上限、防暴涨保护、每项操作冷却时间以及大额购买二次确认流程。
- 严格的服务端无效值检查(NaN、Infinity、负数)以及针对配置边界的单位下限/上限强制执行。
- 明确的提款/存款失败故障处理机制,生成面向玩家端的错误消息。
- 收费前的库存容量检查;提款后的交付失败现在会触发退款尝试。
- 审计日志记录以及可选的游戏内管理员警报,用于报告经济和防护失败事件,捕获商店键、物品、玩家和总金额。
/shop validate-prices试运行验证命令,用于扫描所有已加载的商店物品以查找风险或无效配置。- 限时促销活动功能(
campaigns.yml),包含物品级窗口键,并在所有 GUI 和 API 查询中对买卖价格应用实时乘数。 - 服务端物品条件,用于强制执行
min-player-level、max-player-level、required-gamemode、allowed-worlds和denied-worlds。 - 使用
variant-key和item-key的物品变体,用于稳定的库存/限制身份,以及可选的组合变体选择菜单。 - Web 编辑器中的全面导出工具(JSON/YAML),支持导出单个物品、商店、完整项目和菜单。
- 支持 JSON/YAML 文件的物品导入,并自动分配 ID。
- Web 编辑器中的克隆操作,可将物品复制到另一个商店或批量克隆到多个商店。
- Web 编辑器中的实时物品预览,带有 parity 模式切换,以准确渲染游戏内的文本标签和格式。
- Web 编辑器 GUI 设置中的经济安全防护面板,用于配置严格、平衡或关闭预设。
- Web 编辑器中的库存分析仪表板(
STOCK选项卡),用于查看追踪的物品、缺货、低库存和填充百分比。 - Web 编辑器中直接的 SQLite 数据管理(
DATA选项卡),用于查看和编辑玩家限制、全局计数和库存重置计时器。 - 专用的数据库 API 端点(
GET、POST、DELETE),用于 Web 编辑器集成。 - 与调试模式集成的调试错误文件日志记录,输出至
debug/error.log。 - 服务端审计日志记录(
activity-log.json)以及 Web 编辑器文件操作的回滚功能。 - 编译后的商店目录和结构化验证,用于报告重复槽位、无效规则和缺失的配置路径。
- 批量出售 GUI(
menus/bulk-sell-menu.yml),用于通过/shop sell命令出售多个已存入的物品。 - 针对多样间隔(分钟、每小时、每天、每周、每月、每年、一次性)的专用库存重置规则,并持久化上次运行跟踪。
- 自定义命令系统(
commands.yml)及 Web 编辑器选项卡,用于配置命令名称、别名、用法、权限和操作。 /shop exportitem [file-name]命令,将手持物品导出为可供编辑器导入的 JSON,保留序列化的物品堆栈数据。- 新功能的具体权限(
geniusshop.validateprices、geniusshop.exportitem、geniusshop.login.ip.bypass)。 - 通过
api.ssl.*配置为 Web 编辑器和 API 提供原生 HTTPS 支持。 /shop confirmlogin <token>命令,用于编辑器登录期间的 IP 确认。- 可选的 Floodgate 检测,用于缩短基岩版玩家的库存标题。
GeniusShopAPI和GeniusShopAPIProvider用于公共集成,以及新的商店打开和交易事件。- 序列化
item-stack支持,用于精确物品交付、出售匹配和玩家头颅纹理保留。 - 扩展的捆绑语言文件、本地化的菜单标题、按钮和诊断输出。
- MIT 许可证、更新的版权信息以及在 README 和 Wiki 中扩展的文档。
variants_demo.yml示例文件以及扩展的weekend_market.yml,展示捆绑定价和活动促销的使用。
更改
- 买卖总价计算现在严格尊重每个物品配置的价格模式。
- 批量出售总价计算现在尊重配置的销售价格模式。
- 商店物品文本标签中的价格行现在动态显示配置物品数量的总价。
- 买卖菜单文本标签现在在自定义物品文本标签内解析库存占位符(
%global-limit%、%player-limit%、%limit%、%stock-reset-timer%)。 - 交易防护价格检查现在将公式驱动的物品价格视为动态防护输入。
- 防暴涨乘数现在在应用动态定价、公式或活动之前,针对配置的基础价格进行评估。
- Web 编辑器完全围绕 Minecraft 库存预览重新设计,具有响应式布局和可折叠侧边栏。
- 用结构化、保留注释的编辑方式替换了 Web 编辑器中脆弱的 YAML 解析。
- Web 编辑器文件导入格式现在根据文件名和内容自动检测。
- 玩家和全局计数器现在采用缓存机制,结合批量 SQLite 写入和定期刷新以优化数据库性能。
- 改进了商店刷新处理和变体库存身份,以在动态价格和限制菜单之间保持一致性。
- 商店导航按钮现在可以使用自定义材质进行配置。
- Web 触发的插件和自定义命令重载现在在主服务器线程上执行。
- SmartSpawner 交付现在利用其原生创建 API,而不是遗留的解决方法,同时支持
SmartSpawner和SmartSpawners插件名称。 - 缺失的语言默认值现在会自动合并,即使现有的语言文件与当前版本匹配也是如此。
已移除
- 购买时的掉落物品溢出行为;如果库存容量不足,插件现在会阻止交易。
- 冗余且未使用的旧版运行时和编辑器代码。
已修复
- 修复了菜单库存持有者错误返回 null 的问题。
- 修复了未经验证即应用附魔元数据的问题。
- 修复了 SmartSpawner 插件查找行为及兼容性问题。
- 修复了 Web 编辑器 UI 问题,包括无法点击的页脚按钮、重复的搜索边框、库存文本溢出、无效的 meta 标签、缺失的图片描述以及冲突的 CSS 覆盖。
- 修复了占位符替换在 Lore 着色之前执行的问题。
- 修复了嵌套配置部分的默认合并逻辑。
- 修复了引号包裹的语言
on键,以防止意外的 YAML 布尔值解释。 - 修复了在编译后的商店目录后续页面中验证库存槽位的问题。
- 修复了在登录和活动会话检查期间对可为空的玩家地址的保护。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧