Spawner Settings Configuration

SmartSpawner allows you to create spawners that generate resources without spawning mobs. Configure item spawner appearance, drops, and experience through the spawners_settings.yml file.

Configuration Format

# Global default for unknown mobs
default_material: "SPAWNER"

MOB_NAME:
  experience: <number>
  head_texture:
    material: <MATERIAL>
    custom_texture: <texture_hash>  # null for vanilla heads
  loot:  # Optional section
    ITEM_ID:
      amount: <min>-<max>
      chance: <percentage>
      # Optional properties
      durability: <min>-<max>
      potion_type: <POTION_TYPE>  # For tipped arrows

Core Properties

Spawner Properties

Property	Format	Description
default_material	`"SPAWNER"`	Fallback material for unknown mobs (global)
experience	`5`	XP generated per spawner trigger
material	`"PLAYER_HEAD"`	Head texture material (PLAYER_HEAD, SPAWNER, etc.)
custom_texture	`"abc123..."`	Base64 texture hash (use `null` for vanilla heads)

Loot Properties

Property	Format	Description
amount	`1-3`	Quantity range of items generated
chance	`50.0`	Drop probability (0.0-100.0)
durability	`1-384`	Durability range for tools/weapons
potion_type	`POISON`	Potion type for tipped arrows

Validation Rules

Experience must be non-negative number
Amount format: min-max where min ≤ max
Chance between 0.0-100.0
Custom texture can be null for vanilla mob heads

Understanding Drop Mechanics

Base Drops vs Actual Drops

The amount value in the configuration is the base amount per spawner cycle. The actual amount generated is:

Actual Drops = Base Amount × Random(min_mobs, max_mobs)

For example, if min_mobs=1 and max_mobs=4 (defaults):

Base amount 1-1 → Actual drops: 1-4 items
Base amount 2-3 → Actual drops: 2-12 items
Base amount 1-2 → Actual drops: 1-8 items

Multiple Loot Entries

Each loot entry is rolled independently:

Check if the drop occurs (based on chance)
Determine base amount (within amount range)
Multiply by spawner trigger count (min_mobs to max_mobs)

This means a spawner can generate multiple different items from a single trigger.

Supported Types

Potion types use predefined names from the Paper API. Common formats include:

Basic: Standard effect duration and potency
Extended: Same potency but longer duration
Strong: Higher potency but standard duration

Examples:

POISON: Causes damage over time (0:45 duration, 1 damage/second)
LONG_POISON: Extended poison effect (2:15 duration, 1 damage/second)
STRONG_POISON: Stronger poison (0:22 duration, 2 damage/second)

Examples

Basic Mob with Custom Head

# Reference: https://minecraft.wiki/w/Cow#Drops
COW:
  experience: 3
  head_texture:
    material: "PLAYER_HEAD"
    custom_texture: "b667c0e107be79d7679bfe89bbc57c6bf198ecb529a3295fcfdfd2f24408dca3"
  loot:
    LEATHER:
      amount: 0-2
      chance: 66.67
    BEEF:
      amount: 1-3
      chance: 100.0

Mob with Vanilla Head

# Reference: https://minecraft.wiki/w/Skeleton#Drops
SKELETON:
  experience: 5
  head_texture:
    material: "SKELETON_SKULL"
    custom_texture: null  # Use vanilla skull
  loot:
    BONE:
      amount: 0-2
      chance: 66.67
    ARROW:
      amount: 0-2
      chance: 66.67
    BOW:
      amount: 1-1
      chance: 8.5
      durability: 1-384

Mob with Weapons

# Reference: https://minecraft.wiki/w/Wither_Skeleton#Drops
WITHER_SKELETON:
  experience: 5
  head_texture:
    material: "WITHER_SKELETON_SKULL"
    custom_texture: null
  loot:
    COAL:
      amount: 0-1
      chance: 33.33
    BONE:
      amount: 0-2
      chance: 66.67
    WITHER_SKELETON_SKULL:
      amount: 0-1
      chance: 2.5
    STONE_SWORD:
      amount: 1-1
      chance: 8.5
      durability: 1-131

Mob with Tipped Arrows

# Reference: https://minecraft.wiki/w/Bogged#Drops
BOGGED:
  experience: 5
  head_texture:
    material: "PLAYER_HEAD"
    custom_texture: "a3b9003ba2d05562c75119b8a62185c67130e9282f7acbac4bc2824c21eb95d9"
  loot:
    BONE:
      amount: 0-2
      chance: 66.67
    ARROW:
      amount: 0-2
      chance: 66.67
    BOW:
      amount: 1-1
      chance: 8.5
      durability: 1-384
    TIPPED_ARROW:
      amount: 0-2
      chance: 50.0
      potion_type: POISON

Mob with no Drops

# Reference: https://minecraft.wiki/w/Bat#Drops
BAT:
  experience: 0
  head_texture:
    material: "PLAYER_HEAD"
    custom_texture: "81c5cc1f40005a33124c60384a0f17a36a7b19ae90f1c32dcda17b5b56280a43"
  # No loot section = no drops

Default Configuration

SmartSpawner includes comprehensive defaults based on Minecraft Wiki data, including custom head textures for all mobs.

View Online: GitHub Repository
Auto-Regenerate: Delete spawners_settings.yml and restart server

Head Texture Notes

Obtaining Custom Textures

Custom player head textures can be obtained from:

Minecraft-Heads.com
MCHeads.net
MCHeads.ru
Extract from existing player heads using /give commands

Vanilla Head Materials

Some mobs use vanilla Minecraft head materials:

SKELETON_SKULL - Regular skeleton
WITHER_SKELETON_SKULL - Wither skeleton
ZOMBIE_HEAD - Zombie Last update: November 8, 2025
PIGLIN_HEAD - Piglin/Piglin Brute
DRAGON_HEAD - Ender dragon

When using vanilla heads, set custom_texture: null.

Command Usage

To give smart spawners to players, use:

/ss give spawner <player> <item_type> [amount]

Example:

/ss give spawner @p skeleton 1
/ss give spawner Player123 wither_skeleton 3

See the Commands page for more details.

Last update: November 8, 2025 23:29:25