Creeper Tweaks

A completely customizable server-side Fabric mod for Minecraft 1.21.9 & 1.21.10 that adds various tweaks and custom behaviors to Creepers.

Features

Creeper Shearing

Right-click a Creeper with Shears to defuse it. The creeper will drop gunpowder and become unable to explode, though it may still hiss and swell. Useful for farming gunpowder or keeping creepers as pets or edging them.

Confetti Creepers

Creepers have a configurable chance to explode into confetti instead of destroying blocks. When this happens, the creeper spawns colorful firework particles and makes a twinkling sound, but causes no damage or block destruction.

Eco-Friendly Creepers

Creepers can be configured to drop 100% of the blocks they destroy, making it easier to clean up explosion craters. This is configurable per-creeper type with a chance value.

Custom Creeper Types

The mod supports multiple creeper variants that can spawn naturally (also you can create your own custom creepers in the config file):

• Regular Creepers: Standard vanilla behavior with configurable tweaks
• Baby Creepers: Smaller size (0.5 scale), faster movement, smaller explosion radius
• Charged Creepers: Naturally spawning charged creepers with larger explosions
• Baby Charged Creepers: Combination of baby and charged properties
• Titan Creepers: Large size (1.5 scale), slow movement, high health, massive explosion radius
• Silent Creepers: Make no sound before exploding, making them harder to detect
• Plague Creepers: Explode into lingering poison clouds instead of destroying blocks

Each creeper type can be customized with:

• Spawn chance (weight-based probability)
• Scale (size multiplier)
• Health
• Movement speed
• Explosion radius
• Charged state
• Shearable status
• Confetti chance
• Eco-friendly drop chance
• Silent status
• Head drop chance
• Custom name tag with color codes
• Lingering explosion effects
• Block regeneration settings

Creeper Head Drops

Creepers have a configurable chance to drop their head when killed by a player. This chance can be set per-creeper type.

Lingering Explosions

Creepers can leave behind area effect clouds when they explode. You can configure the effect type (poison, instant_damage, nausea, etc.), duration, and radius. This is useful for creating special creeper variants like the Plague Creeper.

Custom Name Tags

Each creeper type can have a custom name tag displayed above it. Supports Minecraft color codes using the & symbol (e.g., &4 for dark red, &6 for gold, &l for bold).

Block Regeneration

Blocks destroyed by creepers can be configured to regenerate over time. You can set:

• Whether regeneration is enabled for each creeper type

• Delay before regeneration starts (in ticks)

• Speed of regeneration (blocks per tick)

• Particle type to show during regeneration

  

The regeneration happens in a staggered manner, with blocks restoring from bottom to top for a natural rebuilding effect.

Commands

• /creepertweaks reload - Reloads the configuration file without restarting the server
• /creepertweaks spawn <type> - Spawns a specific creeper type at your location
• /creepertweaks debug <target> - Shows detailed information about a creeper entity

All commands require operator level 2.

Configuration

The mod is configured via config/creepertweaks.toml. The configuration file is automatically created on first run.

Global Settings

[global]
enableCreeperShearing = true              # Master switch for shearing
enableConfettiCreepers = true             # Master switch for confetti explosions
enableEcoFriendlyCreepers = true          # Master switch for eco-friendly drops
enableHeadDrops = true                    # Master switch for head drops
enableNameTags = true                     # Master switch for custom name tags
enableBlockRegeneration = true             # Master switch for block regeneration
enableRegenerationParticles = true         # Enable particles during regeneration
regenerationParticleType = "block"        # Particle type: "block", "smoke", "cloud", "enchant", etc.
debug = false                             # Enable debug logging

Creeper Type Configuration

Each creeper type is defined in a [[creepers]] section:

