All Mods Resource Packs Data Packs Shaders Modpacks Plugins
Genius-Shop
Projects / Plugins

Genius-Shop

by dralle • Downloads: 0 • Followers: 0
Install / Download
Description
Gallery
Changelog
Versions

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.

View the changelog

Installation

  1. Set up a Bukkit-based server such as Paper, Purpur, or Spigot. Paper is recommended.
  2. Install Vault.
  3. Install a Vault-compatible economy plugin such as EssentialsX.
  4. Download Genius Shop from this page.
  5. Place the plugin file in your server’s plugins folder.
  6. Restart the server.
  7. Run /shop to 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

Statistics

Genius Shop uses bStats to collect anonymous usage statistics.

bStats Metrics

All Versions

+ Add Version
Name Game version Platforms Published Downloads Actions
26.2 26.1.x 1.21.x
Bukkit Paper Purpur Spigot
9h ago 1
1.21.x
Bukkit Paper Purpur Spigot
9h ago 1
1.21.x
Bukkit Paper Purpur Spigot
9h ago 1
1.21.x
Bukkit Geyser Paper Purpur Spigot
9h ago 1
1.21.x 1.20.x
Bukkit Paper Purpur Spigot
9h ago 1
1.21.x 1.20.x
Bukkit Paper Purpur Spigot
9h ago 1
1.21.x 1.20.x
Bukkit Paper Purpur Spigot
9h ago 1
1.21.x 1.20.x
Bukkit Paper Purpur Spigot
9h ago 1
1.21.x 1.20.x
Bukkit Paper Purpur Spigot
9h ago 1
1.21.x
Bukkit Paper Purpur Spigot
9h ago 1
1.21.x
Bukkit Paper Purpur Spigot
9h ago 1
1.21.x
Bukkit Paper Purpur Spigot
9h ago 1
1.21.x
Bukkit Paper Purpur Spigot
9h ago 1
### Genius Shop v1.6.0 - Economy Safety, Advanced Pricing & Web Editor Overhaul

  • Added**
  • Per-item price mode toggles (buy-price-per-item, sell-price-per-item) to dictate if prices apply to single items or configured amounts.
  • Price formula rules (buy-price-formula, sell-price-formula) featuring a safe server-side evaluator supporting math operators and functions (min, max, abs, round, floor, ceil, pow).
  • Economy safety guards including max transaction limits, optional unit-price caps, anti-spike protections, per-action cooldowns, and a large-purchase double-confirm flow.
  • Strict server-side invalid-value checks (NaN, Infinity, negatives) and unit floor/ceiling enforcement against configured bounds.
  • Explicit fail-safe handling for withdraw/deposit failures, generating player-facing error messages.
  • Inventory capacity checks prior to charging; delivery failures after withdrawal now trigger a refund attempt.
  • Audit logging and optional in-game admin alerts for economy and guard failures, capturing shop key, item, player, and total.
  • /shop validate-prices dry-run validation command to scan all loaded shop items for risky or invalid configurations.
  • Scheduled campaigns feature (campaigns.yml) with item-level window keys and live multipliers applied to buy/sell prices across all GUIs and API lookups.
  • Server-side item conditions to enforce min-player-level, max-player-level, required-gamemode, allowed-worlds, and denied-worlds.
  • Item variants using variant-key and item-key for stable stock/limit identities, along with an optional grouped variant selector menu.
  • Comprehensive export tools in the web editor (JSON/YAML) for individual items, shops, full projects, and menus.
  • Item import support for JSON/YAML files with auto ID assignment.
  • Clone actions in the web editor to copy items to another shop or bulk clone to multiple shops.
  • Live item preview in the web editor with a parity mode toggle to accurately render in-game lore tokens and formatting.
  • Economy safety controls panel in the web editor GUI settings to configure strict, balanced, or off presets.
  • Stock Analytics Dashboard (STOCK tab) in the web editor to view tracked items, out-of-stock, low-stock, and fill percentages.
  • Direct SQLite data management (DATA tab) in the web editor for viewing and editing player limits, global counts, and stock reset timers.
  • Dedicated database API endpoints (GET, POST, DELETE) for web editor integration.
  • Debug error file logging integrated with debug mode, outputting to debug/error.log.
  • Server-side audit logging (activity-log.json) and rollback functionality for web editor file actions.
  • Compiled shop catalogs and structured validation to report duplicate slots, invalid rules, and missing configuration paths.
  • Bulk Sell GUI (menus/bulk-sell-menu.yml) for selling multiple deposited items through the /shop sell command.
  • Dedicated stock reset rules for diverse intervals (minute, hourly, daily, weekly, monthly, yearly, one-time) with persisted last-run tracking.
  • Custom commands system (commands.yml) and web editor tab for configuring command names, aliases, usage, permissions, and actions.
  • /shop exportitem [file-name] command to export the held item as editor-importable JSON, preserving serialized item-stack data.
  • Specific permissions for new features (geniusshop.validateprices, geniusshop.exportitem, geniusshop.login.ip.bypass).
  • Native HTTPS support via api.ssl.* configuration for the web editor and API.
  • /shop confirmlogin <token> command for IP confirmation during editor login.
  • Optional Floodgate detection to shorten inventory titles for Bedrock Edition players.
  • GeniusShopAPI and GeniusShopAPIProvider for public integrations, alongside new shop-open and transaction events.
  • Serialized item-stack support for exact item delivery, sell matching, and player-head texture retention.
  • Expanded bundled language files, localized menu titles, buttons, and diagnostic output.
  • MIT license, updated copyright information, and expanded documentation in the README and wiki.
  • variants_demo.yml example file and an expanded weekend_market.yml demonstrating bundle pricing and campaign usage.

  • Changed**
  • Buy and sell total calculations now strictly respect each item's configured pricing mode.
  • Bulk sell total calculations now respect the configured sell pricing mode.
  • Shop item lore price lines now dynamically show totals for the configured item amount.
  • Buy and sell menu lore now resolves stock placeholders (%global-limit%, %player-limit%, %limit%, %stock-reset-timer%) within custom item lore.
  • Transaction guard pricing checks now treat formula-driven item pricing as dynamic guard input.
  • Anti-spike multipliers now evaluate against the configured base price before dynamic pricing, formulas, or campaigns are applied.
  • Web editor completely redesigned around the Minecraft inventory preview, featuring responsive layouts and a collapsible sidebar.
  • Replaced fragile YAML parsing in the web editor with structured, comment-preserving editing.
  • Web editor file import format is now automatically detected from the file name and content.
  • Player and global counters are now cached with batched SQLite writes and periodic flushing to optimize database performance.
  • Shop refresh handling and variant stock identities were improved to maintain consistency across dynamic price and limit menus.
  • Shop navigation buttons can now be configured with custom materials.
  • Web-triggered plugin and custom-command reloads now execute on the main server thread.
  • SmartSpawner delivery now utilizes its native creation API instead of legacy workarounds, supporting both SmartSpawner and SmartSpawners plugin names.
  • Missing language defaults are now automatically merged, even if an existing language file matches the current version.

  • Removed**
  • Dropped item overflow behavior during purchases; the plugin now blocks the transaction if inventory capacity is insufficient.
  • Redundant and unused legacy runtime and editor code.

  • Fixed**
  • Fixed menu inventory holders incorrectly returning null.
  • Fixed enchantment metadata being applied without prior validation.
  • Fixed SmartSpawner plugin lookup behavior and compatibility.
  • Fixed web editor UI issues including unclickable footer buttons, duplicate search borders, stock text overflow, invalid meta tags, missing image descriptions, and conflicting CSS overrides.
  • Fixed placeholder replacement executing before lore coloring.
  • Fixed default merging logic for nested configuration sections.
  • Fixed quoted language on keys to prevent unintended YAML boolean interpretation.
  • Fixed validation of inventory slots on later pages of compiled shop catalogs.
  • Fixed guarded nullable player addresses during login and active session checks.
