SmartSpawner

Bug Fixes

• Fixed sell_and_xp_break preventing players from breaking a spawner when its stored items had no sell value (or the sale was cancelled). Breaking a spawner now always succeeds - auto-sell and XP collection remain a best-effort bonus.
• Fixed the configured open_sound not playing when skip_main_gui opens the storage GUI directly.

Compatibility

• Updated EconomyShopGUI integration to API 1.10.1.
• Updated Towny integrations to their latest supported versions.

Features

• Introduced GUI layout API with support for dynamic layouts and buttons.
• Enhanced natural spawner drop chance loading and added configurable open sound for GUI.
• Added global default drop chance configuration for natural spawners.
• Enhanced sell functionality to include experience collection with combined messaging.
• Added comprehensive Vietnamese language support, updated spawner messages, and improved configuration documentation.
• Added Turkish language support across configuration and language files.
• Refactored language file handling and updated metrics integration.
• Refactored GUI button actions and sound configurations to improve overall user experience.

Bug Fixes

• Fixed SuperiorSkyblock2 permission hook integration.

Documentation

• Updated repository references from NighterDevelopment to OpenVdra.

This release expands GUI customization and improves the reliability of spawner management across different server environments.

What's New

• Added support for custom player-head textures on buttons in the main and storage GUIs.
• Custom textures can be applied to navigation, storage, experience, sorting, selling, and other configurable GUI buttons.
• Added a dedicated GUI layout guide with examples for configuring custom textures and conditional button styles.

Improvements

• Improved spawner removal from management menus, including spawners located in unloaded chunks.
• Related menus now close automatically when a spawner is removed, preventing players from interacting with outdated inventories.
• Improved the reliability of stacking and admin management actions while a spawner is being modified or removed.
• Improved nearby-spawner highlight cleanup and session handling.
• Refreshed the documentation website with clearer navigation, updated branding, and improved readability.

Compatibility

• Updated compatibility with newer SimpleClaimSystem releases.
• Updated compatibility with plugins using the latest NightCore release.

Developer API

• Added removeSpawner(String spawnerId) to remove a SmartSpawner by its unique ID.
• Added removeSpawner(Location location) to remove a SmartSpawner at a specific location.
• Both methods return a CompletableFuture<Boolean> and complete after the spawner block and stored data have been removed, including when its chunk must be loaded first.

Fixes

• Fixed the en_US_DonutSMP_v2 language pack not being included under the expected resource path, which caused missing-resource warnings and prevented its language files from loading.
• Prevented overlapping spawner actions from causing inconsistent spawner data.
• Prevented explosions and manual breaking from interfering with spawners already being removed.
• Improved menu behavior when a managed spawner is no longer available.

This release focuses on cleaner customization, improved performance, performance, and server compatibility.

What’s New

• Added configurable drop chances for Smart Spawners and natural spawners.
• Added an option to control sneak-breaking of spawner stacks.
• Added customizable button images for Bedrock Form UI.
• Spawner item names and lore can now be customized per entity.
• Added dedicated language customization for cross-server management GUIs.

Improvements

• Completely redesigned the language system with cleaner formatting, fewer small caps, less duplication, and more consistent messages.
• Improved item processing and overall performance.

Fixes

• Fixed large values loading incorrectly from YAML files.
• Fixed the sell confirmation menu on Folia and Canvas.
• Various stability and consistency fixes.

Important

• Minecraft server versions below 1.21.5 are no longer officially supported.
• Built-in German and Vietnamese language packs have been deprecated.
• Please review custom language and configuration files when updating.

New Features

New /ss set Command

Added a new admin command to quickly update SmartSpawner properties in-game.

Admins can now set:

• Stack size
• Spawn range
• Spawn delay

The command can be used on the spawner the player is looking at, or with exact world coordinates for console/admin use.

New Performance Settings

Added new performance options for loot generation. These settings help large stacked spawners run more smoothly by using a faster calculation method when extremely large amounts of loot are generated.

This is enabled by default and is recommended for most servers.

