RelishEconomy

Version 1.2.1-Beta (October 15, 2026)

Added

- Configurable MySQL connection pool — HikariCP maximum-pool-size, max-lifetime, and an optional connection-test-query are now in config.yml under database.pool. Other pool settings use optimal hardcoded defaults. Fixes Failed to validate connection ... No operations allowed after connection closed by retiring connections before MySQL/proxies close them.

Fixed

- Item price lore not removed when disabled — leftover price lore on existing items is now stripped from player inventories when the item-price-lore feature is turned off (on join, startup, and /re reload). No gameplay overhead: stripping only runs at those moments, never on every pickup/craft.

Version 1.2.0-Beta (September 24, 2026)

Fixed

- Exchange rate loading on restart — fixed initialization order bug, added persistent on-disk rate cache, plus 8-attempt retry + lazy recovery so rates always populate even if config loading transiently fails. No more manual /re reload required after restart. - TPS drops during money grants — blocking database/file I/O no longer runs on the shared common pool; all database operations now use a dedicated bounded plugin thread pool. - Admin command logging stall — file writes and transaction inserts now run asynchronously on the plugin executor; no more main-thread stall when admin commands trigger logging. - Offline grant save spam — offline balance operations (add/set/subtract/clear) now respect the 30-second batched save window (same as online operations), reducing database write pressure on burst loads.

Improved

- Dedicated async executor (2–8 named daemon threads, CPU-sized) initialized first on plugin enable, shut down gracefully on disable. - Exchange rate storage now thread-safe and cached for faster repeat lookups, with invalidation on reload. - Every async failure path now logs SEVERE context (player/currency/type) instead of silently swallowing errors. - Transaction logging streamlined — optimized call paths avoid duplicate account lookups; original signatures preserved for backward compatibility.

Version 1.1.9-Beta (September 13, 2026)

Fixed

- Physical withdrawal duplication — fixed /re withdraw adding the requested physical currency twice when it merged into an existing inventory stack. - Rapid consecutive withdrawals — balance validation and subtraction are now serialized so back-to-back withdrawals cannot both use the same pre-withdrawal balance.

Version 1.1.8-Beta (August 4, 2026)

Added

- Item price lore — configurable sell/buy prices shown on item lore (item-price-lore in config.yml). - Updates on pickup/craft by default; optional join and inventory-open refresh. - PDC version markers avoid re-processing items that already have current lore. - Skips physical currency items and optionally skips custom-meta items. - Anti-arbitrage pricing — recipe-aware sell price caps so craft/smelt outputs cannot sell above ingredient value (anti-arbitrage in prices.yml). - Default max-craft-sell-ratio: 0.95 keeps craft-and-sell at a small loss. - Blocks buy → craft → sell profit loops when buy uses the shop multiplier. - Auto-fill missing sell prices — any Minecraft item missing from prices.yml gets a default sell price (auto-fill-missing in prices.yml), with bedrock/command blocks/spawn eggs excluded by default.

Improved

- Sell price lookup uses EnumMap and a cached blocked-item set for faster isSellable() checks. - Item price lore settings are cached and refreshed on /re reload (no per-pickup config reads). - Shop/Sell GUI player sessions are cleared on disconnect to prevent session map leaks. - Removed duplicate stripped wood price entries from bundled prices.yml.

Configuration

- New config.yml section: item-price-lore.* (config version 4) - New prices.yml sections: auto-fill-missing.*, anti-arbitrage.*

Version 1.1.7-Beta (July 21, 2026)

Added Premium

- Personal Vault — a password-protected physical currency chest. Right-click a Vault block to open. Requires premium license. - PIN entry via a click-based keypad using custom numbered player-head skulls. - Native vault block sounds: activate, unlock, wrong-pin, eject, close. - Craftable via configurable shape + ingredients recipe (default: 8× netherite ingot + 1× chest). - Data stored in vaults.yml with async writes. - Developer API to check or modify vault balances, set or verify passwords, and check password status. - GUI fully configurable in gui.yml (vault-gui, vault-password-gui). Settings and crafting stay in config.yml. - Vault hologram — when a player looks at a vault block (within 5 blocks), a floating TextDisplay hologram appears above it showing the stored currency balance(s) in the format {color}{symbol} {name}: {amount}. Disappears immediately when the player stops looking at it. Toggled via vault.show-hologram in config.yml. - Vault item lore balance — after depositing or withdrawing from the vault, the vault block item in the owner's inventory is updated to show current stored balance(s) below a separator line.

