SpawnerChance

# 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 | **Plugin version** | **Supported Paper** | **Java** | |--------------------|-----------------------|----------| | `1.6.0+` | `1.20` – `26.2` | 25 | | `1.5.0` | `1.20` – `1.21.11` | 21 | ## Optional Dependencies: - (https://modrinth.com/plugin/luckperms) - for granting temporary permissions - (https://modrinth.com/plugin/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 ```yaml # 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: ```text ⚔️ 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: ```text 🔧 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`