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):** ```yaml break-blocks: false ``` **2. Self-healing craters — let creepers blow holes, then repair them:** ```yaml 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:** ```yaml 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:** ```yaml 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:** ```yaml 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.*