Fixed

- Shop purchase GUI improvements: - Purchase GUI now stays open when player inventory is not full, allowing spam-click purchases until inventory fills - Fixed bug where items were incorrectly removed from player inventory when purchase failed due to full inventory space - All GUIs now allow normal player inventory interactions while keeping the GUI itself protected

Added

- HTTP REST API — embedded API server for Discord bots, web panels, and external automation. Disabled by default (rest-api.enabled: false). See [REST API docs](RestAPI.md) for full details. - Bearer token auth, 9 endpoints covering balance read/write, currency list, and server status. - Zero extra dependencies — JDK com.sun.net.httpserver only. - External database sync API — for plugins that write directly to the database: - Allows forcing a cache reload on specific player accounts and retrieving the updated balance. - `eco give|take|set all` now applies to all players (online and offline), not just online. - `eco clear <player> [currency]` — zero out one or all balances for any player, including offline. Permission: relish.economy.eco.clear. - `eco info <player> [currency]` — view balances for any player, including offline. Permission: relish.economy.eco.info. - Offline player tab completion — eco, balance, and re logs now suggest offline player names (capped at 500). - `/re give <player> <vault|atm> [amount]` — admin command to give a vault block item or ATM block item to any online player, bypassing crafting. Requires relish.economy.admin. Amount capped at 1–64. If inventory is full, items drop at the player's feet. - Compact currency formatting — large currency values are now automatically shortened with K, M, and B suffixes (e.g. 9.99M instead of 9,993,027) across all balance checks, placeholders, holograms, and GUI displays. - `eco give|take|set|clear online` — wildcard target selector to apply adjustments or clear balances for all currently online players at once. Shows a chat notification to targeted players. - Escape prefixes (`p:` / `player:`) — target exact players whose names conflict with wildcard selectors or currency names (e.g. players named all, online, or dollars) in /eco, /balance, and /pay commands. - Compact tab completion — suggested amount arguments in commands now show shorthand suffixes (e.g. 1k, 10k, 100k, 1m, 1b etc.) for faster input.

Configuration

- New config.yml keys: vault.*, rest-api.* - New config.yml key: vault.show-hologram (boolean, default true) — toggles the hover hologram on vault blocks. - New gui.yml sections: vault-gui, vault-password-gui - New permissions: relish.economy.eco.clear, relish.economy.eco.info, relish.economy.vault.use

Version 1.1.6-Beta (June 14, 2026)

Fixed

- Per-currency exchange toggle: - Fixed currencies.<id>.exchange-enabled not actually disabling exchange for currencies that had it set to false. - Shop purchase inventory check: - Fixed shop purchases adding items to player inventory and only checking for space afterward (now properly checks if inventory can fit items before modifying it). - Added safety rollback to remove any partially added items if inventory check fails (as a fallback).

Version 1.1.5-Beta (June 3, 2026)

Added

- Per-currency exchange toggle: - Added currencies.<id>.exchange-enabled to allow enabling or disabling /exchange for each currency. - Disabled exchange currencies are excluded as both source and target currencies.

Fixed

- Crafting premium prompt: - Normal vanilla crafting no longer shows the physical-currency premium upgrade message in free mode. - Premium access is now checked only when the crafted result is a physical currency item or compacted physical currency.

Version 1.1.4-Beta (April 26, 2026)

Added

- Polish language file (pl.yml) with full key coverage.

Changed

- Natural-source physical currency ownership: - Removed cook/smelt-time rewrite (no more placeholder owners like Cooked). - Conversion now happens when a player actually receives the item (pickup/extract/inventory), so the owner is always the receiving player when ownership is enabled. - Added support for Minecraft 26.1.