Improvements

Better Loot Generation Performance

Large spawner stacks now handle loot generation more efficiently, reducing heavy processing during big spawn cycles while keeping results realistic over time.

Improved Item Giving Behavior

The /ss give command now handles full inventories more reliably. If the player does not have enough space, extra items will be dropped safely at their location instead of being lost or handled incorrectly.

Clearer Configuration

The selling configuration has been renamed and reorganized to make it easier to understand.

The old custom_economy section has been replaced with sell_integration, which better describes what the feature is used for.

Compatibility Changes

ExcellentEconomy Support

SmartSpawner now supports ExcellentEconomy for storage selling.

CoinsEngine support has been replaced by ExcellentEconomy.

Shop Integration Updates

ExcellentShop integration has been removed.

Supported shop integrations now include:

• EconomyShopGUI
• EconomyShopGUI Premium
• ShopGUI+
• zShop

Important Notes

• SmartSpawner now requires Java 25 or newer.
• Existing sell-related configuration values are migrated where possible.
• A new permission has been added: smartspawner.command.set.

New Features

• Auto-Sell & XP Claim on Spawner Break Added support for automatically selling items and claiming XP when a spawner is broken. Configuration loading has also been enhanced for better reliability and flexibility.

• Version 26.x Support Updated compatibility to include the latest minecraft version, ensuring SmartSpawner works seamlessly on the most recent Minecraft releases.

Improvements

• Experience Fields Migrated to long Type All experience-related fields have been migrated from int to long, significantly increasing capacity and precision for high-volume or long-running servers.

Bug Fixes

• Fixed: Spawner Disappearing When Surrounded by Blocks Resolved a critical bug where a spawner would vanish if it was completely enclosed by blocks. The fix ensures a valid drop location is always located nearby, even in tight spaces.

• Fixed: Money Stacking Up with GUI Open on Full Storage Resolved an issue where currency would continue accumulating even after the spawner storage was full, as long as the GUI remained open. Money will no longer stack up when storage capacity has been reached.

• Fixed: Drop All Button Dropping Items in Inconsistent Directions The "Drop All" button in the Spawner GUI now drops items in a consistent, predictable direction instead of randomly scattering them.

• Fixed: Placeholder Errors in Some Embeds Not Displaying Information Certain embed messages were failing to resolve placeholders correctly, resulting in missing or blank information. This has been corrected alongside the event logging improvements.

Removed

• RedProtect Integration Removed All RedProtect hooks and related references have been removed from the codebase. If you were relying on RedProtect integration, please consider an alternative region protection solution.

Bug Fixes

• Fixed selling items from spawner occasionally not working as expected.
• Fixed the confirm sell UI in DonutSMP to better match the DonutSMP visual style.

New Features

• Added mob head button to display spawner infos inside Spawner Storage GUI.
• Added new DonutSMP_v2 spawner GUI layout.

Changes

• Renamed language file from DonutSMP to en_US_DonutSMP.
• gui_config.yml entries are now separated into their own respective layout files, making per-layout customization much cleaner.
• Various other language/locale string adjustments - see CHANGELOG.txt for full details.

Removed

• Removed item translation entries from items.yml. Item names are now built via templateKey and rendered client-side for much better performance and full compatibility with all in-game Minecraft translated languages.

Hotfix & compatibility update following v1.6.3

Bug Fixes

• Resolved plugin crash introduced in v1.6.3 when running on Minecraft 1.21.4 and below.
• Fixed hook integration with the Residence protection plugin.
• Enhanced explosion protection logic to correctly handle non-destructive explosions.
  Wind Charge, Breeze Wind Charge, and player mace wind-burst blasts appear in the block list but never actually destroy blocks. Spawner data is now always preserved for these explosion types, regardless of the protect_from_explosions config value.

New Integrations

• Added support for HuskClaims land-claim plugin.
• Added support for SimpleClaimSystem 2.
  (Thanks to Xyness, the plugin author, for the contribution.)

Performance

• Optimized the selling process for improved throughput and transaction security.