### 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.

### 🚀 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.

### 🚀 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.**

### 🌐 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