Fixed

- Natural-source material preservation: - Fixed an issue where natural-source.materials entries could be converted into the base physical currency material instead of keeping the original material (e.g., ingot/block) and only applying the correct currency value/metadata. - Physical currency items obtained via furnaces/smokers/blast furnaces no longer end up with a non-player owner label.

Version 1.1.3-Beta (April 22, 2026)

Added

- Vanilla-style physical currency compacting/decompacting: - 3x3 crafting (full grid) of physical currency items compresses into ingot/block variants when the vanilla recipe matches. - 1 block/ingot decompacts back to 9 items when the vanilla recipe matches. - Smelting output rewrite for natural-source: - Furnace / blast furnace / smoker results are rewritten into the configured physical currency item when natural-source matches.

Changed

- Currency natural-source conversion: - physical-item.natural-source.materials is now the primary way to configure per-material conversion rates (supports both map and list-of-maps YAML formats). - Removed legacy physical-item.natural-source.value-per-item behavior; fallback now uses the base physical-item.material and physical-item.value-per-item. - Currency owner config: - Replaced physical-item.owner.enabled with physical-item.owner-enabled (old formats are still accepted for compatibility). - Deposit behavior: - Direct held-item deposit now always deposits the full held stack (removed the deposit-all-stacks config toggle).

Fixed

- Language message: - Added top-level unknown and unknown-help keys (keeps /re unknown-subcommand messages working across older/newer key namespaces). - Config cleanliness: - Removed legacy/unused config keys and simplified currency example sections.

Configuration

- physical-item.deposit-all-stacks removed (hardcoded full-stack deposit). - physical-item.compact-materials no longer required for vanilla compact/decompact crafting. - physical-item.natural-source.value-per-item removed (use natural-source.materials instead). - physical-item.owner-enabled replaces physical-item.owner.enabled.

Version 1.1.2-Beta (April 19, 2026)

Added

- Physical currency deposit option: - currencies.<id>.physical-item.deposit-all-stacks: true - When enabled, sneaking + right-click deposits the full held stack instead of only one item. - Safer currency config identity handling: - currencies.<section> no longer has to match the internal currency id. - Added aliases support for safer currency renames and legacy id resolution.

Changed

- ATM GUI layout reworked again for a cleaner no-mode flow: - Removed the ATM mode switch. - Current currency display now doubles as the currency switch control. - Custom amount moved directly under the currency display. - Bottom row simplified to Deposit, Close, Withdraw. - Physical currency owner metadata defaults are enabled again in bundled config. - Deposit-all-stacks config now means the full held stack only, not every matching stack in inventory.

Fixed

- Premium/free gating: - Blocked physical currency compact crafting and natural-source conversion in free mode. - Restored normal vanilla crafting behavior for plain materials while keeping premium-only physical currency crafting restricted. - Physical currency compact crafting: - Corrected stacked ingredient calculation so one craft only consumes one item per occupied slot. - Added reverse compact crafting support for compact physical forms back into base physical forms. - Removed stale deposit tray preview rendering from the final no-mode ATM layout. - Shift-deposit behavior: - Fixed stacked held currency items only depositing one item when configured to deposit the full held stack.

Documentation

- Updated bundled config comments for the new deposit-all-stacks behavior.

Version 1.1.1 (April 13, 2026)

Added

- Premium ATM GUI: - /re atm command - Deposit tray for supported physical currency items - Withdraw flow with currency switching and amount controls - Configurable ATM block interaction via config.yml - Expanded physical currency support: - Custom model data support per currency - Natural-source currency conversion for configured gameplay item sources - Currency items rewritten from the configured physica

Version 1.1.0-Beta (March 17, 2026)

Added

- Per-currency enable/disable toggle: currencies.<name>.enabled (default: true) - Plugin now disables itself during startup if zero currencies are enabled (prevents broken/partial boot states).

Fixed

