CreeperConduct

🧨 CreeperConduct

> Creeper-specific explosion control for Paper, Spigot & Folia. > A precise, configurable alternative to the all-or-nothing mobGriefing gamerule — > rein in creepers without touching TNT, withers, ghasts, or end crystals.

---

✨ Overview

By default, creepers still hurt mobs and players but break _zero_ blocks. Everything beyond that is opt-in through a single, heavily-commented config.yml, reloadable live with /creeperconduct reload.

> 🟢 Only creepers — normal and charged — are affected. > 🔴 TNT, ghasts, withers, and end crystals behave exactly like vanilla.

---

🧩 Features

| Feature | What it does | | --- | --- | | 🚫 Block protection | Master toggle — creepers deal damage but leave terrain intact (default). | | 💥 Entity damage | Separate player and mob multipliers. 0 = immune (also shields dropped items). | | 📏 Blast radius | Scale explosion size, with per-type caps and an always-on 4× hard ceiling. | | 🛡️ Protected blocks | Whitelist materials that never break (chests, barrels, shulkers, spawners, beacons…). | | 📐 Y-gating | Only allow block damage within a min-y … max-y band (protect builds, free caves). | | 🩹 Crater healing | Auto-restore destroyed blocks after a delay — bottom-up, physics-safe, never overwrites player rebuilds. | | 🌍 Per-world | Global default plus per-world overrides; disabled worlds get vanilla creepers. |

---

🩹 Folia-ready

Crater healing runs on a region-aware scheduler, so CreeperConduct works correctly on Folia's threaded regions and behaves identically on Paper and Spigot — one jar, all three platforms. Declares folia-supported, so Folia loads it natively. Validated on real Paper, Spigot, and Folia 26.1.2 servers (load + block-break + crater-heal all pass).

> On Hangar, Folia ships under the Paper platform, so this download serves Paper and Folia users.

---

⚙️ Config examples

Drop any of these into plugins/CreeperConduct/config.yml, then run /creeperconduct reload. Every key is optional — anything you omit falls back to its default.

1. Default — creepers hurt, but never grief (out of the box):

break-blocks: false

2. Self-healing craters — let creepers blow holes, then repair them:

break-blocks: true
heal:
  enabled: true
  delay-seconds: 30      # wait before rebuilding
  restore-batch-size: 16 # blocks per restore tick

3. Softer creepers — smaller blasts, half damage:

break-blocks: true
entity-damage:
  enabled: true
  mob-multiplier: 0.5
  player-multiplier: 0.5
radius:
  enabled: true
  multiplier: 0.5        # half-size explosions
  max-charged: 8         # hard cap for charged creepers

4. Protect the surface, leave caves alone — only break below sea level:

break-blocks: true
y-gating:
  enabled: true
  min-y: -64
  max-y: 62
protected-blocks:
  enabled: true
  materials: [CHEST, BARREL, SHULKER_BOX, SPAWNER, BEACON, ENDER_CHEST]

5. Per-world — vanilla creepers everywhere except your survival world:

worlds:
  default: true          # CreeperConduct rules apply by default
  world_pvp: false       # this world gets vanilla creepers

---

🎮 Commands & permissions

| Command | Description | | --- | --- | | /creeperconduct status | Show the current settings summary. | | /creeperconduct reload | Reload config.yml live. |

Aliases: /ccon, /conduct

| Permission | Default | Grants | | --- | --- | --- | | creeperconduct.use | everyone | Use /creeperconduct. | | creeperconduct.reload | op | Reload the config. |

---

📥 Installation

1. Download the latest CreeperConduct-x.y.z.jar from the Versions tab.
2. Drop it into your server's plugins/ folder.
3. Start the server (Paper, Spigot, or Folia 26.1.2).
4. Tweak plugins/CreeperConduct/config.yml, then /creeperconduct reload.

---

Made with 💚 for server admins who want creepers on a leash, not a gamerule.