Stonkz v1.4.25

Changes

• Custom Lore: Fully customize market lore via config.yml with new placeholders.
• Multi-Lang: Support for 6 languages (EN, ID, ES, ZH, DE, FR).
• Auto-Migration: Plugin now auto-updates your config.yml keys on update.
• Better Errors: 20+ specific error messages replace generic failures.

Critical Fixes

• Fixed Short Selling math (CFD settlement fix).
• Fixed /sellinv item duplication exploit.
• Fixed lore markers for better custom item support.

• Short Sell Logic Fixed
  Short selling was previously charging the full asset price on close (Asset Style). It has been rewritten to proper CFD (Contract for Difference) logic. You now only pay/receive the PnL difference.
• Item Duplication Patched
  Fixed a critical bug in /sellinv where custom items (e.g. Ruby) sharing a base material (Diamond) could be sold as vanilla items if not explicitly protected.
• Worth Display Fixed
  Inventory item lore now correctly respects the worth_display.format configuration.

Critical Fixes
Worth Display Config Now Works Everywhere

• ignore_custom_model_data - Oraxen/ItemsAdder items now excluded
• ignore_renamed_items - Renamed items properly skip lore
• blacklist - Blacklisted materials excluded
• Fixed in commands, GUIs, and limit orders (10 code paths)

Short Position Profit Fixed

• Players now receive profit when closing profitable shorts
• Previously profit was calculated but never deposited

Bot Defense Config Fixed

• bot_defense.enabled, cooldown_ms, alert_players now properly loaded
• Was previously using hardcoded defaults

Stonkz v1.2.3
Security & Exploit Fixes

• Infinite Money Fix: Resolved an exploit where opening short positions granted immediate cash.
• Offline Scam Fix: Fixed critical bug where funds were withdrawn from offline players.

New Features

• Market Crash Event: Added "The Great Depression" event (50% price drop).
• Indonesian Support: Added full Bahasa Indonesia (id) translation.
• Custom Icons: Support added for
  Code:

  icon_url

  in
  Code:

  items.yml

  .

Maintenance

• Component Restoration: Restored missing
  Code:

  OrderManager

  and
  Code:

  ShortManager

  logic.
• Build Fixes: Resolved compilation errors for smooth release.

Stonkz v1.2.2

New Features

Multi-Language Localization

• Added configurable language system with language setting in config.yml
• Bundled 5 language files with full translations:
  • English (en) - Default
  • Spanish (es) - Español
  • Chinese Simplified (zh) - 简体中文
  • German (de) - Deutsch
  • French (fr) - Français
• Language files located in plugins/Stonkz/lang/ for easy customization
• Supports custom languages - just copy any file and rename it!

Configurable Currency Symbol

• Currency symbol is now configurable in gui.yml under symbols.coin
• Supports MiniMessage format for custom glyphs (e.g., <glyph:shell> for Coins Engine)
• Compatible with multi-currency economy plugins

Configuration

New in config.yml:

Code:

# Language setting
language: "en"  # Options: en, es, zh, de, fr

New in gui.yml:

Code:

symbols:
  coin: "⛃"  # Or use <glyph:shell> for custom currencies

Full Changelog

• Added multi-language localization support
• Added configurable currency symbol with MiniMessage support
• Updated LangManager for dynamic language loading
• Created 5 bundled language translation files
• Fixed all hardcoded currency symbols across GUI menus

Stonkz v1.2.1
Enhanced Configurability & Bug Fixes

Bug Fixes

• Fixed duplicate anti_exploit section in config.yml causing potential config parsing issues
• Added API key validation to cloud push API (security fix)
• Chart range buttons (1h/24h/7d) now actually filter data correctly
• Improved empty state handling in web dashboard chart

New Configuration Options

• Configurable Sound Types - Customize which sounds play for each action (click, buy, sell, success, error, panic, etc.)
• Configurable GUI Materials - Change all GUI materials via gui.yml (19 customizable items)
• Configurable Button Positions - Full slot layout customization for all menus
• Whale Tracking Settings - Configure threshold, display limits, and Discord integration
• Trading Limits - Optional per-player daily transaction and volume limits
• Category Icons - Customize emoji icons for each item category