- Baltop database spam reduction: - Skips invalid/blank UUID rows in the balances table instead of warning per row. - Emits a single throttled warning when invalid rows are detected. - PlaceholderAPI formatting: - %relisheconomy_balance_<currency>_<type>_<style>% now supports the same formatting options as formatted (example: full_plain -> 1,250.00). - Baltop display name fallbacks for virtual/bank accounts: - Uses the stored account name when Bukkit has no player name (reduces Unknown entries). - Vault bank operations persist a friendly display name (Towny town/nation name when resolvable, otherwise bank name).

This release is a large shop/GUI + configuration update, plus expanded physical currency customization and a safer config updater.

Added

- SmartSpawner + Vault economy provider compatibility (SmartSpawner can use RelishEconomy as the economy) - Shop favorites system: - favorites.yml storage - Favorites button in shop GUI and a dedicated Favorites category view - Favorite state messages: shop.favorites.added, shop.favorites.removed - Favorite items can render with a glow effect in the shop list - New purchase flow GUI (Premium): - Clicking an item opens a buy GUI where players can increase/decrease quantity - Confirm purchase, cancel/back returns to the same category page - Favorite toggle from the purchase GUI - Confirm button can show player balance in its lore (configurable in gui.yml) - show-unpriced-items option for shop browsing: - When enabled, items without a configured buy price can be shown as disabled instead of hidden - Physical currency enhancements (per currency): - Optional crafting recipe support - Custom model data support for currency items - More customization options for physical currency item templates (material, name, lore, visual flags) - Improved config restoration/merging (config updater): - Automatically restores missing bundled files: config.yml, shop.yml, prices.yml, gui.yml, lang/en.yml, lang/ar.yml, lang/pt.yml - Merges missing keys into existing YAML without wiping server edits - Automatic backups: <file>-backup-YYYYMMDD-HHMMSS.ext

Changed

- Shop layout and defaults were reworked to match Creative inventory categories more closely (order, grouping, and paging). - Operator/utility category is disabled by default in the bundled shop configuration. - GUI sorting markers are configurable (set active/inactive symbols in gui.yml). - /re reload now reloads GUI config, shop categories, and purchase flow state more reliably. - Placeholder formatting adjustments: - Compact/plain formatted placeholders no longer force currency symbols when using the plain variants (use the symbol-specific placeholder for symbols).

Fixed

- Many "invalid shop item key/material" warnings by hardening material/key parsing and validation for modern Minecraft versions. - Premium command registration and tab-completion reliability after /re reload when license state is active. - PlaceholderAPI rank placeholders no longer degrade to N/A after server uptime (baltop cache refresh + safer fallbacks).

Documentation

- Updated plugin documentation pages to match the current 1.0.9 shop/GUI and currency features. - Updated the repository README.md and docs site pages, and added/embedded screenshots from docs/assets/.

Added

- Added persistent player username storage (player_name) in balances for both SQLite and MySQL. - Added built-in Portuguese language file: lang/pt.yml.

Improvements

- Database name validation now allows any practical name up to 64 chars. Rejects only unsafe cases: empty, leading/trailing spaces, control chars, /, \, or null char. - Added automatic DB migration to create player_name on existing balances tables. - Account load/join flow now refreshes and saves latest player usernames. - Added new schema default key: database.schema.balances.columns.player_name. - Added general performance and database/cache handling optimizations.

Documentation

- Updated README and docs to include Portuguese language support. - Updated database docs to describe stored identity fields (uuid, player_name, discord_id). - Refined README top layout by moving support/store links under the top images. - Improved README screenshot section headings for clearer and more consistent presentation.

Added

- Added hotbar selling command support: - /sellhotbar (alias: /sellhb) - /re sell hotbar (alias: /re sell hb) - Added sold-item hover breakdowns to sell result messages.

Improvements

- Expanded sold-item hover behavior across command and GUI sell flows for more consistent feedback. - Improved command availability handling for feature/license-based registration.

Fixed

- Fixed command unregister behavior that could affect commands that should stay available. - Fixed incorrect/garbled characters in multiple command output messages.

Fixed

- Improved command registration handling for licensed and disabled features. - Improved reload/restart behavior so feature-based commands update more reliably. - General stability improvements around command availability checks.