[[creepers]]
name = "regular-creeper"                  # Unique identifier
nameTag = ""                              # Custom name (use & for color codes)
spawn-chance = 0.63                       # Spawn weight (relative to total)
scale = 1.0                               # Size multiplier
health = 20.0                             # Maximum health
speed = 0.25                              # Movement speed
explosionRadius = 3                       # Explosion radius in blocks
charged = false                           # Spawn as charged creeper
shearable = true                          # Can be defused with shears
confettiChance = 0.05                     # Chance to explode into confetti (0.0-1.0)
ecoFriendlyDropChance = 1.0               # Chance to drop 100% blocks (0.0-1.0)
silent = false                            # Make no sound before exploding
headDropChance = 0.25                     # Chance to drop head when killed (0.0-1.0)
lingering = false                         # Leave area effect cloud on explosion
lingeringType = "poison"                  # Effect type (poison, instant_damage, etc.)
lingeringDuration = 600                   # Effect duration in ticks (20 ticks = 1 second)
lingeringRadius = 3.0                     # Cloud radius
blockRegeneration = true                  # Blocks regenerate after explosion
regenerationDelay = 200                   # Delay before regeneration starts (ticks)
regenerationSpeed = 0.5                   # Blocks regenerated per tick

Full Config

creepertweaks.toml

[global]
# Creeper Tweaks Configuration

[global]
# Master switch for shearing mechanics.
# If false, no creeper can be sheared regardless of their individual settings.
enableCreeperShearing = true

# Master switch for confetti creepers.
# If false, confetti chance is ignored.
enableConfettiCreepers = true

# Master switch for Eco-Friendly Creepers (100% block drops).
# If false, ecoFriendlyDropChance is ignored and creepers behave like vanilla (drop 1/radius).
enableEcoFriendlyCreepers = true

# Master switch for Creeper Head Drops.
# If false, headDropChance is ignored.
enableHeadDrops = true

# Master switch for Custom Name Tags.
# If false, custom nametags are ignored and creepers will display their default names (or no name).
enableNameTags = true

# Master switch for Block Regeneration.
# If false, blocks destroyed by creepers with 'blockRegeneration' enabled will NOT regenerate.
enableBlockRegeneration = true

# Master switch for Regeneration Particles.
# If false, particles will not be spawned when blocks regenerate.
enableRegenerationParticles = true

# Particle type to use when blocks regenerate.
# Options: "block" (shows block texture - default), "explosion", "smoke", "cloud", "enchant", "flame", "portal", "poof", "totem_of_undying", "end_rod", "heart", "happy_villager", "angry_villager", "note", "dust", "falling_dust", etc.
# Note: Only "block" and "falling_dust" will show the actual block texture. Other particles will use their default appearance.
regenerationParticleType = "cloud"

# Enable debug logging for mob spawning.
# If true, logs will be printed to the console when a custom creeper is spawned.
debug = false

#
# Define your custom creepers here.
#

# The 'spawn-chance' is a weight (as a double). It determines likelihood relative to total weight.
# Example: If Total Weight = 1.0, then 0.1 = 10% chance.
# Logic: (spawn-chance / total_spawn_chance_of_all_types).
# For chance values like confettiChance and ecoFriendlyDropChance, use 0.0 to 1.0 (0.0 = 0% aka disabled, 1.0 = 100%).

# Lingering Effect Options:
# lingering = true/false (enables area effect cloud on explosion)
# lingeringType = "poison", "instant_damage", "nausea", "slowness", "weakness", etc. (Status Effect ID)
# Possible options for lingeringType:
# - poison, instant_damage, instant_health, regeneration, speed, slowness
# - strength, weakness, haste, mining_fatigue, jump_boost, nausea
# - resistance, fire_resistance, water_breathing, invisibility, blindness
# - night_vision, hunger, wither, health_boost, absorption, saturation
# - glowing, levitation, luck, unluck, slow_falling, conduit_power, dolphins_grace
# - bad_omen, hero_of_the_village, darkness, trial_omen, raid_omen, wind_charged, weaving, oozing, infested
# lingeringDuration = duration in ticks (20 ticks = 1 second)
# lingeringRadius = radius of the cloud (default 3.0)
#
# Block Regeneration Options:
# blockRegeneration = true/false (if true, blocks destroyed by this creeper will regenerate)
# regenerationDelay = delay in ticks before regeneration starts (default 200 = 10 seconds)
# regenerationSpeed = number of blocks to regenerate per tick (default 0.5 = 1 block per 2 ticks, 20 ticks = 1 second). Lower values = slower and smoother restoration.

