SmartSpawner 1.8.0

This release contains several breaking changes. Back up the plugins/SmartSpawner/ folder before updating. The give commands changed shape, spawner settings files were renamed and are not carried over, YAML storage and the Bedrock form menus were removed, and several config keys moved. Read the Removed and Notes sections below before updating a live server.

Added

• Custom spawners can now be created. The same mob or item can be set up under several names, each with its own drop table, so one entity can power many different spawners.
• Custom items can now be spawner drops, including potions, enchanted gear, named items and items from other plugins. They keep all of their data and show their real in-game name in every menu.
• /ss editloot <name> opens an in-game loot editor for mob and item spawners. Drop an item into the menu to add it as a drop, captured exactly with all of its data, then set its amount, chance and durability. Existing drops can be edited or removed. Durability is shown only for tools and weapons.
• Sneak stacking and sneak placing can each be turned off with sneak_stack and sneak_place in config.yml. Both stay on by default.

Fixed

• Item Spawner holograms now show the spawned item's name instead of a generic entity label.
• Sneak-placing a whole stack of spawners now fires the stacking event in the API, so it can be cancelled and limited like normal stacking.
• A spawner type change cancelled through the API no longer takes the player's spawn egg.

Changed

• Give commands now put the player first, as /ss give <player> smart_spawner|item_spawner|vanilla_spawner, and only suggest names of online players. The spawner type was renamed to smart_spawner. Smart and item spawners are still selected by their configured name.
• SQLite is now the default storage and is faster than the old YAML files on servers of any size. MySQL and MariaDB work as before, including cross-server spawner listing.
• How often spawner data is saved can now be set with database.autosave-interval, which defaults to 3 minutes.
• Large spawner stacks and full storages use far less CPU and memory. Loot generation, storage menus, hoppers and selling were all reworked to stay fast with large amounts of items.
• Menus respond faster to clicks.
• Settings that only take effect after a full restart are now marked RESTART in config.yml.
• Selling and action logging settings moved into clearer files, and the database section was simplified. Existing settings move across automatically on the first start. See the details below.
• The two spawner settings files were renamed and loot entries use a new format. See the details below.

Removed

• YAML storage was removed. Servers still set to YAML are switched to SQLITE automatically.
• Bedrock form menus were removed. Bedrock players now use the same chest menus as Java players, and the bedrock_support section of config.yml is gone.
• The stacker menu was removed, along with the admin stack editor in /ss list. Spawners still stack by placing one spawner on another of the same type, controlled by the smartspawner.stack permission.

Notes

• Spawner settings are not carried over. The two renamed files are created fresh in the new format, and the old files are left untouched beside them so customised drop tables can be copied across by hand. The console reports this on the first start.
• Spawner data is migrated automatically. spawners_data.yml is renamed to spawners_data.yml.migrated so nothing is imported twice.
• Back up the plugins/SmartSpawner/ folder before updating. The plugin also copies the old data inside the database before converting it.
• If the database cannot be opened, the plugin stops instead of running without saving. The console reports the reason.
• Every renamed config key is migrated on the first start, so no config file needs editing by hand after updating.

Configuration file details