Refactor navigation button creation and add material property

Thanks to [urdaknows](https://github.com/urdaknows) for this

# Version 1.6.0-BETA

> **Beta Release Notice**
>
> Genius-Shop 1.6.0 is currently in beta and is not considered a stable production release.
>
> This version contains several major new systems and significant changes to pricing, transactions, item conditions, campaigns, variants, database management, and the web editor. Although the update has been tested, bugs, compatibility issues, and unexpected behavior may still occur.
>
> Please test this version in a development or staging environment before using it on a production server. Make a backup of your plugin files and database before updating.
>
> Feedback is needed before the full 1.6.0 release. Please report:
>
> * Bugs and error messages
> * Pricing or transaction issues
> * Web editor problems
> * Compatibility problems
> * Confusing configuration options
> * Missing functionality or usability improvements
>
> When reporting an issue, include your server version, plugin version, relevant configuration, reproduction steps, and the plugins/Genius-Shop/debug/error.log file when available.
>
> The stable 1.6.0 release will be published after the beta has received sufficient testing and the reported issues have been addressed.

## Added
  • Per-item price mode toggles:
  • buy-price-per-item (true by default)
  • sell-price-per-item (true by default)
  • Debug error file logging for support diagnostics:
  • Added error/exception-only file logger integrated with debug mode.
  • Added config section:
  • debug-error-log.enabled
  • debug-error-log.file
  • Default log output path: plugins/Genius-Shop/debug/error.log (inside plugin data folder).
  • Logger now captures:
  • ConsoleLog.error(...) and ConsoleLog.apiError(...)
  • Plugin SEVERE logger events (including thrown exceptions)
  • Previously raw stack traces in key exception paths (migration/webhook/YAML load/reload/shutdown save)
  • Intended support flow: share debug/error.log with support for deeper analysis.
  • Support for pricing per configured item amount:
  • Buy/sell totals can now be either price * quantity or price * (selectedAmount / configuredAmount).
  • Web editor support:
  • New item fields for Buy Price Mode and Sell Price Mode.
  • YAML parse/export support for the new pricing mode fields.
  • Added Clone to Shop action in item modal (copies item to another shop file with auto slot assignment).
  • Updated clone target selection UX:
  • Clone to Shop now uses a floating single-select picker above the item modal (searchable, scrollable list).
  • Clone to Multiple now uses a floating multi-select picker above the item modal (searchable, scrollable list).
  • Added Clone to Multiple action in item modal (bulk clone to comma-separated shops or all).
  • Added Import Items action for current shop:
  • Supports JSON and YAML file uploads.
  • Appends imported items with auto ID assignment.
  • Optional keep-provided-slot behavior when target slot is free.
  • Added export tools:
  • Export Item action in item modal (JSON).
  • Export action in Shop tab for current shop (YAML/JSON) and current project (JSON).
  • Added menu import/export tools (JSON):
  • Main Menu
  • Purchase Menu
  • Sell Menu
  • Added YAML support for menu import/export (Main Menu, Purchase, Sell).
  • Menu import now supports file upload (JSON/YAML) instead of paste-only input.
  • File import format is now auto-detected (JSON vs YAML) from file name/content, with manual selection as fallback.
  • Added Shop preview parity mode toggle (PARITY: ON/OFF) to switch between:
  • Simplified tooltip preview.
  • Lore-format parity preview that expands GUI lore tokens (%price-line%, %custom-lore%, %global-limit%, %player-limit%, %stock-reset-timer%, hints, and spawner/potion lines).
  • Added parity toggle buttons to Main Menu, Purchase, and Sell tabs.
  • Web editor item modal live preview:
  • Added a side preview box next to the item edit modal.
  • Preview updates live as fields are edited (material, name, amount, prices, lore).
  • Preview now includes advanced item data:
  • Enchantments
  • Commands + run-as + run-command-only
  • Limits (player/global)
  • Dynamic pricing summary
  • Permission/flags/stock reset indicators
  • Added preview visibility toggle (show/hide) in the modal.
  • Added a persistent preview toggle button in the modal form area, so preview can always be shown again after hiding.
  • Grouped modal checkboxes into titled sections for clearer organization.
  • Economy safety guards (server-side):
  • Max transaction value guard (economy-safety.max-transaction-value).
  • Anti-spike pricing rules (economy-safety.anti-spike.*) for base-multiplier and step-change protection.
  • Per-action cooldowns (economy-safety.cooldowns.*) for buy/sell/bulk-sell.
  • Optional large-purchase double-confirm flow (economy-safety.large-purchase-confirmation.*).
  • Safer economy operations with explicit Vault response/error handling and refund attempt on post-withdraw purchase failures.
  • Added strict invalid-value checks before transactions (NaN, Infinity, negative, hard-cap overflow-ish values).
  • Added server-side unit floor/ceiling enforcement against configured min/max bounds for final resolved prices.
  • Added explicit fail-safe handling for withdraw/deposit failures with player-facing error messaging and guarded flow ordering.
  • Added audit logging for guarded/economy failures including reason, shop key, item key/material, player, and total.
  • Added optional in-game admin alerting for guard/economy failures with configurable permission and rate-limiting:
  • economy-safety.admin-alerts.enabled
  • economy-safety.admin-alerts.notify-permission
  • economy-safety.admin-alerts.rate-limit-ms
  • New dry-run validation command:
  • /shop validate-prices
  • Scans all loaded shop items and reports risky/invalid price configurations without changing data.
  • Web editor economy safety controls:
  • Added GUI Settings panel for economy-safety.* status and values.
  • Added presets: STRICT, BALANCED, OFF.
  • Added save integration via dedicated API endpoint (/api/economy-safety).
  • Added regression tests for transaction safety guard behavior:
  • Invalid money value rejection
  • Server-side min/max floor-ceiling enforcement
  • Anti-spike step-change blocking
  • Large purchase two-step confirmation flow
  • Advanced item conditions (mid-size feature):
  • Added server-side condition checks for:
  • min-player-level
  • max-player-level
  • required-gamemode
  • allowed-worlds
  • denied-worlds
  • Conditions are enforced in:
  • Shop item visibility/opening
  • Buy flow
  • Sell flow
  • Bulk sell matching
  • Added web editor fields + YAML parse/export support for these condition keys.
  • Scheduled campaigns (mid-size feature):
  • Added item-level campaign window keys:
  • campaign-enabled
  • campaign-name
  • campaign-start
  • campaign-end
  • campaign-timezone
  • campaign-buy-multiplier
  • campaign-sell-multiplier
  • Campaign multipliers are applied to live buy/sell prices in:
  • Shop GUI display pricing
  • Purchase flow
  • Sell flow
  • Bulk sell flow
  • Best-sell item matching
  • Web editor now supports campaign fields in item modal and YAML parse/export.
  • Stock analytics (mid-size feature, basic dashboard first):
  • Added new web editor STOCK tab dashboard.
  • Added backend API endpoint: GET /api/stock-analytics.
  • Dashboard includes:
  • Global summary cards (tracked items, out-of-stock, low-stock, fill percentage).
  • Shop filter dropdown.
  • Item stock table for stock-limited items (global-limit > 0) with current/limit/remaining/status.
  • Data is aggregated from live shop items + SQLite global stock counts (global_counts in data.db).
  • data.db web editor (mid-size feature):
  • Added new web editor DATA tab for direct SQLite data management.
  • Added backend API endpoints:
  • GET /api/database (read grouped DB rows)
  • POST /api/database (upsert DB row)
  • DELETE /api/database (delete DB row)
  • UI includes easy-to-understand grouped sections:
  • Player Counts (player_counts) for per-player limits
  • Global Counts (global_counts) for shared stock counters
  • Stock Resets (stock_resets) for last-run reset tracking
  • Added row-level actions in the web UI:
  • ADD ROW
  • SAVE
  • DELETE
  • REFRESH
  • Added readable timestamp display for stock reset last_run values and decoded reset id display.
  • Price formula rules (larger system, first phase):
  • Added per-item formula keys:
  • buy-price-formula
  • sell-price-formula
  • Added safe server-side formula evaluator (+, -, *, /, parentheses, unary +/-, functions min, max, abs, round, floor, ceil, pow).
  • Formula variables:
  • base, price, dynamic, dynamic_price
  • global_count, count
  • amount, price_change
  • min_price, max_price
  • limit, global_limit
  • Integrated formula-based pricing into:
  • Shop GUI display prices
  • Purchase flow
  • Sell flow
  • Bulk sell flow
  • Best-sell matching
  • Public API price lookups
  • Web editor support added:
  • Item modal fields for Buy Price Formula / Sell Price Formula
  • YAML parse/export support for formula keys
  • Item variants (larger system, phase 1):
  • Added stable variant identity support in shop item loading:
  • variant-key
  • item-key
  • Added variants expansion in shop loading:
  • Variant entries inherit base item settings.
  • Variant values override inherited values.
  • Variants are materialized as separate runtime ShopItem entries.
  • Runtime unique keys now include variant-key to avoid stock/limit/dynamic-pricing key collisions.
  • Added optional grouped variant selector menu:
  • Set variant-menu: true on a base item with variants to show one main-slot entry.
  • Clicking the entry opens a variant selection inventory for buy/sell.
  • Web editor support added:
  • Item modal fields for item-key and variant-key.
  • YAML parse/export support for item-key and variant-key.
  • Shop item list badges for item/variant keys.
  • Server-side audit + rollback:
  • Web editor file actions are now audited server-side in activity-log.json.
  • Audit entries are automatically written for:
  • File create/update saves
  • File deletions
  • Rollback operations
  • Added API rollback endpoint:
  • POST /api/activity-log/rollback with activity entry id
  • Added API clear endpoint:
  • POST /api/activity-log/clear
  • Web editor history modal now reads from server audit data and performs server-side rollback.

## Changed
  • Buy and sell total calculations now respect each item's selected pricing mode.
  • Bulk sell total calculation now respects the sell pricing mode.
  • Shop item lore price lines now show totals for the configured item amount (for both per-item and per-configured-amount modes).
  • Buy/Sell menu lore now resolves stock placeholders in item/custom lore paths:
  • %global-limit%
  • %player-limit%
  • %limit%
  • %stock-reset-timer%
  • Transaction guard pricing checks now treat formula-driven item pricing as dynamic guard input where applicable.
[1.5.0] Genius-Shop 1.5.0 by dralle on Oct 15, 2026
Download
### 🚀 Genius Shop v1.5.0 - Web Editor, Stock System & Localization Update

This release focuses on usability, flexibility, and live economy behavior with major upgrades to stock handling, placeholders, gradients, and editor workflows.

#### 🌍 Localization & Formatting
  • Multi-language system**: Added languages/ files and configurable language selection.
  • Gradient upgrades**:
  • Full support for multi-stop gradients (e.g. <gradient:#ff0000:#ff3033:#ff6666>...</gradient>).
  • Better compatibility with legacy styles like &l (bold) inside gradients.

#### 📈 Stock, Limits & Economy Improvements
  • Advanced stock reset automation**:
  • Added/reset support for DAILY, HOURLY, MINUTE_INTERVAL, SECOND_INTERVAL, WEEKLY, MONTHLY, YEARLY, ONCE.
  • Improved lifecycle reliability for automatic resets.
  • New stock/limit placeholders**:
  • %stock-reset-timer%
  • %global-limit%
  • %player-limit%
  • Per-item display toggles**:
  • show-stock
  • show-stock-reset-timer
  • Sell-to-stock controls**:
  • Shop-level and item-level toggles for whether selling replenishes stock.
  • Overflow behavior toggles (allow-sell-stock-overflow).

#### 🧩 Web Editor: Major UX Improvements
  • run-as dropdown support** (console/player) for command sections (main menu + item commands).
  • Grouped modal toggles** for lore, enchantments, commands, limits, and available-times sections.
  • Commands section toggle behavior** now properly controls textarea visibility and persistence.

#### 🛠️ Gameplay & Runtime Improvements
  • Permission-aware /shop tab completion**:
  • Suggestions now respect player permissions.
  • Added completion help for resetstock arguments.
  • Live GUI refresh**:
  • Open shop pages now update stock/price/lore in real time.
  • Main menu placeholder**:
  • %latest-update-highlights% new placeholder to show a little snippet of new features for new updates.
  • Command execution context**:
  • Item commands can run as player or console via run-as.

#### 📚 Documentation & Examples
  • Updated wiki pages, and shop examples to reflect new config keys and workflows.
  • Default shop examples now showcase gradients, stock reset rules, stock/lore toggles, and run-as command usage.

  • Compatible with Minecraft 1.21+ and Java 21.**
Qucik fix for **1.4.3-BETA**

### 🌐 Web Editor Localization Improvements
  • Added an embedded English fallback to ensure the editor is always localized, even on first load or when the API is unavailable.
  • Improved language persistence by automatically saving the server’s default language on first visit.
  • Enhanced error handling to guarantee UI responsiveness and language selector availability.
  • Removed translation flicker for a smoother, more better user experience.

### 🧪 v1.4.3-BETA — Test Build

This is a **beta release** for testing new and upcoming functionality.
Bugs may be present. **Back up your data before deploying.**


### ✨ New Features & Improvements

#### 🔮 Custom Enchantment Support
  • Full Compatibility:** Added support for custom enchantments from external plugins and modern Minecraft enchantment keys using the namespace:key format (e.g. excellentenchants:lifesteal).
  • Web Editor Integration:** The Web Editor now preserves enchantment key casing and correctly handles namespaced IDs in item configurations.
  • Improved Resolution:** Introduced a robust resolution system that falls back to legacy Bukkit enchantment names (e.g. DAMAGE_ALL) if a modern key cannot be resolved.


#### 🌍 Advanced Multi-Language System
  • Dynamic Localization:** All messages have been moved to a dedicated languages/ directory for easier translation and customization.
  • 17 Supported Languages:** Full in-game and Web Editor translations added for:
  • English (US & UK)
  • Russian
  • German
  • French
  • Spanish (ES, MX, AR)
  • Portuguese (PT, BR)
  • Turkish
  • Romanian
  • Vietnamese
  • Dutch
  • Finnish
  • Polish
  • Danish
  • Web Editor i18n:** Implemented a complete localization engine for the Web Editor, including automatic translation of buttons, tooltips, and login-related messages.


#### 🧑‍💼 Individual Web Editor Language Selection
  • Per-Admin Preference:** Added a language selector to the Web Editor login page and main dashboard.
  • Persistent Selection:** Language choice is stored locally in the browser, allowing multiple staff members to use different languages simultaneously without affecting global server settings.


#### 🗂️ Shop Item Sorting (Web Editor)
  • Organization Tools:** Added a new **Sort by** dropdown in the shop content view.
  • Multiple Criteria:** Items can now be sorted instantly by **Slot**, **Name**, **Material**, **Buy Price**, **Sell Price**, or **ID**.


#### 📊 bStats Language Tracking
  • Usage Metrics:** Added a custom bStats metric to track which languages are most commonly used by administrators, helping guide future localization priorities.


### 🧪 Beta Build Notice

This is a **beta build** intended for testing upcoming features planned for **v1.5.0**.
As this is a test release, bugs may be present. **Always create backups before use.**


### 📦 Slot-Based Shop Layouts
  • Items now use **absolute slots**, allowing intentional empty spaces within shop GUIs.
  • Rendering logic fully respects slot positions, enabling custom gaps and non-sequential layouts.
  • Backwards Compatible:** Existing shops are automatically migrated with sequential slots on load to ensure a seamless transition.


### 🌐 Web Editor: GUI Settings Tab
  • Added a dedicated **GUI SETTINGS** tab to centralize global GUI configuration.
  • Navigation Buttons:** Configure names and lore for **Back**, **Previous**, and **Next** buttons globally.
  • Lore & Price Display:** Centralized management of buy/sell price formatting and informational hints.


### ✨ Web Editor UX Refinements
  • Slot Editing:** Items can now be repositioned by directly editing the **Slot** field in the item modal.
  • Item List Enhancements:** The Items list now displays each item’s assigned **Page** and **Slot** for improved clarity.

### 🛠️ Changes

  • Added** drag-and-drop support in the Web Editor for faster and more intuitive item management.
  • Fixed** an issue where spawner types could be incorrectly saved when edited via the Web Editor.

[1.4.0] Genius-Shop 1.4.0 by dralle on Oct 15, 2026
Download
### 🚀 Genius Shop v1.4.0 - The Advanced Economy & Shop availability Update

This version transforms the Web Editor into a powerful tool and introduces deep economy controls, advanced time-based shop availability, and item properties.

#### 🎨 Web Editor: Overhaul
  • Undo & Rollback System**: A complete session history log. Revert any change (Created, Updated, or Deleted) with a single click.
  • Dynamic UI Feedback**:
  • Renamed Workflow**: Buttons renamed to **HISTORY**, **RELOAD**, **SAVE TAB**, and **PUBLISH ALL** for logical clarity.
  • Save Summaries**: A new confirmation modal shows exactly which items are being saved and which are deferred.
  • Visual Enhancements**:
  • Preview**: Increased Minecraft GUI preview size for better readability.
  • Status Badges**: Item cards now feature badges for Enchantments, Lore, Dynamic pricing, Limits, and Permissions.
  • Lore Preview**: Live multi-line lore rendering with color support directly on item cards.
  • Search Engine**: New search bar to instantly find items by name or material.

#### 💎 Advanced Economy & Shop Features
  • Advanced Shop Availability**: Restrict shop access to specific times, days of the week, or date ranges (e.g., Monday-Friday, 08:00-22:00, 2024-12-01 to 2024-12-31).
  • Unstable TNT**: Support for primed-on-break TNT items.

  • Dynamic Pricing**: Implemented supply-and-demand logic. Item prices can now automatically shift as players buy and sell.
  • Transaction Limits**: Set per-player trading limits on any shop item to prevent market inflation.
  • Metadata Mastery**: New item flags to enforce exact Name/Lore matches for selling.
  • Special Item Support**:
  • Potion Levels**: Full support for custom potion amplifier levels (1-255).


#### 🛡️ Security & Technical Improvements
  • Auto-Migration**: Configuration files now automatically update to include new keys from latest versions without touching your data.
  • Robust Backend**: Optimized YAML parsing for complex multi-line lore and nested properties.

#### 🛠️ Commands & Permissions
  • NEW /shop confirmlogin <token> - Security confirmation for remote editor access.
  • NEW geniusshop.login.ip.bypass - Permission to use the editor from untrusted IPs.


  • Compatible with Minecraft 1.20.5+ and Java 21.**
[1.3.0] Genius-Shop 1.3.0 by dralle on Oct 15, 2026
Download
### 🌐 Web-Based Configuration Editor
  • Added built-in HTTP server with RESTful API for remote configuration management
  • Implemented live GUI preview with real-time Minecraft texture rendering
  • Added point-and-click interface for rearranging main menu items
  • Integrated visual shop builder for creating and editing shops without YAML knowledge
  • Added secure UUID-based authentication system
  • Implemented auto-save functionality that syncs changes directly to server files


  • Info:* _This is still a work in progress and errors may occur, please take backups before making changes with the web editor_

### 📢 Discord Integration
  • Added Discord webhook support for transaction notifications
  • Implemented purchase event notifications to Discord channels
  • Implemented sell event notifications to Discord channels
  • Added configurable webhook settings in discord.yml

### 📁 Modular Configuration System
  • Shops: Migrated from single shops.yml to individual shop files in shops/ folder
  • Menus: Migrated from gui.yml to individual menu files in menus/ folder
  • Added automatic migration from legacy configuration formats
  • Improved organization and maintainability of shop configurations
  • Added shops/README.md with comprehensive configuration guide

### 🎮 Enhanced Item Support
  • Added full support for potions
  • Added support for tipped arrows with potion effects
  • Added support for trial spawners
  • Implemented enchantment support for all items

[1.2.0] Genius-Shop 1.2.0 by dralle on Oct 15, 2026
Download
This update is one of the biggest yet adding full menu customization, time-restricted shops, dynamic amount buttons, debug logging, navigation improvements, and more.


  • ✨ New Features**

  • 🎛️ 1. Configurable Display Item Position**
  • Purchase/Sell menu display item can now be placed in **any slot (0–53)**.
  • New config option:
``yaml
display-slot: 22
`
  • Supported in both purchase and sell menus.


  • 🧮 2. Dynamic Add/Remove/Set Buttons**
  • Amount buttons are now fully dynamic.
  • Add any number (1, 4, 8, 10, 32, 64, 100…) and the menu handles it automatically.

  • Example:**
`yaml
add:
4:
name: '&aAdd 4'
slot: 33
`


  • 📏 3. Buy/Sell Amount Limits**
  • Prevent infinite/overflow purchases with:
`yaml
max-amount: 2304
`
  • Defaults to **36 stacks**.
  • Applies to all add/set buttons and respects owned items when selling.


  • 🔙 4. Back Buttons Now Return to the Shop**
  • Back/Cancel buttons now return to the **previous shop + page**, not the main menu.
  • Added new placeholders:
  • %shop%
  • %page%

  • All button lore is now fully configurable.


  • ⏰ 5. Time-Restricted Shops**
Create shops that only open during certain:
  • Hours
  • Days
  • Weekends
  • Date ranges
  • Or any combination of these

  • Supported Formats**
  • "13:00-17:00"
  • "1:00PM-5:00PM"
  • "FRIDAY-SUNDAY"
  • "2024-10-01 to 2024-10-31"

  • New Messages**
  • shop-not-available
  • shop-always-available

  • New Placeholder**
  • %available-times%

  • New Config**
  • date-format (custom date formatting)


  • 🧱 7. Main Menu Uses Rows Instead of Size**
More intuitive config:
`yaml
rows: 3
`
Still compatible with old size.


  • 🎨 8. Hide Attributes/Additional Flags for Main Menu**
Main menu items now support:
  • hide-attributes
  • hide-additional

Prevents vanilla tooltips like “When in main hand”.


  • 🐛 9. Full Debug Logging System**
When debug: true, plugin now logs:
  • Shop opening attempts
  • Permission checks
  • Time restriction checks
  • Purchase/sell details (player, item, amount, total price)
  • Success/failure reasons


  • 📝 Example Configurations**

  • Weekend Market Shop**
`yaml
weekend_market:
gui-name: '&d&lWeekend Market'
rows: 4
available-times:
  • "FRIDAY-SUNDAY"
  • "10:00AM-10:00PM"
items:
  • material: DIAMOND_BLOCK
name: '&bDiamond Block'
price: 4500
sell-price: 2250
amount: 1
lore:
  • '&7Weekend special pricing!'
`

  • Main Menu Button**
`yaml
weekend_market:
slot: 22
material: NETHER_STAR
name: '&d&lWeekend Market'
lore:
  • ''
  • '&7Special items at discounted prices!'
  • '&7Available: &e%available-times%'
  • ''
shop-key: weekend_market
hide-attributes: true
`

  • Purchase Menu Customization**
`yaml
gui:
purchase:
display-slot: 22
max-amount: 2304
back:
name: '&9Back'
lore:
  • ''
  • '&7Return to %shop%'
  • '&7Page %page%'
add:
1:
name: '&aAdd 1'
slot: 24
10:
name: '&aAdd 10'
slot: 25
32:
name: '&aAdd 32'
slot: 33
``

[1.1.0] Genius-Shop 1.1.0 by dralle on Oct 15, 2026
Download
  • ✨ New Features**
  • 🔄 **Automatic update checking**
  • The plugin now checks for updates on startup.
  • Sends update notifications to players with the geniusshop.admin permission.
  • The console also receives update alerts.

  • 💰 **Enhanced economy customization**
  • Added new eco configuration options:
  • override-currency-symbol — Overrides the currency symbol provided by Vault economy plugins.
  • fallback-currency-symbol — Used as a backup if economy formatting fails (default: $).

  • 🎛️ **Fully customizable buy & sell menu buttons**
  • Buttons inside the buy and sell menus (confirm, cancel, add/remove amount, set amount) can now:
  • Be moved to **any slot**
  • Use **any material** you choose
  • Allows complete layout customization for purchase and selling menus.

  • 🔧 Changes**
  • 🗂️ Improved config structure in config.yml and gui.yml.
  • 🛒 Buy and sell menus no longer close after confirming purchases or using "sell all".
  • 🚫 Players can no longer open the sell menu for items they do not have.

  • 🐞 Bug Fixes**
  • 📊 Fixed an issue where metrics were not sending correct data.
  • 🧱 Fixed a bug where placing a spawner in survival mode resulted in an empty, untyped spawner.

🌟 Related Projects

Similar modifications and resources you might like

View all →
Shopkeepers Addon
S

Shopkeepers Addon

by _w41k3r

Navigation & Economy » No more searching the shopkeepers marketplace to buy your favorite items.

0
plugin
Auction House Plugin
A

Auction House Plugin

by ElaineQheart

Use /ah to open the auctionHouse.

0
plugin
EssentialsC [1.20.6-26.3+ | Folia Support ]
E

EssentialsC [1.20.6-26.3+ | Folia Support ]

by _GodlyCow

No Legacy Bloat. Folia Support. Maintained. Fully toggable modules !

0
plugin
Donut Orders
D

Donut Orders

by NAIZO

A player-driven buy-order marketplace.

0
plugin
Genius-Shop Icon
Download Genius-Shop
Select game version
Select platform