Config Changes

• config.yml - Added sounds.types, whale_tracking, and trading_limits sections
• gui.yml - Added materials, button_positions, and category_icons sections

Note: All new config options have sensible defaults. Existing configs will continue to work without changes.

v1.2.0: The Wall Street Update

Major Features

Margin Trading & Short Selling

• Short Selling - Players can now profit from falling prices by selling stock they don't own
• Margin Mode Toggle - Switch between "Spot" (Normal) and "Margin" mode in the Trade Menu
• Margin Calls - Positions are automatically liquidated if collateral falls below threshold
• New Command: /stonkz short <item> <amount> - Open short position
• New Permission: stonkz.short (default: true)

Visual Intelligence

• Stock Maps - Generate 2D price history graphs on held maps
• New Command: /stonkz map <item> - Create a map showing price trends
• Trend Arrows - Item lore now shows dynamic trend indicators (/)
• Volatility Symbols - High volatility stocks display special indicators

In-Game GUI Editor

• Drag & Drop - Admins can rearrange Trade Menu layout in-game
• Quick Edit - Shift+Right-click to edit base prices via Anvil GUI
• New Command: /stonkz edit - Toggle Editor Mode
• Persistence - Layout changes saved to gui.yml

Custom Item Plugin Support

• Oraxen Integration - Trade Oraxen custom items using oraxen:item_id prefix
• Nexo Integration - Trade Nexo custom items using nexo:item_id prefix
• ItemsAdder Integration - Trade ItemsAdder items using ia:namespace:id prefix
• Soft Dependencies - Plugin works with or without custom item plugins installed

Audio Polish

• 15+ Premium Sound Effects - Distinct, layered sounds for every action
• Transaction Sounds - Satisfying feedback for buy, sell, and sell all
• Limit Order Sounds - Created, filled, and cancelled sounds
• UI Navigation - Click, page turn, and filter sounds
• Market Events - Panic alerts and recovery sounds
• Margin Trading - Short open, close, and margin call sounds

Cloud Dashboard

• Push to stonkz.space - Send market data to cloud dashboard
• Real-time Updates - Live data from your server
• New Config Options: web.cloud.enabled, server_id, api_key

Configuration

Code:

# New config.yml section
margin_trading:
  enabled: true
  margin_requirement: 0.5      # 50% collateral required
  max_leverage: 1.5            # Liquidation threshold

Bug Fixes

• Fixed potential null pointer in SellHandCommand
• Removed unused imports in PortfolioCommand
• Fixed damaged items being sold to market
• Removed duplicate imports in StonkzAdminCommand

Database

• New table: stonkz_shorts for storing short position data

NEW: Full Custom Item Support

• Custom Item Registry: You can now define custom items in items.yml and add them to the stock market!
• Dynamic IDs: The plugin now uses String IDs instead of Material enums, allowing for infinite item possibilities.
• NBT Strictness: Improved handling of custom item NBT data, ensuring that names, lore, and enchantments are preserved during trading.

GUI & Command Improvements

• Refactored Trade Menu: Fixed critical issues where custom items would not display or trade correctly in the GUI.
• Updated Command Logic: /buy, /sell, /sellhand, and /sellinv now fully support custom item IDs.
• Tab Completion: Improved tab completion for all commands to show available stocks by their IDs.
• Real-time Worth Lore: Fixed issues where lore-based price updates wouldn't apply correctly to custom items.

Security & Stability

• Bot Defense 2.0: Expanded bot defense cooling to more transaction areas to prevent rapid-click exploits.
• Damaged Item Protection: Robust checks to prevent players from selling damaged tools or armor to the market.
• NPE Fixes: Resolved multiple potential NullPointerExceptions in the GUI event handling.

Configuration Changes

• Added items.yml for custom item definitions.
• Updated config.yml structure to support String IDs for stocks.

---

Note: It is recommended to back up your config.yml before updating. If you have any issues, please join our Discord for support!