# Name Tag Options:
# nameTag = "Custom Name" (supports color codes like &4 for Dark Red, &6 for Gold, etc.)
# Leave empty ("") to not display a name tag.

[[creepers]]
name = "regular-creeper"
nameTag = ""
spawn-chance = 0.63
scale = 1.0
health = 20.0
speed = 0.25
explosionRadius = 3
charged = false
shearable = true
confettiChance = 0.05
ecoFriendlyDropChance = 1.0
silent = false
headDropChance = 0.25
lingering = false
lingeringType = "poison"
lingeringDuration = 600
lingeringRadius = 3.0
blockRegeneration = true
regenerationDelay = 200
regenerationSpeed = 0.5

[[creepers]]
name = "baby-creeper"
nameTag = "&aBaby Creeper"
spawn-chance = 0.20
scale = 0.5
health = 10.0
speed = 0.3
explosionRadius = 2
charged = false
shearable = true
confettiChance = 0.05
ecoFriendlyDropChance = 1.0
silent = false
headDropChance = 0.25
lingering = false
blockRegeneration = true
regenerationDelay = 200
regenerationSpeed = 0.5

[[creepers]]
name = "baby-charged-creeper"
nameTag = "&bCharged Baby Creeper"
spawn-chance = 0.05
scale = 0.5
health = 10.0
speed = 0.35
explosionRadius = 4
charged = true
shearable = true
confettiChance = 0.05
ecoFriendlyDropChance = 1.0
silent = false
headDropChance = 0.25
lingering = false
blockRegeneration = true
regenerationDelay = 200
regenerationSpeed = 0.5

[[creepers]]
name = "charged-creeper"
nameTag = "&bCharged Creeper"
spawn-chance = 0.05
scale = 1.0
health = 20.0
speed = 0.25
explosionRadius = 6
charged = true
shearable = true
confettiChance = 0.05
ecoFriendlyDropChance = 1.0
silent = false
headDropChance = 0.25
lingering = false
blockRegeneration = true
regenerationDelay = 200
regenerationSpeed = 0.5

[[creepers]]
name = "titan-creeper"
nameTag = "&4&lTITAN CREEPER"
spawn-chance = 0.02
scale = 1.5
health = 50.0
speed = 0.15
explosionRadius = 8
charged = false
shearable = true
confettiChance = 0.05
ecoFriendlyDropChance = 1.0
silent = false
headDropChance = 0.25
lingering = false
blockRegeneration = true
regenerationDelay = 200
regenerationSpeed = 0.2

[[creepers]]
name = "silent-creeper"
nameTag = "&7Silent Creeper"
spawn-chance = 0.01
scale = 1.0
health = 15.0
speed = 0.3
explosionRadius = 3
charged = false
shearable = true
confettiChance = 0.05
ecoFriendlyDropChance = 1.0
silent = true
headDropChance = 0.25
lingering = false
blockRegeneration = true
regenerationDelay = 200
regenerationSpeed = 0.5

[[creepers]]
name = "plague-creeper"
nameTag = "&2Plague Creeper"
spawn-chance = 0.04
scale = 1.0
health = 20.0
speed = 0.25
explosionRadius = 0
charged = false
shearable = true
confettiChance = 0.05
ecoFriendlyDropChance = 1.0
silent = false
headDropChance = 0.25
lingering = true
lingeringType = "poison"
lingeringDuration = 300
lingeringRadius = 4.0
blockRegeneration = false