SmartSpawner

Fixed

• Fixed a crash that could happen when breaking a vanilla spawner that had no mob type set. This no longer throws an error and the spawner now breaks normally.
• Fixed an error that could appear in the console when a Bedrock player (via Floodgate/Geyser) opened a spawner menu or storage on Folia based servers. Menus now open reliably for these players.
• Removed the "Server Version Not Supported" warning message. It was showing up incorrectly on newer supported server versions and is no longer needed.
• Update notifications will no longer mention SmartSpawner2 versions (2.0.0 and above). SmartSpawner2 is a separate product, so 1.x servers will only be notified about relevant 1.x updates.

Added

• Re-added RedProtect support. Spawners inside RedProtect regions now respect region permissions again when opening menus or stacking spawners.

Notes

• This is a maintenance release focused on stability. No configuration changes are required to update.

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.

New Features

/ss near [radius] Command

Added a new command that scans for nearby spawners within a specified radius and highlights them through walls. All discovered spawners are displayed in a dedicated GUI for easy management.

Collect XP Button in Storage GUI

A new Collect XP button has been added directly to the spawner storage GUI, allowing players to collect accumulated experience without opening a separate menu.

Centralized Discord Logging Configuration

Discord logging is now fully configurable through a dedicated discord_logging.yml file. Each embed can be individually customized, giving server administrators complete control over the appearance and content of Discord notifications.

Language Changelog Files

Added language changelog files to make it easier for users to maintain and update their custom language translations across versions.

New API Events

• SpawnerTakeAllEvent - Fired when a player clicks the "Take All" button in the spawner storage GUI.
• SpawnerDropAllEvent - Fired when a player clicks the "Drop All" button in the spawner storage GUI.

Bug Fixes

