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.

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)

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

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

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