Fixed

- Towny bank deposit issue where /t deposit <amount> could take player money but town bank stayed at $0. - Updated Towny/Vault economy flow so town bank balances now update correctly after deposits.

Configuration Updates

- Added specific configuration options: - shop.yml -> shop.enabled: true (default) - prices.yml -> sell.enabled: true (default) - Improved config synchronization so missing keys are added while keeping existing values. - No structural config move is required for existing server files.

Config Updater Improvements

- Extended updater coverage beyond config.yml: - shop.yml - prices.yml - gui.yml - lang/*.yml - Preserves existing values and only injects missing keys.

Backup Behavior

- Backup files remain in the same directory as the source file. - Updated backup naming format for clarity: - <name>-backup-YYYYMMDD-HHMMSS.ext - Collision-safe suffixes are appended when needed.

Metrics (bStats)

- Added bStats integration. - Added config toggle: - metrics.enabled: true (default)

Towny + Vault Compatibility

- Added loadbefore: [Towny] in plugin.yml to improve startup ordering - Improved Vault hook reliability: - Checks that Vault is enabled before registering provider - Re-registers safely if already hooked - Added startup retry hook attempts when Vault is late to initialize - Added clearer startup logging for Vault provider registration

Bank Account Support for Town/Nation Economy

- Implemented full Vault bank API behavior for non-player accounts - Added deterministic internal bank account IDs (name-based UUIDs) for stable persistence - Enabled hasBankSupport() for proper Towny bank operations - Added bank operations: - createBank, deleteBank, bankBalance, bankHas, bankDeposit, bankWithdraw - isBankOwner, isBankMember

PlaceholderAPI Improvements

- Fixed player placeholder requests failing for online/new accounts - Improved placeholder parsing and compatibility: - Added leaderboard aliases: leaderboard and top (mapped to baltop) - Added formatted balance aliases via balance_formatted - Improved raw balance output formatting: - Respects currency decimal settings - Uses stable locale formatting for numeric placeholders - Prevented blank leaderboard placeholder outputs on cold cache/invalid positions by returning safe fallback values

Documentation

- Updated docs/PlaceholderAPI.md with new alias placeholders and behavior notes - Updated troubleshooting notes for placeholder account handling

Version 1.0.3-Beta (February 10, 2026)

Documentation

- Complete Documentation Overhaul - Fully updated documentation website - More clear and detailed information - Improved structure and navigation - Enhanced examples and guides - Better coverage of all features

Real-Time Read Behavior

- Background polling checks for external DB changes - Only refreshes full balance data when last_modified changes - Optimal for Discord/Web integrations that update balances out-of-band You need to replace Real-Time Sync with new config

database:
  # Real-time read mode (read from DB when balances change externally)
  # Recommended: true only if you manually edit DB and need instant visibility
  real-time-read: false

---

Version 1.0.2-Beta (January 23, 2026)

Bug Fixes

- New Player Balance - Fixed issue where new players had their balance set instead of added to - Starting balance is now added to existing balance instead of overwriting it - Prevents accidental balance resets for returning players - Maintains proper balance accumulation across sessions

RelishEconomy Changelog

Version 1.0.1-Beta (January 22, 2026)

Major Feature Redistribution

This update significantly restructures the premium/free feature distribution to provide more value in the free version while maintaining premium exclusivity for GUI and advanced features.

New Free Features

- Multi-Currency System - Now available in free version with full support for custom currencies - Currency Exchange - Exchange between different currencies with configurable rates - Advanced Sell Commands - /sellhand and /sellall commands now free for all users - Advanced Transaction Logging - Comprehensive transaction tracking and logging system

Premium-Only Features

- Shop GUI - Interactive shop interface with category browsing - Sell GUI - Drag-and-drop item selling interface - Block Interactions - Shop and sell block functionality - GUI Customization - All GUI-related interactions and customizations - Physical Currency - Withdraw currencies as physical items

Bug Fixes

- Fixed missing message keys for /shop help command - Added comprehensive help messages for shop commands in both English and Arabic