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.