• SimpleClaimSystem (Paid Version) - Fixed a crash that occurred when using the paid version of SimpleClaimSystem. SmartSpawner now only hooks into the free version of SimpleClaimSystem. (#185)
• Memory Leak in Sell Operation - Fixed a memory leak caused by itemToRemove not being properly cleared during sell operations in the spawner inventory.
• ExcellentShop Sell Prices - Fixed sell prices not being loaded correctly when ExcellentShop is used as the price provider.
• Spawner Loss on Stack Limit Reduction - Fixed a bug where reducing the maximum stack limit would delete spawners that exceeded the new limit. Spawners are now properly preserved when the limit changes.
• Spawner Item Floating Near Bedrock - Fixed an issue where broken spawner items would float upward into a cave pocket above the player when mining near bedrock with no block directly behind the spawner.

Improvements

• Discord Logging Performance - Optimized the Discord logging system to reduce overhead and improve overall server performance when logging is enabled.

Performance

• Improved overall performance between spawners and hoppers, resulting in smoother and more efficient operation.

Bug Fixes

• Fixed an issue in the GUI config where the right-click action could not be changed, now works as expected.
• Fixed a bug where XP could not be collected after clicking "Sell All & Collect XP" when no items were available to sell.
• Fixed broken developer API links in the documentation and bumped the API version to reflect the latest changes (1.6.2).

Performance Improvements

• Optimized sell operation performance to prevent server crashes when processing large quantities of items in spawner storage

Bug Fixes

• Fixed placeholders not updating correctly in storage GUI title when performing actions (page changes, loot spawn, etc.)
• Resolved placeholder formatting issues for: {entity}, {ᴇɴᴛɪᴛʏ} {amount}

Bug Fixes

• Fixed an issue where item spawners with different item types could be incorrectly stacked together
• Fixed wiki link references for mob drops in spawners_settings.yml to point to correct documentation
• Fixed wind charges converting smart spawners to vanilla spawners when protect_from_explosions is disabled
• Fixed NoClassDefFoundError with CoinEngine API
• Fixed unbreakable tools breaking after mining a certain number of spawners

New Features

• Added support for Minecraft 1.21.11
• Added new mob spawners:
  • Parched
  • Camel Husk
  • Nautilus
  • Zombie Nautilus

SmartSpawner - Version 1.5.7.1

Bug Fixes

• Fixed the error causing "zip file closed" on Minecraft 1.21.4.

Updates

• Updated the Developer API with additional methods for modifying and retrieving spawner's stats.
  For more details, visit the SmartSpawner documentation:
  https://nighterdevelopment.github.io/smartspawner-docs/developer-api/api-data-access/

SmartSpawner - Version 1.5.7

Changes

• Removed chunk spawner limiter - This feature has been temporarily removed from the core plugin and will be re-implemented as a separate addon to improve overall performance

Bug Fixes

• Fixed shift-place spawner - Resolved an issue where players would lose their entire stack when shift-placing spawners if the max stack size config was less than 64 items
• Fixed storage item consumption bug - Resolved incorrect item amount when using the "Take All" button in spawner storage
• Fixed race condition exploit - Added lock protection to spawner breaking/mining operations to prevent potential race condition exploits

Performance Improvements

• Optimized storage GUI rendering for better performance
• General performance enhancements to improve plugin efficiency

Note: The chunk spawner limiter will return as a separate addon in a future update with enhanced performance optimizations.

SmartSpawner - Version 1.5.6.2

Critical Dupe Patched

• Fixed item duplication exploit caused by race condition in VirtualInventory synchronization with storage GUI

Technical Details

The exploit involved using two game instances with swarm mode (custom mod) to create a race condition between spawner inventories. This has been completely patched by:

• Synchronizing inventory operations across all connected clients
• Adding transaction verification before committing item changes
• Implementing proper locking mechanisms for concurrent access

All users running v1.5.4.3 or lower should update immediately.

SmartSpawner - Version 1.5.6.1

🐛 Bug Fixes

• Fixed: Possible item duplication issue with "Take All" and "Drop Page" buttons
• Found by: @Raczain (Autism Inc.)

ℹ️ Note

This dupe has not been fully confirmed but has been patched as a precautionary measure. We recommend updating to this version to prevent potential exploits.

SmartSpawner - Version 1.5.6

🎯 What's New

✨ New Feature: Item Spawners

What are Item Spawners?

• New spawner type with the appearance of a specific item in the spawner block
• All the same features as regular spawner spawners (storage, stack, etc.)

📝 Configuration

New Item Spawner Settings File

• Added item_spawners_settings.yml for full control over item spawner behavior
• Customize spawn loots, experience, and other settings
• New command: /ss give item_spawner <player> <item_type> [amount]

🔧 Bug Fixes

Fixed Storage GUI Page Display Issues

• Problem: When you removed items from your spawner storage, the page counter at the top would sometimes show weird placeholders like [{current_page}/{total_pages}] instead of the actual page numbers like [1/1]
• What fixed:
  • Page numbers now always display correctly when you take items out of storage
  • When your spawner generates loot while you have the storage open, the page counter updates properly
  • The GUI title now always shows the right page you're on and total pages available

🛡️ Security & Performance Improvements

Added Anti-Spam Protection for Storage GUI

• What this means: We've added a short cooldown (half a second) between opening and closing your spawner storage
• Why this helps: Prevents issues with cheater try to spam-click or use macros in GUIs
• Your experience: You won't even notice this - it only blocks actions that happen too fast to be intentional

Optimized Storage Title Updates

• What changed: The plugin now only updates the page counter when it actually needs to (like when moving between pages)
• Benefit: Better performance, especially if you have many items in storage

🔌 Developer Features

New API Methods for Custom Spawners

Plugin developers can now create:

• Vanilla Spawners: Natural spawners that spawn mob
• Item Spawners: Special spawners with the appearance of a specific item in the spawner block

📋 Summary

This is a major feature update! We've introduced Item Spawners - a completely new way to use spawners for automatic item generation. Plus, we fixed annoying storage GUI display bugs, added protection against spam-clicking, and improved overall performance.

Upgrade highly recommended: New features + important bug fixes and stability improvements.

SmartSpawner - Version 1.5.5

✨ New Features

Version Support

• Added Minecraft 1.21.10 Support - Full compatibility with latest Minecraft version

New Spawner Config

• Copper Golem Spawner - Added support for Copper Golem spawner in 1.21.10

🐛 Bug Fixes

Spawner Mechanics

• Fixed Cycle Skipping - Resolved issue where spawners would skip a cycle after stack size updates (stacking or destacking)
• Fixed Hopper Integration - Hoppers now continue working correctly after spawner stacking operations
• Fixed Low TPS Issues - Spawners no longer stop spawning loot when server TPS drops
• Spectator Mode Fix - Spectator players can no longer activate spawners

🛡️ Security & Stability

Critical Fixes

• Fixed Item Duplication Exploit - Implemented comprehensive item duplication exploit patch with transaction locking and atomic operations for "Drop All" and "Take All" buttons in spawner storage GUI
• Enhanced Exception Handling - Added exception catching to prevent plugin shutdown when other plugins crash, ensuring SmartSpawner continues to load even if other plugins fail

🎨 Configuration Changes

Placeholder System Update

• New Placeholder Format - Changed from %placeholder% to {placeholder} syntax
• Added Percentage Placeholders - New percentage-based placeholders available in holograms and spawner info buttons

⚠️ Important: You must update your language folder. Backup your current language files and either:

• Delete the language folder to let the plugin regenerate it with new format, or
• Manually update placeholders if using custom language files

Configuration Migration

• Migrated from mob_drops.yml to spawners_settings.yml - Consolidated configuration structure
• Customizable Mob Head Textures - Users can now edit mob head texture displays directly in spawner GUI settings

⚡ Performance Optimizations

Spawner System

• Optimized Range Checking - Significantly improved performance of spawner range detection
• Enhanced GUI Updates - Streamlined spawner GUI view updates with reduced meta calls and improved placeholder handling
• Loot Spawn Optimization - Enhanced loot spawning efficiency with scheduled spawn time tracking and early loot addition

User Experience Improvements

• Accurate Countdown Timer - Spawner delay now counts down correctly from configured time to 00:00 (e.g., 25s → 00:25 to 00:00)
• Smoother GUI Experience - Pre-spawner loot processing for faster, smoother GUI timer performance
• Prewarm Head Texture Cache - Reduced GUI latency by preloading mob head textures

SmartSpawner - Version 1.5.4.3

🔧 Bug Fixes

Fixed Folia Server Errors

• Fixed critical error that caused the plugin to throw errors on Folia servers when checking for ghost spawners
• The plugin now properly works with Folia's multi-threaded system
• Ghost spawner checks are now thread-safe and won't cause server errors

Automatic Ghost Spawner Checks Removed

• Removed automatic ghost spawner cleanup that ran every 5 minutes to improve server performance
• Use /ss clear ghost_spawners command whenever you want to manually clean up ghost spawners

✨ Improvements

Customizable Storage GUI Title

# Before:
gui_title_storage: '&#545454ꜱᴘᴀᴡɴᴇʀ ꜱᴛᴏʀᴀɢᴇ'

# After:
gui_title_storage: '&#545454ꜱᴘᴀᴡɴᴇʀ ꜱᴛᴏʀᴀɢᴇ - [%current_page%/%total_pages%]'

• Storage GUI title is now fully customizable through the language files (gui.yml)
• You can now change current page and total pages information to the storage title

Better Storage GUI Experience

• Fixed page display bug - When taking all items from storage, the page number now updates correctly

Performance Optimizations

• Storage GUI now updates faster and uses less server resources
• Reduced unnecessary operations when browsing through storage pages

SmartSpawner - Version 1.5.4.2

Bug Fixes

Fixed Loot Not Spawning Issue

• Sometimes spawner would skip spawn cycles even though the timer reached zero.

Fixed Total Price Showing $0

• The total price display in the spawner menu would sometimes show $0 even though items were worth money (selling still worked correctly). The display now properly refreshes to show the correct accumulated value.

SmartSpawner - Version 1.5.4.1

Hotfix Release

🐛 Bug Fixes

Fixed timer reaching zero without spawning items

• Resolved an issue where newly created spawners would occasionally fail to spawn items when the timer reached zero
• Only affected spawners created after the previous update
• Existing spawners from earlier versions were not impacted by this bug

📝 Notes

This is a critical hotfix addressing spawn failures in new spawners. If you're experiencing this issue, please update immediately to restore proper functionality.

SmartSpawner - Version 1.5.4

🐛 Bug Fixes

UI & Display

• Fixed %time% placeholder flickering when clicking sell/claim exp on the info button in the spawner menu
• Improved hologram stability - Holograms now properly clean up after server restarts and chunk reloads, preventing ghost holograms from accumulating

Chunk Limit System

• Fixed initialization bug that could affect spawner chunk limits

Third-Party Compatibility

• Updated SuperiorSkyblock2 integration to use better API methods
• Added Residence plugin support for region protection compatibility

✨ New Features

📊 Comprehensive Logging System

A powerful new logging system to track all spawner activities and player interactions:

Core Features:

• Zero Performance Impact - Fully asynchronous with automatic batch writing every 2 seconds
• Flexible Storage - Choose between JSON or human-readable formats with automatic file rotation
• Granular Control - Enable/disable specific events from 21 different event types
• Discord Integration - Beautiful rich embeds with color-coded events and player avatars

What Gets Logged:

• Spawner lifecycle (place, break, explode)
• Stacking operations (hand, GUI, destack)
• GUI interactions (main menu, storage, stacker)
• Economy actions (XP claims, selling items)
• Storage management (take all, drop, sort, filters)
• Commands (player, console, RCON - captures ALL admin actions)
• Entity type changes

Log Output Examples

Human-Readable: (.log)

[2025-10-12 18:30:45] Spawner placed | Player: Steve | Location: world (100, 64, 200) | Entity: ZOMBIE | quantity=1
[2025-10-12 18:31:20] Command executed by player | Player: Admin | command=give full_command=/ss give Steve zombie 5
[2025-10-12 18:32:10] All items taken from storage | Player: Steve | items_taken=64 items_left=0

JSON: (.json)

{"timestamp":"2025-10-12 18:30:45","event_type":"SPAWNER_PLACE","player":"Steve","player_uuid":"069a79f4-44e9-4726-a5be-fca90e38aaf5","location":{"world":"world","x":100,"y":64,"z":200},"entity_type":"ZOMBIE","metadata":{"quantity":1}}
{"timestamp":"2025-10-12 18:31:20","event_type":"COMMAND_EXECUTE_PLAYER","player":"Admin","player_uuid":"069a79f4-44e9-4726-a5be-fca90e38aaf6","metadata":{"command":"give","full_command":"/ss give Steve zombie 5"}}
{"timestamp":"2025-10-12 18:32:10","event_type":"SPAWNER_ITEM_TAKE_ALL","player":"Steve","player_uuid":"069a79f4-44e9-4726-a5be-fca90e38aaf5","location":{"world":"world","x":100,"y":64,"z":200},"entity_type":"ZOMBIE","metadata":{"items_taken":64,"items_left":0}}

Discord Webhook Features:

• 🎨 Color-coded embeds organized by event category
• 👤 Player skin/head thumbnails via https://mc-heads.net/
• ⚙️ Fully customizable titles, descriptions, and fields
• 🛡️ Rate limiting protection (Discord API compliant)
• 🔄 20+ placeholder variables for custom formatting

and more...

Hologram Placeholders

Two new percentage-based placeholders are now available for hologram customization:

• %percentage_storage%% - Displays storage capacity as a percentage (e.g., 75.5%)
• %percentage_exp%% - Displays experience capacity as a percentage (e.g., 50.0%)

New Commands

/ss clear holograms

• Kill all text display holograms from the server
• Useful for cleaning up hologram displays after configuration changes or when holograms get stuck
• Permission: smartspawner.command.clear

/ss clear ghost_spawners

• Automatically detects and removes broken spawners without physical blocks
• Runs asynchronously to prevent server lag
• Provides detailed feedback on the number of spawners cleaned
• Permission: smartspawner.command.clear

Permission Updates

All command permissions now use a consistent .command prefix:

• smartspawner.command.use - Main command access (replaces smartspawner.admin)
• smartspawner.command.reload - Reload configuration
• smartspawner.command.give - Give spawners to players
• smartspawner.command.list - Access spawner list admin
• smartspawner.command.hologram - Toggle holograms
• smartspawner.command.prices - View spawner prices
• smartspawner.command.clear - Clear holograms and ghost spawners

Configuration Updates

• Updated mob_drops.yml - All mob drop rates have been corrected based on official Minecraft Wiki data. We recommend updating your configuration file to benefit from these accuracy improvements.

⚡ Performance Improvements

This update includes significant performance optimizations:

• Improved spawner range checking - Now runs most calculations efficiently and asynchronously
• Reduced server load - Optimized entity spawning process to use fewer resources
• Better memory usage - Spawners now handle entity creation more efficiently, reducing memory allocation
• Faster chunk operations - Optimized how the plugin interacts with world data

These changes should result in smoother gameplay, especially on servers with many spawners.

Important: If you're upgrading from an older version, please review the permission changes and update your permission plugin accordingly. The new logging system is enabled by default but can be disabled in the configuration.

SmartSpawner - Version 1.5.3

🎉 New Features

Integration Support

• PlotSquared Integration: Added full support for PlotSquared, enabling seamless spawner management within plots
• BentoBox Integration: Restored BentoBox compatibility for skyblock and island-based gameplay
• Floodgate Integration: Implemented spawner main menu form UI for Floodgate, providing native support for Bedrock Edition players

GUI Enhancements

• Items Layout Sorter: Introduced a new items layout sorter for the spawner storage GUI, replacing the previous discard item system for better inventory management

• Real-time Sell Value Display: Added %total_sell_price% placeholder to spawner GUIs, allowing players to view the total sell value of their spawners in real-time

Localization

• German Translation: Added complete German (de_DE) language support

🔧 Improvements

Performance Optimizations

• Sell Value Calculation: Optimized sell value accumulation for sale items, significantly improving performance when processing large spawner inventories

Code Quality

• Localization Refactor: Refactored and standardized localization system across all language files for better maintainability and consistency

SmartSpawner - Version 1.5.2

Changes

• Enhanced GUI configuration for price management
• Cleaned up unused and deprecated code
• Fix spawner duping exploit: implemented tracking and force-closing mechanisms for filter GUI viewers
• Improved overall system stability and performance

SmartSpawner - Version 1.5.1

Removed

• BentoBox integration has been fully removed (all related hooks/features are no longer available).

Fixed

• Hardened selling flow with pre-deposit validation to block dupe selling.
• Added state validation in FilterConfigUI to prevent navigation exploits.

Changed

• Updated default Spawner Storage GUI and Filter GUI layouts (big thanks to @xoop).
• Updated several language files for clarity and consistency.

Added

• Improved layout configuration system:
  • Add an option to change GUI layout for the Main Spawner GUI.
  • Customize layout, button slots, conditions, and click actions.
  • Added button conditions for the Spawner Storage GUI.

Upgrade Notes

• Config/Layout

  • If you rely on custom GUI layouts, review and migrate to the new layout configuration for the Main Spawner GUI.

• Languages

  • Review updated language files. If you maintain custom translations, merge changes to prevent missing keys.

SmartSpawner - Version 1.5.0

🚀 Major Changes

• Dropped support for Minecraft 1.20 - Plugin now requires newer versions (1.21+)
• Migrated to Paper Plugin system with modern Brigadier command framework for better performance and compatibility~~~~
• Support RemoteConsole (RCON) execution for all commands from plugin
• New Prices Command & GUI - Added GUI for viewing spawner item sell prices by shop/custom prices (/ss prices)

🔧 Core Improvements

• Enhanced Spawner list GUI
  • Sort order now displays in descending order
  • Add new admin features: remove spawner, increase stack size, open spawner GUI in admin view, teleport to spawner
• Improved Timer Display - Spawner info now uses %time% placeholder for dynamic updates with better performance
• Enhanced Reload Command - Now properly loads config (range,min-mobs,max-mobs,..) for existing spawners in the world

🐛 Bug Fixes

• Fixed shift-click spawner placement - No longer consumes spawner items when placing in restricted regions (from third-party plugin support)
• Fixed BentoBox integration - Resolved issue where spawners were blocked even outside of islands
• Fixed IridiumSkyblock integration - Removed debug messages spam
• Fixed spawner experience preservation - XP no longer incorrectly persists after server restart

🔒 Critical Security Fix

🚨 MANDATORY UPDATE - Spawner Duplication Exploit Patched

• Issue: Critical vulnerability allowed cheaters and hackers to duplicate spawners using GUI packet manipulation and load/save state exploits
• Root Cause: SpawnerStackerHandler.handleStackDecrease() didn't validate spawner block existence before destacking
• Solution: Added comprehensive ghost spawner validation and packet state verification before processing any destacking operations

⚠️ ALL USERS MUST UPDATE to prevent exploitation of this duplication bug.

📋 Update Checklist

Before updating, ensure you:

• Verify server version - Ensure your server is running Minecraft 1.21 to 1.21.8 (older versions are no longer supported)
• Update mob_drops.yml - Change all potion_effect: sections to potion_type: for TIPPED_ARROW items (see format example below) Old:

    TIPPED_ARROW:
      amount: 0-2
      chance: 50.0
      potion_effect:
        type: SLOWNESS
        extended: false
        upgraded: false

New:

    TIPPED_ARROW:
      amount: 0-2
      chance: 50.0
      potion_type: SLOWNESS

• Update lang folder - Re-download or manually add %time% placeholder support to your language files for spawner timer display (next spawn) New:

spawner_info_item:
  name: '&#ab7afd%ᴇɴᴛɪᴛʏ% ꜱᴘᴀᴡɴᴇʀ'
  lore:
    - ''
    - '&#7b68ee◈ &#8a2be2ɪɴꜰᴏʀᴍᴀᴛɪᴏɴ:'
    - '  &#e6e6fa•  ꜱᴛᴀᴄᴋ: &#c2a8fc%stack_size%'
    - '  &#e6e6fa•  ʀᴀɴɢᴇ: &#c2a8fc%range%&#e6e6fa ʙʟᴏᴄᴋꜱ'
    - '  &#e6e6fa•  ᴍᴏʙꜱ: &#c2a8fc%min_mobs%&#e6e6fa - &#c2a8fc%max_mobs%'
    - '  &#e6e6fa•  ᴅᴇʟᴀʏ: &#c2a8fc%delay%&#e6e6faꜱ'
    - '  &#e6e6fa•  ɴᴇxᴛ ꜱᴘᴀᴡɴ: &#c2a8fc%time%'
    - ''
    - '&#7b68ee⊳ &#f8f8ffʀɪɢʜᴛ-ᴄʟɪᴄᴋ ᴛᴏ ᴏᴘᴇɴ &#ab7afdꜱᴛᴀᴄᴋᴇʀ ɢᴜɪ'
    - '&#7b68ee⊳ &#f8f8ffᴄʟɪᴄᴋ ᴛᴏ&#f0c857 ꜱᴇʟʟ ɪᴛᴇᴍꜱ &#ab7afd& &#37eb9aᴄᴏʟʟᴇᴄᴛ xᴘ'
  # Version used when shop integration is disabled or player lacks permission
  lore_no_shop:
    - ''
    - '&#7b68ee◈ &#8a2be2ɪɴꜰᴏʀᴍᴀᴛɪᴏɴ:'
    - '  &#e6e6fa•  ꜱᴛᴀᴄᴋ: &#c2a8fc%stack_size%'
    - '  &#e6e6fa•  ʀᴀɴɢᴇ: &#c2a8fc%range%&#e6e6fa ʙʟᴏᴄᴋꜱ'
    - '  &#e6e6fa•  ᴍᴏʙꜱ: &#c2a8fc%min_mobs%&#e6e6fa - &#c2a8fc%max_mobs%'
    - '  &#e6e6fa•  ᴅᴇʟᴀʏ: &#c2a8fc%delay%&#e6e6faꜱ'
    - '  &#e6e6fa•  ɴᴇxᴛ ꜱᴘᴀᴡɴ: &#c2a8fc%time%'
    - ''
    - '&#7b68ee⊳ &#f8f8ffᴄʟɪᴄᴋ ᴛᴏ ᴏᴘᴇɴ &#ab7afdꜱᴛᴀᴄᴋᴇʀ ɢᴜɪ'
  lore_full: '&#ff5252ꜱᴛᴏʀᴀɢᴇ & ᴇxᴘ ɪꜱ ꜰᴜʟʟ!'
  lore_inactive: '&#ff3333ꜱᴘᴀᴡɴᴇʀ ɪꜱ ɪɴᴀᴄᴛɪᴠᴇ!'

• Update command chagnes to scripts - Change /ss give to /ss give spawner... and /ss giveVanilaSpawner... to /ss give vanilla_spawner... in any automated scripts

SmartSpawner - Version 1.4.1

🐛 Bug Fixes

• Fixed spawner item consumption bug: Resolved an issue where shift-clicking to place a spawner in an unallowed region (from other plugins) would incorrectly consume the spawner items from the player's inventory

✨ New Features

• IridiumSkyblock Integration: Added support for IridiumSkyblock plugin

SmartSpawner - Version 1.4.0.2

⚠️ Critical Bug Fixes

🔧 Spawner Duplication Exploit Patched

• Fixed: Critical duplication bug that allowed players to duplicate spawners using auto-clickers with shift-click placement
• Impact: This exploit could severely affect server economy and balance
• Recommendation: Update immediately to prevent further exploitation

SmartSpawner - Version 1.3.9

Major Improvements

Item Drop System Overhaul

• Improved drop item logic - Items from spawner storage now drop where the player is looking, mimicking vanilla Minecraft item drop behavior for a more intuitive experience

Performance Enhancements

• Optimized GUI inventory checks - Now uses Paper's getHolder(false) method for faster, more efficient performance
• Fixed spawner scaling issues - Resolved problems with EXP and slot inventory not scaling correctly after destacking by 1

Bug Fixes & Integrations

Plugin Integration Fixes

• ShopGUI+ integration fix - Resolved listeners stacking every time /shop reload is used and properly unregister during cleanup
• ESGUI/ESGUI-Premium integration - Fixed spawners not detecting shop plugin properly
• MinePlots integration - Added support for MinePlots plugin compatibility

Item & Display Fixes

• Tipped arrow improvements - Fixed display names and tooltip information now correctly shows duration and amplifier details
• Item support expansion - Added support for all items from version 1.20 through the latest 1.21.7 to be configured as spawner drops

New Features

Developer API

• Added EXPClaimEvent - New event for developers to hook into EXP claiming functionality (addresses Issue #82)

Version Support

• Minecraft 1.21.7 compatibility - Full support for the latest Minecraft version 1.21.7

Configuration Updates

Mob Drops Configuration

• Wiki documentation added - Complete mob drops configuration guide now available at: SmartSpawner-Mob-Drops-Configuration-Wiki

Updated Mob Configurations

Due to tipped arrow improvements, the following mob configurations have been updated:

STRAY mob configuration:

STRAY:
  experience: 5
  loot:
    BONE:
      amount: 0-2
      chance: 100.0
    ARROW:
      amount: 0-2
      chance: 100.0
    BOW:
      amount: 1-1
      chance: 8.5
      durability: 1-384
    TIPPED_ARROW:
      amount: 0-2
      chance: 50.0
      potion_effect:
        type: SLOWNESS
        extended: false
        upgraded: false

BOGGED mob configuration:

BOGGED:
  experience: 5
  loot:
    BONE:
      amount: 0-2
      chance: 100.0
    ARROW:
      amount: 0-2
      chance: 100.0
    BOW:
      amount: 1-1
      chance: 8.5
      durability: 1-384
    TIPPED_ARROW:
      amount: 0-2
      chance: 50.0
      potion_effect:
        type: POISON
        extended: false
        upgraded: false

⚠️ Important Configuration Update Instructions

To ensure compatibility with the tipped arrow improvements and other changes, please update your mob_drops.yml configuration file:

Option 1 - View Online: Check the complete default configuration at:

• GitHub: github.com/ptthanh02/SmartSpawner/blob/main/core/src/main/resources/mob_drops.yml

Option 2 - Auto-Regenerate: Delete your existing mob_drops.yml file and restart the server. The plugin will automatically regenerate the default configuration file with all the latest changes.

For support and bug reports, please visit our GitHub repository or Discord server.

SmartSpawner - Version 1.3.8

Compatibility Updates

• Re-added Minecraft 1.21 - 1.21.3 compatibility - Full support restored for these versions
• Added Minecraft 1.21.6 compatibility - Plugin now supports the latest Minecraft version

Bug Fixes

• Fixed spawner storage item selling issue - Resolved bug where filtered items from spawner storage couldn't be sold when they should be
• Fixed ESGUI-Premium integration - Resolved issue where price hooks sometimes failed and returned 0 for item prices

New Features

Advanced Natural Spawner Configuration

Added comprehensive configuration options for naturally generated dungeon spawners:

# Controls behavior of naturally generated dungeon spawners
natural_spawner:
  # Whether natural spawners can be broken and collected
  breakable: false

  # Convert natural spawners to smart spawners when broken
  # If false, natural spawners will drop vanilla spawner items
  convert_to_smart_spawner: false

  # Whether natural spawners will spawn mobs
  spawn_mobs: true

  # Whether natural spawner block will be protected from explosions
  protect_from_explosions: false

Entity Support Expansion

• Full compatibility - Spawners now support all Minecraft entities
• Added Happy Ghast spawner - New mob type available for spawner creation

Configuration Options

The new natural spawner system provides server administrators with granular control over how naturally occurring dungeon spawners behave, including protection from explosions, conversion capabilities, and mob spawning control.

SmartSpawner - Version 1.3.7

🆕 New Features

Creaking Spawner Support

• Added support for the new Creaking spawner type

Configurable GUI Layout System

• Major Enhancement: Introduced configurable GUI layout options
• Players can now customize spawner storage GUI buttons and slot positions
• Added DonutSMP GUI layout configuration preset

Storage Management Improvements

• Added "Drop All Items from Page" option in spawner storage interface
• Enhanced bulk item management capabilities

Shop Integration Expansion

• New Integration: Added full support for ExcellentShop plugin

🔧 Bug Fixes

Experience System Fixes

• Critical Fix: Resolved issue where spawner experience would incorrectly reset to 1000 after server restart
• Corrected spawner experience exceeding maximum limits when decreasing spawner stack size

Integration Fixes

• Important Fix: Resolved detection issue with ShopGuiPlus integration
• Plugin now properly recognizes and integrates with ShopGuiPlus

⚙️ Technical Compatibility

Version Compatibility

• Removed compatibility for Minecraft 1.21.6 due to unstable Paper server builds

SmartSpawner - Version 1.3.6

New Features

Economy & Selling System

• CoinsEngine Integration: Added comprehensive support for selling items from spawner storage through CoinsEngine
• Enhanced Sell Implementation: Significantly improved performance optimization for selling operations
• Advanced Price Mode System: Introduced four configurable price source modes for flexible economy management:
  • SHOP_ONLY - Utilizes exclusively shop integration prices
  • SHOP_PRIORITY - Prioritizes shop prices with custom prices as fallback (recommended configuration)
  • CUSTOM_ONLY - Uses exclusively custom configured prices
  • CUSTOM_PRIORITY - Prioritizes custom prices with shop prices as fallback
• Improved Shop Integration: Enhanced plugin compatibility with automatic detection for economy plugins

Spawner Management

• Chunk Limit System: Implemented spawner chunk limit functionality with stacking count support for optimized server performance
• MultiWorld Compatibility: Added seamless cross-world spawner functionality for MultiWorld environments

Improvements

Spawner Drop Logic

• Enhanced Drop Mechanics: Resolved item dropping issues by preventing spawners from dropping items into solid blocks
• Optimized Drop Positioning: Items now consistently drop in accessible locations, eliminating issues with items becoming trapped in blocks or caves

Integration & Compatibility

• AuraSkills Integration: Added comprehensive integration support for enhanced skill system compatibility
• Minecraft 1.21.6 Support: Full compatibility with the latest Minecraft version

Bug Fixes

• Resolved spawner item drop issues where items would become trapped in solid blocks
• Fixed ghost armor item bug occurring when right-clicking spawners while holding armor items
• Implemented various performance optimizations and stability improvements

SmartSpawner - Version 1.3.5

🔧 Bug Fixes

• Fixed compatibility issue with EconomyShopGUI: Resolved SmartSpawner not detecting the latest EconomyShopGUI update due to EconomyShopGUI now hooking into SmartSpawner

• Fixed anchor explosion protection: Corrected issue where anchors could explode spawner blocks even when protect_from_explosions was enabled, preventing ghost spawners from being left behind

• Fixed SuperiorSkyblock2 integration: Resolved spawners not being properly removed when disbanding islands, which previously left ghost spawners behind

• Fixed WorldGuard detection: Improved WorldGuard checking mechanism by switching from class name detection to Bukkit plugin manager verification, resolving false positives when other plugins contain WorldGuard class names

✨ New Features

• Added RedProtect support: SmartSpawner now integrates with RedProtect for enhanced region protection

• Added Turkish translation: Full Turkish language support thanks to @berkkorkmaz

• Improved reload functionality: You can now change mob loot configurations using the /ss reload command without needing to restart the server

SmartSpawner - Version 1.3.4

⚠️ IMPORTANT: EconomyShopGUI Compatibility Warning

If you're using SmartSpawner with EconomyShopGUI, please update your configuration!

You must set the following in your EconomyShopGUI config.yml file:

enable-spawnerbreak: false

Without this change, players may lose their spawners when mining them due to conflicts between EconomyShopGUI and SmartSpawner's spawner behavior modifications.

New Features

• SimpleClaimSystem Integration: Added support for spawner protection through SimpleClaimSystem plugin
• Italian Localization: Added Italian translation (it_IT) thanks to @RV_SkeLe

Performance Improvements

• Hopper Optimization: Dramatically improved hopper feature performance
  • Active hoppers now load much faster
  • Significantly reduced resource usage during operation
• Enhanced Range Checking: Optimized spawner range checker with more efficient detection

Bug Fixes

• Hopper Transfer Issues: Fixed issue where hoppers occasionally failed to transfer items from spawners

SmartSpawner Version 1.3.3

🐛 Bug Fixes

• Fixed %entity% placeholder not showing in message when using give spawner command in console
• Resolved issue with initial plugin loadup falsely creating config_backup_0.0.0.0.yml
• Corrected spawner explosion deletion process in spawner data file

🌟 Improvements

• Enhanced item filter for spawners with a new, user-friendly GUI
  • Added granular control to specify which items will be generated or blocked
• Made slight modifications to the Spawner Storage GUI for better user experience

Smart Spawner - Version 1.3.2

Compatibility

• Added support for Minecraft 1.21.5

New Features

• Enhanced Spawner List Management
  • Added sorting options:
    • Default (by ID)
    • Stack size (ascending)
    • Stack size (descending)
  • Added filtering capabilities:
    • All spawners
    • Active spawners only
    • Inactive spawners only
• Plugin Integration
  • Added support for BentoBox plugin

Bug Fixes

• Fixed an issue where chickens were incorrectly spawning from Zombie and Zombified Piglin spawners due to Chicken Jockey mechanics
• Resolved Towny integration issue that prevented residents from breaking spawners in their own plots
• Fixed GUI update inconsistencies in the spawner storage interface

Performance Improvements

• Optimized GUI update process to enhance performance
• Implemented measures to prevent false updates and duplicate entries

Smart Spawner - Version 1.3.1

New Features

• Added back support for spawner item in EconomyShopGUI
  • Players can now can use spawners in shop as SmartSpawner
• Added option to directly add spawner items to player inventory when breaking spawners

  # Whether to directly add spawner items to player inventory instead of dropping them on the ground
  direct_to_inventory: false
  

• Implemented configurable ghost spawner management options

  ghost_spawners:
    # Remove ghost spawners when server starts up
    # Only checks spawners in loaded chunks
    remove_on_startup: true
  
    # Remove ghost spawners when players approach them
    # This checks when players enter spawner range
    remove_on_approach: false
  

Bug Fixes

• Fixed storage GUI bug where items weren't properly removed when selling through shop plugins
• Improved ghost spawner removal by preventing checks in unloaded chunks

Performance Improvements

• Optimized ghost spawner detection system for better server performance

Smart Spawner - Version 1.3.0

Bug Fixes

• Fixed critical issue with spawner break not deleting data, which previously created "ghost spawners"
• Resolved ShopGUIPlus spawner integration provider, allowing proper selling of spawners in shops
• Fixed spawner hologram display by implementing the correct scheduler for Folia compatibility

Performance Improvements

• Enhanced data management system to prevent orphaned spawner entries
• Optimized integration with shop plugins for smoother transactions

Smart Spawner - Version 1.2.9

Bug Fixes

• Fixed hologram feature not updating properly on Folia
• Resolved issue with /ss list command incorrectly displaying custom worlds

New Features

• Added complete Vietnamese translation (locale code: vi_VN)
• Implemented custom sell price functionality for items in spawners
  • Full integration with Vault
  • Sell items directly without requiring additional shop plugins
• Updated spider head texture for spawners

Performance Improvements

• Optimized spawner data saving mechanism for better performance
• Enhanced spawner break-dropping functionality for improved efficiency

🛠️ Smart Spawner - Version 1.2.8

✨ New Features

• 🧠 Refactored Config System + Time Format Support

  • Introduced a flexible time format system for configuration.
    • Supports formats like 5m, 1h_30m, 1d_2h_15s, and more.
    • Time units: s, m, h, d, w, mo, y.
  • ⚠️ Note: Review and update your config file after installing this version!

• 🗣 Advanced Language System Overhaul

  • Completely restructured message configuration with multi-component support:
    • message, title, subtitle, action_bar, sound.
  • Easily toggle individual messages and customize how feedback is delivered to players.
  • Enables more immersive and customizable server interactions.

• 🧱 Spawner Type Split: Smart vs Vanilla

  • Spawners are now separated into Smart Spawner and Vanilla Spawner.
  • Both types feature fully customizable:
    • Display name
    • Lore
    • Placeholder support for %entity%, %amount%, %chance%, and more.
  • Customize your item aesthetics like a pro!

• 🧰 New Command: /ss giveVanillaSpawner

  • Command to give vanilla spawners:

    /ss giveVanillaSpawner <player> <mobtype> [amount]
    

  • Great for manual setups or creative mode use.

❌ Removed / Deprecated

• 🈲 Deprecated vi_VN and zh_CN Language Files
  • Due to the new language system, legacy language files for Vietnamese (vi_VN) and Simplified Chinese (zh_CN) have been deprecated.
  • Please migrate your translations to the new structured format in the language configuration.

🐛 Bug Fixes

• 👻 Fixed Persistent Duplicate Holograms

  • Eliminated an issue where disabled holograms would randomly reappear and not despawn.
  • Now automatically removes stale holograms on spawner data changes.

• 🔍 Improved Natural Spawner Detection

  • Resolved an issue where natural spawners were incorrectly treated as Smart Spawners when interacted with.
  • Now correctly distinguishes between the two.

• 💥 Fixed Spawner Drop Logic

  • Resolved a bug where broken spawners wouldn't drop an item, causing it to disappear.
  • Drops are now handled properly across all conditions.

🛠️ Smart Spawner - Version 1.2.7

✨ New Features

• ⚡ Official Folia Support

  • Smart Spawner is now fully compatible with Folia, ensuring seamless integration and performance on async-enabled servers. 🎉

• 🗑 New "Discard All" Button in Spawner Storage GUI

  • Easily remove all stored items in the Spawner Storage GUI with a single click.

• 🎮 Improved Item Dropping in Spawner Storage GUI

  • Added support for:
    • Q to drop a single item.
    • CTRL + Q to drop an entire stack.

❌ Removed Support

• ⚠ Dropped Support for Bukkit Servers
  • Smart Spawner no longer supports Bukkit-based servers due to the adoption of the Adventure API, which requires Paper or higher for proper functionality.

🔧 Bug Fixes

• 🛠 Fixed calculateTimeUntilNextSpawn Error on Folia
  • Resolved an issue causing errors in SpawnerGuiViewManager, ensuring more stable performance when updating spawner information.

🚀 Performance & Optimizations

• ⚙ Optimized Spawner Drop Algorithms
  • Improved the Spawner Spawn Drops algorithm, leading to better performance and efficiency when handling large numbers of mobs.

🛠️ Smart Spawner - Version 1.2.6b (Beta)

🚀 Folia Support (Beta) & More Improvements!
This update introduces experimental support for Folia and further optimizations!

🔹 New Features

⚡ Folia Compatibility (Beta) – Smart Spawner now has preliminary support for Folia, improving performance on high-concurrency servers.

⚠️ Important Notice

This is a beta version, so bugs may occur. Please report any issues you find!

🌍 We Need Translators!

Want to help translate Smart Spawner into your language? Contribute now!
📖 Guide & Info: Translation Guide

🛠️ Smart Spawner - Version 1.2.6

🔧 Bug Fixes

• 🔄 Improved anti-spam click protection for all GUIs, further reducing duplication exploits.
• ⚒ Fixed incorrect NBT data for Iron Ingot items, ensuring proper functionality in all crafting and trade interactions.
• 🌍 Resolved language configuration issue – players can now correctly change the plugin language in the config file.

🚀 Enhancements & Optimizations

• 🎨 Overhauled item lore in GUI – redesigned for both clarity and aesthetics, making the interface more visually appealing.

  • ⚠ Reminder: To apply these changes, delete the messages directory and allow the plugin to regenerate it.

• 🔘 Unified 'Sell All Items & Collect EXP' button in the spawner menu.

  • Players can now sell all stored items and collect stored experience with a single click, improving convenience and efficiency.

🛠️ Smart Spawner - Version 1.2.5.2

✨ Improvements

• 🔄 Enhanced /ss reload Command
  • Now supports reloading loot configuration and hopper features without requiring a server restart.

🔧 Bug Fixes

• 🛠 Fixed /ss hologram Command
  • Resolved an issue where the /ss hologram command had not been working since version 1.2.5.

🛠️ Smart Spawner - Version 1.2.5.1

✨ New Features

• 🌍 Multiversal-Core Support
  • Added support for Multiversal-Core to properly load and save spawners in custom worlds.
  • Improved /spawner list command to display all spawners, including those in custom worlds.

🔧 Bug Fixes

• 🛠 Fixed Config Version Issue
  • Resolved an issue where config-version was not properly added when creating a new config file.

🛠️ Smart Spawner - Version 1.2.5

✨ New Features

• 🏆 Expanded Spawner Drop Support

  • Now supports all mobs in Minecraft when obtaining spawners. 🎉

• 🛠 New API for Developers

  • Introduced SmartSpawner API 1.2.5 for seamless integration.
  • Available at: GitHub Package
  • Artifact: github.nighter.smartspawner-api:1.2.5

🔧 Bug Fixes

• 🛠 Fixed EXP Collection Bug

  • Resolved an issue where players couldn't click to collect EXP from a spawner when using Mending with negative durability.

• 🕷 Fixed Cave Spider Spawner Detection

  • The plugin now correctly identifies cave spider spawners as natural spawners.

🚀 Performance & Optimizations

• 🔍 Enhanced Natural Spawner Checks

  • Now detects all naturally generated spawners, including those found in strongholds, fortresses, mineshafts, and more.

• 🌐 Localization & Message Improvements

  • Updated Vietnamese translation to the latest version..
  • Enhanced sell tax message formatting for better clarity.

🔄 Other Changes

• ⚙ Updated Configuration Format

  • 🚨 IMPORTANT: ALL time-based values are now in SECONDS!
  • This update changes how time values are handled, so you MUST review and update your configuration after installing the update!
  • Example of the new format:

    # Data Saving Interval in seconds (default: 300 seconds - 5 minutes)  
    save-interval: 300 # seconds  
    
    # Base loot spawn delay  
    delay: 20 # seconds  
    
    # Cooldown between selling items  
    sell-cooldown: 3 # seconds  
    
    # Update checker interval  
    update-checker-interval: 24 # hours  
    

• 📜 Updated messages and mob_drops.yml Files

  • If you want to apply the latest updates, simply delete the file/folder, and the plugin will regenerate them automatically.

🛠️ Smart Spawner - Version 1.2.4

🔧 Bug Fixes

• 🛠 Fixed spawner type issue when placing spawners purchased via EconomyShopGUI.
• ⏳ Resolved spawn timing errors – this issue has been completely fixed.
• 📦 Fixed loot overflow issue – spawners will now display a "Storage & EXP Full" message and stop generating loot when capacity is reached.

🚀 Performance Optimizations

• ⚡ Improved GUI synchronization for spawners, reducing lag and enhancing user experience.

• 🔄 Implemented anti-spam click protection, preventing duplication exploits across all spawner GUIs.

• 👥 Multiple players can now safely view the same spawner GUI simultaneously without conflicts.

• 💾 Optimized spawner data saving – now only modified spawners are saved at configured intervals, significantly reducing server load.

  # Data Persistence Interval  
  # Save interval in seconds (default: 300 seconds) - 5 minutes  
  save-interval: 300
  

✨ New Features

• 🛒 Sell Cooldown Configuration

  • Added config option to set cooldown for selling items in spawner storage.
  • Prevents performance issues caused by excessive clicking.
  • 🛠 Debug mode available to track users attempting to bypass the cooldown.

• ❌ Natural Spawner Interaction Restriction

  • New config option:

    natural-spawner-interaction: false
    

  • Prevents players from interacting with naturally generated spawners.
  • Blocks breaking and activation of natural spawners.
  • 🔒 Ideal for servers aiming to prevent ESP, X-ray, and hacking exploits.

🔄 Other Changes

• ❌ Dropped support for Spigot server loader due to dependency on net.kyori:adventure-text-minimessage.
• 📜 Refreshed message files – to update, delete the messages directory and let the plugin regenerate it automatically.

Smart Spawner v1.2.3 - Update Log

🔧 Fixes

• Fixed a bug where the specific shop integration in the config did not work (only auto mode was functional).

🛠️ Add

• SuperiorSkyblock2 Support
  • Added integration with SuperiorSkyblock2, allowing spawners to work seamlessly within island protections.

✨ Improvements

• Config Management System Overhaul
  • The config system now automatically updates, ensuring all missing values are added seamlessly.
• Language System Update
  • You can now add a separate language file without needing to override en_US.yml.
  • Some messages have been revised. To apply the updated messages, delete the messages folder and let the plugin regenerate it.
• Spawner List Command Optimization
  • Improved performance for the /spawner list command, making spawner lookup faster and more efficient.
  • Added Total Spawner Stacked information in item lore for better tracking.

🌍 Translations

• Added Simplified Chinese translation by SnowCutieOwO.

Enjoy the update! 🚀 If you encounter any issues, feel free to report them on our Github .

Smart Spawner v1.2.2 - Update Log

🆕 New Features

• Added zShop support: Now supports selling items directly from spawner storage. (Currently only supports Vault currency).
• Auto-detect shop plugin: The configuration now includes automatic detection of the shop plugin.
• Spawner Hologram: Introduced a hologram display for spawners.

⚙️ Improvements & Additions

• Particle Configuration: Added settings for controlling particle effects in spawner actions.
• Transaction Log: Implemented a transaction log in the shop to track player sales.

🛠️ Bug Fixes

• Fixed data backup & loading issues: Resolved problems related to data saving and loading.

📌 Important Notes

• Some messages have been revised. If you want to apply the updated messages, please delete the messages folder and let the plugin regenerate it.

🚀 Enjoy the update and let us know if you encounter any issues!

Changed

• Data Saving Structure: Improved for better readability and enhanced saving capability.

Optimized

• Loot Drop Generation: Performance improvements for faster and more efficient processing.
• Selling Items in Storage GUI: Optimized for quicker transactions.
• Spawner Storage: Enhanced for better performance and reduced resource usage.

Fixed

• EconomyShopGUI: Items of the same type now correctly stack (by using the spawner's name from the language file).

Improved

• Spawner Storage GUI/UX:
  • Items are now sorted to the first page by default.
  • New pages are only created when necessary, reducing memory usage.

Warning

• If you have an older data format, it will be automatically converted to the new format. However, don't worry— the plugin will create a backup before making any changes.

• Added: Support for ShopGUIPlus.

• Added: Support for ShopGUIPlus.

• Fixed the spawner storage item duplication bugs.

• Fixed the spawner storage item duplication bugs.

• Added support for 1.21.4
• Added WorldGuard support
• Optimized save and load processes for spawner data to improve performance
• Minor performance improvements
• Fixed duplicate selling bug with the ESGUIShop plugin
• Fixed issue with plugin not working on 1.20.1

• Added support for 1.21.4
• Added WorldGuard support
• Optimized save and load processes for spawner data to improve performance
• Minor performance improvements
• Fixed duplicate selling bug with the ESGUIShop plugin
• Fixed issue with plugin not working on 1.20.1

• Fixed the bug with non-op players activating spawner give wrong entity type

• Improvement to /ss give command: added sound, useable in consle,...

• Fixed the bug with non-op players activating spawner give wrong entity type

• Improvement to /ss give command: added sound, useable in consle,...

• Resolved an issue where spawners would immediately generate loot and experience when players entered or exited the activation range. Spawners now properly adhere to the activation radius

• Added a configuration option to format currency (VAULT), enabling cleaner and more professional pricing displays in messages.

• Resolved an issue where spawners would immediately generate loot and experience when players entered or exited the activation range. Spawners now properly adhere to the activation radius

• Added a configuration option to format currency (VAULT), enabling cleaner and more professional pricing displays in messages.

• Added support for NBT tags on spawners for compatibility with other plugins use spawner.

• Resolved issues causing "no-permission" errors in certain scenarios.

• Added support for NBT tags on spawners for compatibility with other plugins use spawner.

• Resolved issues causing "no-permission" errors in certain scenarios.

• New Command: Added /ss list for server operators to view all server spawners with a GUI.

• Tax System: Introduced a configurable tax feature for item sales in the Spawner GUI.

• New Mob Support: Added compatibility for Silverfish spawners.

• Configurable Storage: Added a configuration option to customize the inventory page for Spawner Storage.

• Bug Fix: Resolved an issue where spawners would immediately generate drops and experience upon activation.

• Adjustment: Spawner stacking now resets the timer of generating drops and experience to prevent exploitation.

• New Command: Added /ss list for server operators to view all server spawners with a GUI.

• Tax System: Introduced a configurable tax feature for item sales in the Spawner GUI.

• New Mob Support: Added compatibility for Silverfish spawners.

• Configurable Storage: Added a configuration option to customize the inventory page for Spawner Storage.

• Bug Fix: Resolved an issue where spawners would immediately generate drops and experience upon activation.

• Adjustment: Spawner stacking now resets the timer of generating drops and experience to prevent exploitation.

• Fix player not receiving currency when selling items from spawner storage

• Add give spawner command for giving mob type spawners to players

• Fix player not receiving currency when selling items from spawner storage

• Add give spawner command for giving mob type spawners to players

• Fixed Same-Type Stacking: Spawners now stack only with the same entity type.

• Bug Fixes on Hand Stacking: Resolved issues when stacking spawners by hand when stack size is 1.

• Added Experimental Hopper Integration: Hoppers can now extract items from spawner storage into other containers.

• Added support for Spawner bought from EconomyShopGUI

• Fixed Same-Type Stacking: Spawners now stack only with the same entity type.

• Bug Fixes on Hand Stacking: Resolved issues when stacking spawners by hand when stack size is 1.

• Added Experimental Hopper Integration: Hoppers can now extract items from spawner storage into other containers.

• Added support for Spawner bought from EconomyShopGUI