• spawners_settings.yml is now spawner_mobs.yml, and item_spawners_settings.yml is now spawner_items.yml.
• Each loot entry names its item on an item line. It accepts a material, the item text /give completes in game, or a code copied from the game.
• The name above each entry is now only a label, so one mob can drop several versions of the same item, such as two different tipped arrows.
• The old format, where the entry name doubled as the material name, is no longer read. The material line in item spawner entries was removed with it.
• The potion_type line was removed. Name the potion inside item instead.
• The spawner block head moved to mob_head, with item for the material and hash_texture for the texture code. It replaces head_texture with material and custom_texture.
• The default_material line was removed. The fallback head is now built in.
• A loot entry the server cannot read is skipped, and the console names the mob and the entry.
• The guide in the comments at the top of both files was replaced with a link to the documentation site.
• The storage button in the main menu now accepts the {total_sell_price} placeholder, showing the sell value of everything stored, as the info button already does.
• discord_logging.yml is now activity_log.yml, and the logging section of config.yml became its file section. Both moves happen on the first start and keep the configured values.
• Inside that file the Discord settings sit under discord, and the per-event message templates sit under embeds, one block per event with the embed line removed.
• The sell_integration section of config.yml became the top level of sell_integration.yml, so its keys lost the sell_integration. prefix. item_prices.yml became the custom_prices.prices section of that file and is deleted once its prices have been copied across.
• A price removed from custom_prices.prices stays removed and is not added back on the next start.
• The database section was flattened and its keys now use hyphens. mode is type, table_prefix is table-prefix, server_name is server-name, sync_across_servers is sync-across-servers, migrate_from_local is migrate-from-local, sqlite.file is sqlite-file, and the four sql connection keys moved up a level.
• sql.pool.maximum-size is now pool-size and covers both storage modes. The other pool tuning keys and sqlite.pool_size were removed and are set internally.
• The new database.autosave-interval accepts the usual time format, with a minimum of 30 seconds. It is the only setting in the section that /ss reload applies.
• Database columns were shortened: world_name is world, item_spawner_material is itemspawner_type, spawner_exp is exp, spawner_active is active, spawner_range is activation_range, spawner_stop is stop, spawn_delay is delay, and max_spawner_loot_slots is max_loot_slots. entity_type keeps its name.
• Columns are now grouped by subject in the table, so location, spawner type, stacking, spawning, stored loot, stored experience and player settings each sit together.
• The server_name column was removed. A table now holds one server's spawners and says which in its name, so the column held the same value on every row.
• With sync-across-servers on, this server's table is <prefix><server-name>_data instead of <prefix>data. Switching the setting renames the table, and an existing table at the target name is never overwritten.

SmartSpawner 1.7.1.2

Fixed

• GUI layout button changes now persist correctly after a restart or /ss reload, including moved and deleted buttons.
• Clicking the sell button in an empty storage no longer returns to the main menu. Stored experience is collected when available; otherwise, the storage empty message is shown.
• Updated the bundled sell_confirm_gui.yml layouts to the current click-action format, preventing unnecessary value migrations on fresh installations.
• DonutSMP storage titles now use the correct singular or plural form and remain consistent after pagination or refreshes.
• Dynamic storage lore placeholders, including {total_sell_price} and {current_exp}, are now replaced correctly.

Notes

• Previously restored buttons must be moved or deleted once after updating.
• Customized button sections no longer receive new bundled buttons automatically. Other layout settings continue to update normally.
• Delete a layout file and restart the server to restore its default content.

SmartSpawner 1.7.1.1

Fixed

• Removed mob drops in spawners_settings.yml are no longer restored after a restart or /ss reload.
• Removed message components, such as chat messages, action bars, sounds, titles, and subtitles, are no longer restored automatically.

Removed

• Removed generation of the outdated language/CHANGELOG.txt file.

Notes

• Previously restored drops or message components must be removed once after updating.
• Customized drop lists and messages are preserved, while entirely new mobs and messages are still added with their default content.
• Existing language/CHANGELOG.txt files are left unchanged and can be removed safely.
• GUI and formatting language files retain their previous update behavior.

SmartSpawner 1.7.1

Added

• Added FactionsUUID support. Spawners now respect faction access rules when opening menus or stacking.
• Added BlockLocker support. Spawners protected by [Private] signs now restrict menu access, stacking, and breaking to authorized players.

Changed

• Config and language files now update automatically while preserving existing values and comments.
• Update backups are no longer created because configuration changes are applied in place.
• Obsolete config_version entries are now removed automatically.

Notes

• No manual configuration changes are required.

SmartSpawner 1.7.0.2

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.

SmartSpawner 1.7.0.1

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.

SmartSpawner 1.7.0

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.

SmartSpawner 1.6.9

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.

SmartSpawner 1.6.8

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.

SmartSpawner 1.6.7

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.