Skip to content

Main Configuration

The config.yml file is located in plugins/SmartSpawner/. It controls language, spawner behavior, economy, visual effects, logging, database storage, and performance.

Click any option or category to view additional information.

Time Format

SmartSpawner accepts short, human-readable duration values everywhere a time is expected:

FormatMeaning
20s20 seconds
5m5 minutes
1h1 hour
1d1 day
1d_2h_30m_15s1 day, 2 hours, 30 minutes, 15 seconds

Supported units: s m h d w mo y


language:en_US
gui_layout:default
debug:false
spawner_properties:
default:
min_mobs:1
max_mobs:4
range:16
delay:25s
max_storage_pages:1
max_stored_exp:1000
max_stack_size:10000
allow_exp_mending:true
protect_from_explosions:true
spawner_break:
enabled:true
direct_to_inventory:false
required_tools:
-'IRON_PICKAXE'
-'GOLDEN_PICKAXE'
-'DIAMOND_PICKAXE'
-'NETHERITE_PICKAXE'
durability_loss:1
sneak_break:true
sell_and_xp_break:true
silk_touch:
required:true
level:1
natural_spawner:
breakable:false
convert_to_smart_spawner:false
spawn_mobs:true
protect_from_explosions:false
sell_integration:
enabled:true
currency:VAULT
excellenteconomy_currency:coins
price_source_mode:SHOP_PRIORITY
shop_integration:
enabled:true
preferred_plugin:auto
custom_prices:
enabled:true
default_price:1.0
hopper:
enabled:false
check_delay:3s
stack_per_transfer:5
bedrock_support:
enable_formui:true
hologram:
enabled:false
offset_x:0.5
offset_y:1.6
offset_z:0.5
alignment:CENTER
shadowed_text:true
see_through:false
transparent_background:false
particle:
spawner_stack:true
spawner_activate:true
spawner_generate_loot:true
logging:
enabled:true
json_format:false
console_output:false
max_log_files:10
max_log_size_mb:10
log_all_events:false
logged_events:
-'SPAWNER_PLACE'
-'SPAWNER_BREAK'
-'SPAWNER_STACK_HAND'
-'SPAWNER_SELL_ALL'
-'COMMAND_EXECUTE_PLAYER'
database:
mode:YAML
server_name:server1
sync_across_servers:false
migrate_from_local:true
performance:
approximate_loot:true
approximation_threshold:1000

Available Log Events

EventDescription
SPAWNER_PLACESpawner placed by a player
SPAWNER_BREAKSpawner broken by a player
SPAWNER_EXPLODESpawner destroyed by an explosion
SPAWNER_STACK_HANDSpawner stacked by hand
SPAWNER_STACK_GUISpawner stacked via GUI
SPAWNER_DESTACK_GUISpawner destacked via GUI
SPAWNER_GUI_OPENMain spawner GUI opened
SPAWNER_STORAGE_OPENStorage GUI opened
SPAWNER_STACKER_OPENStacker GUI opened
SPAWNER_EXP_CLAIMXP claimed from spawner
SPAWNER_SELL_ALLItems sold from storage
SPAWNER_ITEM_TAKE_ALLAll items taken from storage
SPAWNER_ITEM_DROPItem dropped with the drop key
SPAWNER_ITEMS_SORTItems sorted in storage
SPAWNER_ITEM_FILTERItem filter toggled
SPAWNER_DROP_PAGE_ITEMSAll items on current page dropped
SPAWNER_EGG_CHANGEEntity type changed with spawn egg
COMMAND_EXECUTE_PLAYERCommand run by a player
COMMAND_EXECUTE_CONSOLECommand run by console
COMMAND_EXECUTE_RCONCommand run via RCON