SpawnerChance

A plugin for managing spawners with three main features:

1. Chance of a spawner dropping when broken (via permissions)
2. Granting a temporary drop chance to a player (via command)
3. Restricting which mobs can be placed in spawners (via config)

🧩 Version Compatibility

Optional Dependencies:

• LuckPerms - for granting temporary permissions
• PlaceholderAPI - for placeholders

Features

🎯 Spawner Drop Chance

• Configurable chance for a spawner to drop when broken
• Preserves mob type and all spawner settings
• Permissions system for different drop chances: spawner.dropchance.
• Informative messages for players

🎯 Temporary Spawner Drop Chance

• Requires LuckPerms for this feature
• Command /spawnerchance tempchance <player> <chance> grants a player a temporary drop chance when breaking a spawner
• Duration (in minutes) for the temporary drop chance is set in temp-chance-duration in the config
• Cleanup interval (in seconds) for expired temporary permissions is set in cleanup-interval

🚫 Mob Restrictions for Spawners (via spawn eggs)

• Whitelist of allowed mobs is set in the config: allowed-spawner-mobs: []
• Prevents placing forbidden mobs in spawners
• Admins can bypass restrictions
• Mob names in messages can be localized

Configuration

# format: language_COUNTRY
# changing this will load default material names for the server
language: en_US

# Duration (in minutes) for temporary drop chance
temp-chance-duration: 15
# Interval (in seconds) to clean up expired temporary permissions
cleanup-interval: 10

# Main plugin messages
messages:
  # Spawner drop messages
  empty-spawner-name: "<gray>Empty"
  drop-success: "<green>Luck! {spawner} dropped ({chance}%)"
  drop-failure: "<red>Spawner did not drop ({chance}%)"
...

# List of allowed mobs for spawners (add only mobs that can be placed in spawners)
# Leave empty to allow all mobs
allowed-spawner-mobs: []
#  - BLAZE
#  - PIGLIN
#  - COW

Placeholders

'%spawnerchance_chance%' - shows the current chance of spawner failure.

Permissions

Spawner Drop Chances:

• spawner.dropchance.<number> - drop chance in percent
  • Example: spawner.dropchance.50 - 50% chance
  • The highest available chance for the player is used

Bypass Restrictions:

• spawner.bypass - allows placing any mobs in spawners

Command Access:

• spawner.command.use - allows using plugin commands

Usage Examples

Spawner Drop:

⚔️ Player breaks a Zombie Spawner
🎯 Check drop chance (e.g., 30%)
✅ On success: "Luck! Zombie Spawner dropped (30%)"
❌ On failure: "Spawner did not drop (30%)"

Mob Restrictions:

🔧 Player tries to use a Villager egg on a spawner
🚫 If mob is not whitelisted: "Error: Villager Egg cannot be placed in a spawner!"
✅ If mob is allowed: "You placed a spawner for: Zombie"

Features

• Data Preservation: Dropped spawners retain all original settings
• Localization Friendly: All messages and mob names support any language
• Flexible Configuration: Easily add or remove mobs from the whitelist

Installation

1. Download the latest release
2. Place it in the /plugins folder
3. Restart the server
4. Configure config.yml if needed and run /spawnerchance reload