Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
Enhances spawner use with GUI that generates mob drops and experience without spawning entity
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_stackandsneak_placeinconfig.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. Thespawnertype was renamed tosmart_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
databasesection 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
YAMLare switched toSQLITEautomatically. - Bedrock form menus were removed. Bedrock players now use the same chest menus as Java players, and the
bedrock_supportsection ofconfig.ymlis 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 thesmartspawner.stackpermission.
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.ymlis renamed tospawners_data.yml.migratedso 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.ymlis nowspawner_mobs.yml, anditem_spawners_settings.ymlis nowspawner_items.yml.- Each loot entry names its item on an
itemline. It accepts a material, the item text/givecompletes 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
materialline in item spawner entries was removed with it. - The
potion_typeline was removed. Name the potion insideiteminstead. - The spawner block head moved to
mob_head, withitemfor the material andhash_texturefor the texture code. It replaceshead_texturewithmaterialandcustom_texture. - The
default_materialline 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.ymlis nowactivity_log.yml, and theloggingsection ofconfig.ymlbecame itsfilesection. 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 underembeds, one block per event with theembedline removed. - The
sell_integrationsection ofconfig.ymlbecame the top level ofsell_integration.yml, so its keys lost thesell_integration.prefix.item_prices.ymlbecame thecustom_prices.pricessection of that file and is deleted once its prices have been copied across. - A price removed from
custom_prices.pricesstays removed and is not added back on the next start. - The
databasesection was flattened and its keys now use hyphens.modeistype,table_prefixistable-prefix,server_nameisserver-name,sync_across_serversissync-across-servers,migrate_from_localismigrate-from-local,sqlite.fileissqlite-file, and the foursqlconnection keys moved up a level. sql.pool.maximum-sizeis nowpool-sizeand covers both storage modes. The other pool tuning keys andsqlite.pool_sizewere removed and are set internally.- The new
database.autosave-intervalaccepts the usual time format, with a minimum of 30 seconds. It is the only setting in the section that/ss reloadapplies. - Database columns were shortened:
world_nameisworld,item_spawner_materialisitemspawner_type,spawner_expisexp,spawner_activeisactive,spawner_rangeisactivation_range,spawner_stopisstop,spawn_delayisdelay, andmax_spawner_loot_slotsismax_loot_slots.entity_typekeeps 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_namecolumn 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-serverson, this server's table is<prefix><server-name>_datainstead of<prefix>data. Switching the setting renames the table, and an existing table at the target name is never overwritten.
Platforms
Paper
1.21.6–26.1.2