Genius Shop

A modern, data-driven economy shop plugin for Bukkit/Spigot/Paper/Purpur with GUI menus, dynamic pricing, stock limits and resets, localization, and a built-in web editor.

View Changelog

Features

Flexible Shop System

• Data-driven shops: create unlimited shop files in shops/
• Buy and sell support with per-item buy/sell control
• Permission-based access for shops and individual items
• Multi-page GUI support with slot-based item placement
• Time-restricted shops/items with readable schedule output
• Dynamic pricing with min/max bounds and price-change rules
• Player limits and global stock limits
• Stock reset automation: daily, hourly, minute interval, second interval, weekly, monthly, yearly, once
• Shop-level and item-level stock behavior controls:
  • sell-adds-to-stock
  • allow-sell-stock-overflow
• Item requirement guards for selling (name/lore checks)
• Unstable TNT support
• Full support for potions, tipped arrows, spawners, and custom enchantments

Modern GUI and Formatting

• Main menu + shop + purchase + sell + bulk sell interfaces
• Rich formatting with legacy colors, HEX, and gradients
• Multi-stop gradient support (<gradient:#A:#B:#C>...</gradient>)
• Proper legacy style compatibility inside gradients (e.g. &l)
• Configurable lore-format pipeline in menus/gui-settings.yml
• New lore placeholders:
  • %global-limit%
  • %player-limit%
  • %stock-reset-timer%
• Per-item display toggles:
  • show-stock
  • show-stock-reset-timer
• Live GUI updates while open for stock/price/lore changes

Web Editor

• Real-time visual editing and live Minecraft-style preview
• Main menu editor + shop/item editor + GUI settings editor
• Section toggles for lore, enchantments, commands, limits, and available-times
• run-as dropdown support for command execution context (player/console)
• Safer language/preview behavior and improved history UX
• Secure login flow with in-game confirmation for new IPs
• Built-in REST API for remote management

Economy, Integrations, and Runtime

• Vault economy integration
• Optional SmartSpawner integration
• Optional Floodgate/Bedrock compatibility improvements
• Discord webhook transaction notifications
• SQLite runtime storage (data.db) with legacy data.yml migration
• Update checks and in-game update notifications with configurable sound
• Permission-aware /shop tab completion
• Commands:
  • /shop
  • /shop reload
  • /shop editor
  • /shop confirmlogin <token>
  • /shop wiki
  • /shop resetstock all|shop|item

Developer API

• Public API for opening menus and querying shop data
• Custom events for shop open, buy, sell, and transactions

Requirements

• Minecraft: 1.21+ (Bukkit, Spigot, Paper, Purpur)
• Java: 21+
• Vault: required
• Economy plugin: any Vault-compatible economy provider (e.g. EssentialsX)

Dependencies

Required

• Vault
  • Spigot: https://www.spigotmc.org/resources/vault.34315/
• Economy plugin (Vault-compatible, choose one)
  • EssentialsX (Spigot): https://www.spigotmc.org/resources/essentialsx.9089/
  • EssentialsX (Modrinth): /plugins/essentialsx

Optional

• SmartSpawner (for advanced spawner item integration)
  • Modrinth: /plugins/smartspawner
• Floodgate (for Bedrock support improvements)
  • Modrinth: /plugins/floodgate

Quick Start

1. Install Vault and an economy plugin
2. Drop Shop-x.x.x.jar into your plugins folder
3. Start the server
4. Configure shops in plugins/Genius-Shop/shops/
5. Configure menus in plugins/Genius-Shop/menus/
6. (Optional) enable web editor API in config.yml
7. Run /shop reload
8. Use /shop in game

Configuration

• Shop files: plugins/Genius-Shop/shops/*.yml
• Menu files: plugins/Genius-Shop/menus/*.yml
• Languages: plugins/Genius-Shop/languages/*.yml
• Web editor/API settings: config.yml

For detailed schema and examples, see:

• wiki/Configuration.md
• wiki/Examples.md

Permissions

• geniusshop.use - open and use shops
• geniusshop.sell - use bulk sell
• geniusshop.reload - reload plugin config
• geniusshop.resetstock - run stock reset commands
• geniusshop.wiki - access /shop wiki
• geniusshop.admin - full admin access
• geniusshop.login.ip.bypass - approve web-editor IP bypass flow

Data Storage

• Runtime counters and state: plugins/GeniusShop/data.db (SQLite)
• Legacy migration: data.yml migrates automatically on startup

BStats

!BStats Metrics